gravitl/netmaker
1
1
Fork 0
mirror of https://github.com/gravitl/netmaker.git synced 2025-02-25 08:34:47 +08:00
Code Issues Projects Releases Packages Wiki Activity

Update oauth.rst

Browse source 
Minor doc edits to get oauth working, based on Azure AD testing
This commit is contained in:
estebang 2021-11-03 17:30:53 +00:00
parent 34915cb50b
commit e27f9e0086
1 changed files with 13 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
docs/oauth.rst
View file

@ -18,13 +18,13 @@ Configuring your provider
In order to use OAuth, configure your OAuth provider (GitHub, Google, Azure AD).
You must configure your provider to use the Netmaker Dashboard URI dashboard.<netmaker.base.domain> as the origin URL.
You must configure your provider (except for Azure AD) to use the Netmaker Dashboard URI dashboard.<netmaker.base.domain> as the origin URL.
For example: `https://dashboard.netmaker.mydomain.com`
You must configure your provider to use the Netmaker API URI redirect route with the following format: https://api.<netmaker base domain>/api/oauth2/callback.
You must configure your provider to use the Netmaker API URI redirect route with the following format: https://api.<netmaker base domain>/api/oauth/callback.
For example: `https://api.netmaker.mydomain.com/api/oauth2/callback`
For example: `https://api.netmaker.mydomain.com/api/oauth/callback`
General provider instructions can be found with the following links:
@ -41,14 +41,18 @@ Next, Configure Netmaker with the following environment variables. If any are le
.. code-block::
AUTH_PROVIDER="<azure-ad|github|google>"
CLIENT_ID="<client id of your oauth provider>"
CLIENT_SECRET="<client secret of your oauth provider>"
SERVER_HTTP_HOST="https://<your-netmaker-api-domain>"
FRONTEND_URL="https://<your-netmaker-dashboard-domain>"
AUTH_PROVIDER: "<azure-ad|github|google>"
CLIENT_ID: "<client id of your oauth provider>"
CLIENT_SECRET: "<client secret of your oauth provider>"
SERVER_HTTP_HOST: "api.<netmaker base domain>"
FRONTEND_URL: "https://dashboard.<netmaker base domain>"
After restarting your server, the Netmaker logs will indicate if the OAuth provider was successfully initialized.
After restarting your server, the Netmaker logs will indicate if the OAuth provider was successfully initialized:
.. code-block::
sudo docker logs netmaker
Once successful, users can click the key symbol on the login page to sign-in with your configured OAuth provider.