Skip to content
LogScale Self-Hosted
This is an archived version of the documentation downloaded from LogScale Documentation Archives. Up to date documentation, and documentation for later versions, is available on LogScale Documentation

### Auth0

This section explains how to integrate Auth0 as a SAML identity provider with LogScale. It covers creating an Auth0 application, configuring SAML settings, managing user accounts, and testing the integration. Auth0 provides a cloud-based identity platform that allows for centralized user management and authentication for LogScale users.

LogScale allows for the integration of many applications. If you want to integrate Auth0 into LogScale, you can do so by creating an application (i.e., an app) in Auth0. To do this, you have to use Auth0's dashboard. This is used to authenticate and authorize the app.

#### Prerequisites for Auth0 configuration

Prior to performing the steps below, make sure that you have an Auth0 account.

#### Create an app in Auth0

Log in to the Auth0 dashboard page:

1. In the Auth0 dashboard, go to Applications and click Applications.

   Figure 78. Auth0 Dashboard Applications Section

2. Click Create Application. Name the app and select Native. Click Create.

   Figure 79. Creating a New Auth0 Application

3. After you have created the app, make sure you are in the app you created before continuing. Click the Addonscreate tab.

   Figure 80. Auth0 Application Addons Tab

4. An option to enable SAML2 appears. Make sure that is enabled.

   Figure 81. Enabling SAML 2.0 in Auth0

   When you click to enable it, the SAML details appear.

   Figure 82. Enabling SAML 2.0 in Auth0

5. Click Settings and set the Callback URL to `http://$YOUR_LOGSCALE_URL/api/v1/saml/acs`. Once you enter the callback URL, be sure to scroll to the bottom and select enabled, otherwise it will not be enabled.

   Figure 83. Configuring SAML Settings and Callback URL

6. Click Usage and copy the Identity Provider Login URL and Issuer and paste them into a text editor to use later.

   Figure 84. Accessing the Identity Provider Login URL

7. Click the Identity Provider Certificate to download it. Save this in a certs directory where your native app is running.

Now you must set up users in Auth0. To do this:

1. Go to the Auth0 dashboard and click User Management then select Users.

   Figure 85. Accessing User Management in Auth0

2. Click Create User. Select the Username-Password-Authentication Connection Type. Enter the user details and click Create.

   Figure 86. Creating a New User in Auth0

At this point, Auth0 is configured to work with LogScale. If you want to use groups to manage user authorizations, proceed to Create an Auth0 app with groups configuration (optional). Otherwise, the next step is to configure LogScale to work with your Auth0 app.

#### Create an Auth0 app with groups configuration (optional)

If you plan to use groups to manage user authorizations between Auth0 and LogScale, you can configure this in Auth0 so that single sign-on is managed seamlessly for users.

Prior to doing the groups configuration, make sure that you have created users as described in Create Auth0 users.

To utilize groups with Auth0, add the Authorization Extension:

1. Click Extensions in the sidebar and type `Authorization` in the search box. When the `Auth0 Authorization` application appears, click to install the application.

   Figure 87. Installing the Auth0 Authorization Extension

2. Click Groups. If it prompts you to configure the Auth0Extension, go to this list and then come back here to finish setting up the group.

   Figure 88. Accessing the Groups Section in Auth0

3. Click Create Group and enter the `Name` and `Description` of the group.

   Figure 89. Creating a New Group in Auth0

4. Click the group name and click Add Members to add users to the group.

   Figure 90. Adding Members to an Auth0 Group

The next part of the process is to configure the authorization extension so it passes the group in the authorization data. To do that:

1. Click on your name, then click Configuration.

   Figure 91. Accessing Authorization Extension Configuration

2. Configure the extension as shown in the figure. Click Publish rule after making the changes.

   Figure 92. Publishing Authorization Extension Rules

Remember to set up group mapping in LogScale so that the group name from Auth0 matches the external group mapping name in LogScale. For more information, see Group Synchronization.

#### Configure LogScale for Auth0

After you have prepared Auth0 for integrating with LogScale, you need to configure LogScale.

To configure Auth0 to work with LogScale, you must set the configuration variables as described in Configure SAML for LogScale Self-Hosted using the details that you saved and downloaded earlier.

#### Test the Auth0 integration setup

Once all of the necessary steps to set up the Auth0 authentication for LogScale are completed, you need to test the setup.

1. Go to a Terminal and start LogScale with the following command:

   shell

       ./run.sh

   Allow two to three minutes for LogScale to start.

2. Connect to localhost in a browser. It should redirect you to an Auth0 login.

3. Sign into your Auth0. You should be taken to LogScale.

#### Enter search term