screenshots for oauth client creation for both github and google (#404)
@ -1,4 +1,4 @@
|
||||
# OAuth Configuration
|
||||
# OAuth Public Frontend Configuration
|
||||
|
||||
As of `v0.4.7`, `zrok` includes OAuth integration for both Google and GitHub for `zrok access public` public frontends.
|
||||
|
||||
@ -18,32 +18,56 @@ After this frontend is configured, we'll use the OAuth frontend address when cre
|
||||
|
||||
`APIs & Services > Credentials > OAuth content screen`
|
||||
|
||||
Configure the application in the OAuth Content Screen.
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/google_oauth_content_screen_2.png)
|
||||
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/google_oauth_content_screen_3.png)
|
||||
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/google_oauth_content_screen_4.png)
|
||||
|
||||
Add a non-sensitive scope for `../auth/userinfo.email`.
|
||||
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/google_oauth_content_screen_5.png)
|
||||
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/google_oauth_content_screen_6.png)
|
||||
|
||||
### Create the OAuth 2.0 Client ID
|
||||
|
||||
`APIs & Services > Credentials > + Create Credentials`
|
||||
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/google_create_credentials_1.png)
|
||||
|
||||
Select `OAuth client ID`
|
||||
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/google_create_credentials_2.png)
|
||||
|
||||
Application type is `Web Application`
|
||||
|
||||
Name it whatever you'd like
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/google_create_credentials_3.png)
|
||||
|
||||
Authorized redirect URIs:
|
||||
|
||||
Use the address of the OAuth frontend you configured above, but you're going to add `/google/oauth` to the end of the URL.
|
||||
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/google_create_credentials_4.png)
|
||||
|
||||
Save the client ID and the client secret. You'll configure these into your `frontend.yml`.
|
||||
|
||||
## Configuring a GitHub Client ID
|
||||
|
||||
`Settings > Developer Settings > OAuth Apps > Register a new application`
|
||||
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/github_create_oauth_application_1.png)
|
||||
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/github_create_oauth_application_2.png)
|
||||
|
||||
Authorization Callback URL: Use the address of the OAuth frontend you configured above, but add `/github/oauth` to the end of the URL.
|
||||
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/github_create_oauth_application_3.png)
|
||||
|
||||
![](/home/michael/Repos/nf/zrok/docs/guides/self-hosting/oauth/images/github_create_oauth_application_4.png)
|
||||
|
||||
Save the client ID and the client secret. You'll configure these into your `frontend.yml`.
|
||||
|
||||
## Enabling Oauth on Access Point
|
||||
|
||||
There is a new stanza in the access point configuration.
|
||||
|
BIN
docs/guides/self-hosting/oauth/images/github_create_oauth_application_1.png
Executable file
After Width: | Height: | Size: 42 KiB |
BIN
docs/guides/self-hosting/oauth/images/github_create_oauth_application_2.png
Executable file
After Width: | Height: | Size: 61 KiB |
BIN
docs/guides/self-hosting/oauth/images/github_create_oauth_application_3.png
Executable file
After Width: | Height: | Size: 70 KiB |
BIN
docs/guides/self-hosting/oauth/images/github_create_oauth_application_4.png
Executable file
After Width: | Height: | Size: 90 KiB |
BIN
docs/guides/self-hosting/oauth/images/github_create_oauth_application_5.png
Executable file
After Width: | Height: | Size: 78 KiB |
BIN
docs/guides/self-hosting/oauth/images/google_create_credentials_1.png
Executable file
After Width: | Height: | Size: 82 KiB |
BIN
docs/guides/self-hosting/oauth/images/google_create_credentials_2.png
Executable file
After Width: | Height: | Size: 66 KiB |
BIN
docs/guides/self-hosting/oauth/images/google_create_credentials_3.png
Executable file
After Width: | Height: | Size: 109 KiB |
BIN
docs/guides/self-hosting/oauth/images/google_create_credentials_4.png
Executable file
After Width: | Height: | Size: 136 KiB |
BIN
docs/guides/self-hosting/oauth/images/google_oauth_content_screen_1.png
Executable file
After Width: | Height: | Size: 90 KiB |
BIN
docs/guides/self-hosting/oauth/images/google_oauth_content_screen_2.png
Executable file
After Width: | Height: | Size: 212 KiB |
BIN
docs/guides/self-hosting/oauth/images/google_oauth_content_screen_3.png
Executable file
After Width: | Height: | Size: 206 KiB |
BIN
docs/guides/self-hosting/oauth/images/google_oauth_content_screen_4.png
Executable file
After Width: | Height: | Size: 110 KiB |
BIN
docs/guides/self-hosting/oauth/images/google_oauth_content_screen_5.png
Executable file
After Width: | Height: | Size: 93 KiB |
BIN
docs/guides/self-hosting/oauth/images/google_oauth_content_screen_6.png
Executable file
After Width: | Height: | Size: 95 KiB |