diff --git a/articles/hubs/auth0-integration.md b/articles/hubs/auth0-integration.md new file mode 100644 index 0000000..2b7e961 --- /dev/null +++ b/articles/hubs/auth0-integration.md @@ -0,0 +1,48 @@ +# Auth0 Integration + +## What +Auth0 allows you to add a login form with user access management to your documentation. + +## How +1. Create an account or login to [Auth0](https://auth0.com/) +2. Select **Applications** in the Auth0 menu + +![Auth0 Dashboard](https://github.com/stoplightio/docs/blob/develop/assets/images/auth0-dashboard.png?raw=true) + +3. Click **+ Create Application** + +![Create Application](https://github.com/stoplightio/docs/blob/develop/assets/images/create-application.png?raw=true) + +4. Input a **Name** for your application + +![Create Application Details](https://github.com/stoplightio/docs/blob/develop/assets/images/application-create.png?raw=true) + +5. Select **Regular Web Applications** +6. Click **Create** +7. Select **Application Settings** + +![Auth0 Settings](https://github.com/stoplightio/docs/blob/develop/assets/images/auth0-new-settings.png?raw=true) + +8. Copy the **Domain** and paste it in **Hosted Login Page** +9. Input a **?client=** at the end of the pasted **Domain** from above +10. Copy the **Client ID** and paste it after the **?client=** in **Hosted Login Page** from above + +> Example Hosted Login Page: robertwallach.auth0.com?client=XwYWVMLp7rJOkJ6iU51MwJHm2w2AAfGl + +11. Copy the **Client Secret** and paste it in **Client Secrets** in Hubs + +![Hubs Authorizations](https://github.com/stoplightio/docs/blob/develop/assets/images/hubs-authorization.png?raw=true) + +12. Copy the **Callback URL** generated by Hubs in **Authorizations** and paste it in **Allowed Callback URLs** in Auth0 + +> Make sure the callbacks start with https instead of http and that they match + +![Allowed Callback URL](https://github.com/stoplightio/docs/blob/develop/assets/images/callback-urls.png?raw=true) + +13. Select **Hosted Pages** in the Auth0 menu + +> Make sure **Customize Login Page** is turned on + +14. Click on **Build** to start the Publishing process + +> To login to your Hub with Auth0, make sure you add users in the Auth0 Dashboard