Integrating Okta into the Altinity.Cloud login page
10 March 2023 · Read time 3 min
Overview - Okta Integration
Altinity uses Auth0 so that customers who are already logged into other identity providers such as Google or Okta are automatically granted access to Altinity.Cloud.
The following diagram shows the Altinity login process using Auth0, plus adding Okta as discussed on this page.
- Logging in to Altinity.Cloud using a Login Email and Password.
- The Auth0 login link to use a 3rd party authenticator such as Google or Okta. (See Okta/Auth0 Altinity Integration)
- Using Okta allows previously authorized logged-in employees to gain immediate access to Altinity.Cloud. (See Okta Customer Configuration)
Figure 1 – Altinity integration of an Okta customer to Auth0.
Setting up the Auth0 Connection
These steps are for Altinity customers to configure their login integration with Okta.
- Go to Auth0 Dashboard 》Authentication 》Enterprise.
- Click Create (➕ plus icon) located next to OpenID Connect.
- Provide a name.
- Copy the customer-provided Okta domain to Issuer URL.
- Copy the customer-provided Client ID to Client ID.
- Click Create.
If you closed the page, select Dashboard 》Applications 》<application name> to view those settings.
Contact Altinity Support
Contact Altinity to add the customer’s Okta domain and Client ID to the Altinity.Cloud access list.
Please provide the following:
- The domain you want to sign in on the Okta side
- The Issues URL
- Client ID
Okta/Auth0 Altinity Integration
These steps are for Altinity technical support to add an Okta connection to Auth0.
Setting up the Auth0 connection
- Go to Auth0 Dashboard -> Authentication -> Enterprise.
- Click Create (plus icon) next to OpenID Connect.
- Provide a name.
- Copy the Okta domain provided by a customer to Issuer URL.
- Copy the Client ID provided by a customer to the Client ID.
- Click Create.
Enabling the connection
- Go to Auth0 Dashboard -> Applications.
- Click the application you wish to use with the connection.
- Go to the Connections tab, find your newly created connection, and switch it on.
Testing the connection
- Go to Auth0 Dashboard -> Authentication -> Enterprise.
- Click OpenID Connect (not the plus sign, the text).
- Find the newly created connection.
- Click the three dots on the right -> Try.
- You should be greeted with an Okta password prompt, or if there is a problem, an error is shown.
- You should be greeted with an Okta password prompt, or if there is a problem, an error is shown.
Enabling the button
- Go to Auth0 Dashboard -> Authentication -> Enterprise.
- Click OpenID Connect (not the plus sign, the text).
- Find the newly created connection and click its name.
- Go to the Login Experience tab.
- Check the Connection button -> Display connection as a button.
- Configure the Button display name and logo URL.
- Click Save.
Testing
- Go to the https://acm.altinity.cloud login page.
- Click Sign in with Auth0.
- A button for the new connection should be shown.
- Upon clicking the button, it should either ask for Okta credentials or log straight into the app.
Altinity blog post
The following Altinity blog post provides an in-depth discussion of adding Okta as an identity provider.