Okta: Set up and find SSO configuration information

Learn to set up and find the correct information to configure single sign-on for your Engagement Cloud account using Okta.

Before you start

This article is part of a process. Read the article Set up Single Sign-On (SSO) for your account in conjunction with this article.

Step 1: Create a new app

To create a new app in Okta:

  1. Log in to your Okta tenant admin.
  2. Go to Applications > Applications.
  3. Select Add application, and then Create New App.
  4. Under Create a New Application Integration, expand the Platform drop-down menu, and select Web.
    add-application-form.png
  5. For Sign on method, select OpenID Connect.
  6. Select Create.
    This takes you to the Create OpenID Connect App Integration form.

Step 2: Set up your Okta application and find Client ID and Client server

From the Create OpenID Connect App Integration form, you can set up your Okta app and find your Client ID and Client server:

  1. Under GENERAL SETTINGS, for Application name, enter a name for your application.
    Use a name that's easy to identify, like dotdigital or Engagement Cloud.
    okta-app-int-form-name.png
  2. If you want to add a logo, for Application logo, add an image for your application.
  3. For Login redirect URIs, select + Add URI, and enter https://login.dotdigital.com/Sso/Authenticate, and repeat to add https://login-sso.dotdigital.com/Sso/Authenticate also.
    okta-app-int-form-add-uri.png
  4. Select Save.
    This takes you to the general settings of your application.
  5. Under the heading Client Credentials, copy the Client ID and save it for later.
    okta-app-client-secret.png
  6. Copy the Client secret and save it for later.

Step 3: Find your Well-known endpoint

In Okta, the Well-known endpoint is called the Metadata URI. To find the Metadata URI:

  1. From the top menu, go to Security > API.
  2. Find the Authorisation server you want to use, and select the Edit icon.
  3. Under Settings, find the Metadata URI, and copy the URI and save it for later.
    The metadata URI is your well-known endpoint.

Next steps

You now have all the information you need to set SSO up on your account.

Did you find this article helpful?

Can we help?

Thanks for using Engagement Cloud. If you need more help or support, then contact our support team.