Auth0 is a popular cloud service for managing authentication across your applications.
auth0.com
¶ Setup
¶ A) Create Auth0 Application
- If not already the case, create an account on Auth0
- From the dashboard, click on Applications in the left navigation.
- Click Create Application, enter a name (e.g. Wiki) and select Regular Web Applications as the type.
- Click Create.
- Once the application is created, switch to the Settings tab.
- Copy the Domain, Client ID and Client Secret values. We'll need them later.
¶ B) Enable the Auth0 strategy in Wiki.js
- In the Administration Area of your wiki, click on Authentication in the left navigation.
- Click on Auth0.
- Enter the Domain, Client ID and Client Secret values copied earlier.
- Enable the Self-registration option (unless you plan on authorizing users manually).
- Select the group new users should be assigned to when they login for the first time.
- Make sure the checkbox next to Auth0 in the list of strategies is checked. The text should now say that the strategy is active.
- Click Apply on the upper right of the page to save and apply the configuration.
¶ C) Enter the allowed endpoints on Auth0
Going back to the application page on the Auth0 dashboard website, you'll need to fill in the values for:
- Allowed Callback URLs
- Allowed Web Origins
- Allowed Logout URLs
These values can be found in Wiki.js under Configuration Reference, displayed below the settings of the Auth0 strategy. Click the Save Changes button at the bottom of the page when done. While optional, it's also recommended to set an Application Logo for easy identification by your end users.