diff --git a/src/assets/images/cloudflare-one/identity/github/github2.png b/src/assets/images/cloudflare-one/identity/github/github2.png deleted file mode 100644 index d4910d5274d06ea..000000000000000 Binary files a/src/assets/images/cloudflare-one/identity/github/github2.png and /dev/null differ diff --git a/src/assets/images/cloudflare-one/identity/github/github4.png b/src/assets/images/cloudflare-one/identity/github/github4.png deleted file mode 100644 index c4d55cc3de76bef..000000000000000 Binary files a/src/assets/images/cloudflare-one/identity/github/github4.png and /dev/null differ diff --git a/src/content/docs/cloudflare-one/identity/idp-integration/github.mdx b/src/content/docs/cloudflare-one/identity/idp-integration/github.mdx index a6eb40f302d3bb0..7452d1bdcbed85c 100644 --- a/src/content/docs/cloudflare-one/identity/idp-integration/github.mdx +++ b/src/content/docs/cloudflare-one/identity/idp-integration/github.mdx @@ -3,51 +3,49 @@ pcx_content_type: how-to title: GitHub --- -Cloudflare Zero Trust allows your team to connect to your applications using their GitHub login. Administrators can build rules for specific individuals or using GitHub organizations. You do not need to have a GitHub organization to use the integration. +Cloudflare Zero Trust allows your team to connect to your applications using their GitHub login. You do not need to have a GitHub organization to use the integration. ## Set up GitHub Access To configure GitHub access in both GitHub and Cloudflare Zero Trust: -1. Log in to GitHub. +1. Log in to [GitHub](https://github.com/). -2. Go to your account **Settings** > **Developer Settings**, select **OAuth Apps** and select **Register a new application**. The **Register a new OAuth application** window displays. +2. Go to your account **Settings** > **Developer Settings**. - ![GitHub Register a new OAuth application window without any form fields completed](~/assets/images/cloudflare-one/identity/github/github2.png) +3. In **Developer Settings**, select **OAuth Apps** and select **New OAuth app**. -3. Enter an **Application name**. Your users will see this name on the login page. +4. On the **Register a new OAuth application** page, enter an **Application name**. Your users will see this application name on the login page. -4. In the **Homepage URL** field, enter your team domain: +5. In the **Homepage URL** field, enter your team domain: ```txt https://.cloudflareaccess.com ``` - You can find your team name in Zero Trust under **Settings** > **Custom Pages**. + You can find your team name in [Zero Trust](https://one.dash.cloudflare.com) by going to **Settings** > **Custom Pages**. -5. In the GitHub **Authorization callback URL** field, enter the following URL: +6. In the GitHub **Authorization callback URL** field, enter the following URL: ```txt https://.cloudflareaccess.com/cdn-cgi/access/callback ``` -6. Select **Register application**. +7. Select **Register application**. -7. Copy the **Client ID** and **Client Secret**. +8. Find the **Client ID** and **Client Secret**. - ![GitHub Cloudflare Access App showing Client ID and Client secret](~/assets/images/cloudflare-one/identity/github/github4.png) +9. In [Zero Trust](https://one.dash.cloudflare.com), go to **Settings** > **Authentication**. -8. In Zero Trust, go to **Settings** > **Authentication**. +10. Under **Login methods**, select **Add new**. -9. Under **Login methods**, select **Add new**. +11. Choose **GitHub** on the next page. -10. Choose **GitHub** on the next page. +12. In the **App ID** field, copy and paste the **Client ID** you found in step 8. In the **Client secret** field, copy and paste the **Client secret** you found in step 8. You will need to select **Generate a new client secret** if one is not already displayed. -11. Paste in the **Client ID** and **Client secret**. +13. Select **Save**. -12. Select **Save**. - -To test that your connection is working, go to **Authentication** > **Login methods** and select **Test** next to GitHub. +To test that your connection is working, go to [Zero Trust](https://one.dash.cloudflare.com) > **Authentication** > **Login methods** and select **Test** next to your GitHub login method. If you have GitHub two-factor authentication enabled, you will need to first login to GitHub directly and return to Access. ## Example API Configuration