|
| 1 | +--- |
| 2 | +theme: |
| 3 | + toc: false |
| 4 | +--- |
| 5 | + |
| 6 | +import { Steps, Tabs } from 'nextra/components' |
| 7 | + |
1 | 8 | # Hellō Lifecycle Support |
2 | 9 |
|
3 | | -## Removing an Organization from Hellō |
| 10 | +- [I want to remove my organization from Hellō Lifecycle](#i-want-to-remove-my-organization-from-hellō-lifecycle) |
| 11 | +- [I want to remove my connected GitHub orgs from Hellō Lifecycle](#i-want-to-remove-my-connected-github-orgs-from-hellō-lifecycle) |
| 12 | +- [My GitHub org is not showing up during setup](#my-github-org-is-not-showing-up-during-setup) |
| 13 | + |
| 14 | +--- |
4 | 15 |
|
5 | | -To remove an organization from Hellō Lifecycle, complete both steps below. |
| 16 | +## I want to remove my organization from Hellō Lifecycle |
6 | 17 |
|
7 | | -### Step 1: Delete the Organization from the Hellō Dashboard |
| 18 | +<Steps> |
| 19 | + |
| 20 | +### Delete your organization from the Hellō Dashboard |
8 | 21 |
|
9 | 22 | 1. Go to your [Hellō Lifecycle dashboard](https://lifecycle.hello.coop). |
10 | 23 | 2. Click **Delete** next to the organization you want to remove. |
11 | 24 | 3. Type `DELETE` to confirm. |
12 | 25 |
|
13 | 26 | This removes the connection configuration, synced user data, and all connected app settings. Automated offboarding will stop working for this organization. |
14 | 27 |
|
15 | | -> If you have GitHub Offboarding connected, you will also need to [uninstall the Hellō GitHub App](/support/go#step-2-uninstall-the-hellō-github-app) from your GitHub org. |
16 | | -
|
17 | | -### Step 2: Revoke Hellō Lifecycle's Access to Your Directory |
| 28 | +### Revoke Hellō Lifecycle's access to your directory |
18 | 29 |
|
19 | 30 | After deleting from Hellō Lifecycle, the directory access grant remains until you manually revoke it. |
20 | 31 |
|
21 | | -> **Note:** You will need admin privileges in your directory to revoke access. |
22 | | -
|
23 | | -#### Microsoft Entra ID |
24 | | - |
| 32 | +<Tabs items={['Microsoft Entra ID', 'Google Workspace']}> |
| 33 | +<Tabs.Tab> |
25 | 34 | 1. Go to [Enterprise Applications](https://entra.microsoft.com/#view/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/~/AppAppsPreview) in the Entra ID admin center. |
26 | 35 | 2. Find **Hellō Lifecycle** and click on it. |
27 | 36 | 3. Click **Delete** to remove the service principal and revoke all access. |
28 | | - |
29 | | -#### Google Workspace |
30 | | - |
| 37 | +</Tabs.Tab> |
| 38 | +<Tabs.Tab> |
31 | 39 | 1. Go to [Third-party app access](https://admin.google.com/ac/owl) in the Google Admin Console. |
32 | 40 | 2. Find **Hellō Lifecycle** and click on it. |
33 | 41 | 3. Click **Remove access** to revoke access for your entire domain. |
| 42 | +</Tabs.Tab> |
| 43 | +</Tabs> |
| 44 | + |
| 45 | +</Steps> |
| 46 | + |
| 47 | +## I want to remove my connected GitHub orgs from Hellō Lifecycle |
| 48 | + |
| 49 | +If you have GitHub Offboarding connected, complete the following for each GitHub org. |
| 50 | + |
| 51 | +<Steps> |
| 52 | + |
| 53 | +### Delete the Hello-Lifecycle repository |
| 54 | + |
| 55 | +During setup, Hellō created a repository named `Hello-Lifecycle` in your GitHub org. You can delete it if you no longer need the account linking history. |
| 56 | + |
| 57 | +1. Go to `https://github.com/<YOUR_ORG_NAME>/Hello-Lifecycle/settings`. |
| 58 | +2. Scroll to the bottom and click **Delete this repository**. |
| 59 | + |
| 60 | +### Uninstall the Hellō GitHub App |
| 61 | + |
| 62 | +The Hellō Lifecycle GitHub App remains installed on your org until you manually remove it. |
| 63 | + |
| 64 | +1. Go to your org's GitHub App settings: |
| 65 | + ``` |
| 66 | + https://github.com/organizations/<YOUR_ORG_NAME>/settings/installations |
| 67 | + ``` |
| 68 | +2. Find **Hellō Lifecycle** and click **Configure**. |
| 69 | +3. Scroll to the bottom and click **Uninstall**. |
| 70 | + |
| 71 | +</Steps> |
| 72 | + |
| 73 | +## My GitHub org is not showing up during setup |
| 74 | + |
| 75 | +When setting up Hellō Lifecycle at [lifecycle.hello.coop/github](https://lifecycle.hello.coop/github), your org may not appear in the "Select Your Organization" step. This can happen for two reasons: |
| 76 | + |
| 77 | +**I skipped granting access during installation** |
| 78 | + |
| 79 | +During the GitHub OAuth app authorization flow, you may have skipped granting access to your org. |
| 80 | + |
| 81 | +1. Go to the [Hellō Lifecycle OAuth app settings page](https://github.com/settings/connections/applications/lv23li3rZkORXbEiBVu9). |
| 82 | + |
| 83 | +2. You'll see all the orgs you belong to. |
| 84 | + |
| 85 | +3. Click **Grant** next to the org you want to use with Hellō Lifecycle. |
| 86 | + |
| 87 | +4. Return to [lifecycle.hello.coop/github](https://lifecycle.hello.coop/github), log out, and go through the GitHub authorization flow again. |
| 88 | + |
| 89 | +**My org has disabled third-party access** |
| 90 | + |
| 91 | +If you see a red cross beside your org and the **Grant** button is not visible (either during installation or when visiting the OAuth app settings page above), someone in your org has disabled third-party OAuth app access for Hellō Lifecycle. |
| 92 | + |
| 93 | +1. Go to your org's OAuth application policy settings: |
| 94 | + ``` |
| 95 | + https://github.com/organizations/<YOUR_ORG_NAME>/settings/oauth_application_policy |
| 96 | + ``` |
| 97 | + Replace `<YOUR_ORG_NAME>` with your org's name (e.g., `https://github.com/organizations/Bubbler/settings/oauth_application_policy`). |
| 98 | + |
| 99 | +2. Find **Hellō Lifecycle** in the list of apps. It will have a **Denied** label beside it. |
| 100 | + |
| 101 | +3. Click the **Edit** button next to Hellō Lifecycle. |
| 102 | + |
| 103 | +4. Click **Grant access**. |
| 104 | + |
| 105 | +5. Return to [lifecycle.hello.coop/github](https://lifecycle.hello.coop/github), log out, and go through the GitHub authorization flow again. |
0 commit comments