Skip to content

Commit 339837a

Browse files
[CF1] GitHub IdP guide revision (#23216)
* [CF1] GitHub IdP guide revision * edits
1 parent 68bd79e commit 339837a

File tree

3 files changed

+16
-18
lines changed

3 files changed

+16
-18
lines changed
-20.6 KB
Binary file not shown.
-175 KB
Binary file not shown.

src/content/docs/cloudflare-one/identity/idp-integration/github.mdx

Lines changed: 16 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -3,51 +3,49 @@ pcx_content_type: how-to
33
title: GitHub
44
---
55

6-
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.
6+
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.
77

88
## Set up GitHub Access
99

1010
To configure GitHub access in both GitHub and Cloudflare Zero Trust:
1111

12-
1. Log in to GitHub.
12+
1. Log in to [GitHub](https://github.com/).
1313

14-
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.
14+
2. Go to your account **Settings** > **Developer Settings**.
1515

16-
![GitHub Register a new OAuth application window without any form fields completed](~/assets/images/cloudflare-one/identity/github/github2.png)
16+
3. In **Developer Settings**, select **OAuth Apps** and select **New OAuth app**.
1717

18-
3. Enter an **Application name**. Your users will see this name on the login page.
18+
4. On the **Register a new OAuth application** page, enter an **Application name**. Your users will see this application name on the login page.
1919

20-
4. In the **Homepage URL** field, enter your team domain:
20+
5. In the **Homepage URL** field, enter your team domain:
2121

2222
```txt
2323
https://<your-team-name>.cloudflareaccess.com
2424
```
2525

26-
You can find your team name in Zero Trust under **Settings** > **Custom Pages**.
26+
You can find your team name in [Zero Trust](https://one.dash.cloudflare.com) by going to **Settings** > **Custom Pages**.
2727

28-
5. In the GitHub **Authorization callback URL** field, enter the following URL:
28+
6. In the GitHub **Authorization callback URL** field, enter the following URL:
2929

3030
```txt
3131
https://<your-team-name>.cloudflareaccess.com/cdn-cgi/access/callback
3232
```
3333

34-
6. Select **Register application**.
34+
7. Select **Register application**.
3535

36-
7. Copy the **Client ID** and **Client Secret**.
36+
8. Find the **Client ID** and **Client Secret**.
3737

38-
![GitHub Cloudflare Access App showing Client ID and Client secret](~/assets/images/cloudflare-one/identity/github/github4.png)
38+
9. In [Zero Trust](https://one.dash.cloudflare.com), go to **Settings** > **Authentication**.
3939

40-
8. In Zero Trust, go to **Settings** > **Authentication**.
40+
10. Under **Login methods**, select **Add new**.
4141

42-
9. Under **Login methods**, select **Add new**.
42+
11. Choose **GitHub** on the next page.
4343

44-
10. Choose **GitHub** on the next page.
44+
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.
4545

46-
11. Paste in the **Client ID** and **Client secret**.
46+
13. Select **Save**.
4747

48-
12. Select **Save**.
49-
50-
To test that your connection is working, go to **Authentication** > **Login methods** and select **Test** next to GitHub.
48+
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.
5149
If you have GitHub two-factor authentication enabled, you will need to first login to GitHub directly and return to Access.
5250

5351
## Example API Configuration

0 commit comments

Comments
 (0)