Use Okta SSO

Okta is one of the SSO providers and it is an SaaS-based service that acts as a centralized authentication platform for different applications. When configured with Okta, Incorta Analytics sends a request to Okta for authentication when a user tries to log in. If Okta authenticates this user, it sends a SAML response containing the user’s identity (i.e. user ID) for Incorta Analytics to provide them with access to the platform.

In order to set up users for Okta SSO authentication, you need:

  • Incorta Analytics Superuser account.
  • Okta Admin account.
  • Incorta Analytics installed and running.
  • Directory sync configured.
  • Load balancer that can access Incorta.

Configure Okta to Use Incorta

Create an application in Okta for each Incorta Analytics tenant:

  1. Log in to the Okta Administration Console
  2. On the Applications tab, select Add Applications.
  3. Create a new application and register Incorta.
  4. Generate a property file. Save the file in the <IncortaNode>/sso directory.
  5. Ensure that the single sign-on URL and other URL fields are your Incorta URL followed by /!tenant_name/. You must end the URL with the forward slash (/). For example: http://host/incorta/!tenant2/
  6. Set Name ID Format to EmailAddress.
  7. Ensure that the loginName attribute matches the loginName used in your directory sync.
  8. Select Sign-in, then Identity Provider metadata to download the configuration file.

Edit the Okta Configuration File

A sample file can be found in the same location as the readme file to be used as a reference of how the configuration file should look like after editing. The readme file location is: <Incorta_Home>/sso.

Make the following changes in the configuration file:

  1. Wrap the <md> tag with the tags: <configuration>, <applications>, and <application>.
  2. Add <default>OKTA_APP_URL</default> directly under the tag <configuration>, where OKTA_APP_URL is the same as entityID.
  3. Save the file.

Create a user in Okta

Use the following steps to create a user in Okta;

  1. Navigate to the Okta admin page.
  2. From the Directory tab, choose People.
  3. Select Add Person.
  4. Add the user information.
  5. Select Send user activation email now and select Add Person to send the user an activation email and set their password.

Assign an application to a user

Use the following steps to assign an application to a user.

  1. Navigate to the Okta admin page.
  2. From the Applications tab, select Applications.
  3. Select the applications to assign to the user from the Applications table.
  4. Select Assign Application.
  5. Select a user.
  6. Select Next and confirm.

Creating an Incorta Analytics User in Okta

  1. Create a user in Incorta Analytics with the same username as the email address used to create the account in Okta. If the user email is not the same, the Incorta Analytics Server will not recognize the user and thus will not grant access to that user.
  2. To enable SSO login using the Tenant Management Tool (TMT) command, run the following command from the directory <Incorta_Home>/tmt: ./ -u <tenant_name> sso-login-enable true.
  3. Edit the file <Incorta_Home>/server/conf/server.xml. Before the <Host> tag, add: <Valve className="com.incorta.sso.valves.OktaValve" confFilesMap= "<TENANT_NAME>=<IncortaNode>/sso/<property-file-name>" LoggingEnabled="true"/>.
  4. Restart the Incorta Analytics server using the ./ and ./ commands.

© Incorta, Inc. All Rights Reserved.