Configuring OpenID SSO for Okta

These steps show you how to configure the single sign-on (SSO) functionality using OpenID between ManageEngine ADSelfService Plus and Okta.

1. Login to ADSelfService Plus as Admin.
2. Go to Configuration > Password Sync/ Single Sign On and click Add Application. Select Okta from the list.
Note: You can also use the search bar, in the top-left, to search for the application.
3. Click on IdP Details and select the SSO (OAuth/OpenID Connect) tab.
4. Copy Client ID, Client Secret, Issuer, Authorization Endpoint URL, Token Endpoint URL, User Endpoint URL, and Keys Endpoint URL.

Okta (service provider) configuration steps

1. Login to Okta as administrator.
2. Go to Security → Identity Providers → Add Identity Provider → Add OpenID Connect IdP.

3. Enter a Name of your preference.
4. Fill the required fields with details copied in step 4 of Prerequisites:
• Client ID: Client ID
• Client Secret: Client Secret
• Mention "email, openid, profile" in the Scopes field.
• Issuer: Issuer
• Authorization endpoint: Authorization Endpoint URL
• Token endpoint: Token Endpoint URL
• JWKS endpoint: Keys Endpoint URL
• Userinfo endpoint: User Endpoint URL

5. Click Add Identity Provider at the bottom to save the settings.

6. After saving, copy the Redirect URI as it will be required in later steps.

7. To add the instance of ADSelfService Plus to Okta's login screen, go to the Routing Rules tab and click Add Routing Rule.

8. In the popup that appears, set the User matches field to Regex on Login. Set the value as '.*'.
9. Select the ADSelfService Plus instance for Use this Identity provider condition.

10. Click Create Rule to complete the settings.
11. In the pop-up that appears, click Activate.

ADSelfService Plus (identity provider) configuration steps

1. Switch back to ADSelfService Plus' Okta configuration page.
2. Enter the Application Name and Description as per your preferences.
3. Enter the Domain Name of your Okta account. For example, if your Okta username is johnwatts@thinktodaytech.com, then thinktodaytech.com is your domain name.
4. Select policies from the Assign policies dropdown, to decide for whom this setting will be applicable.
5. Check the box next to Enable OAuth/OpenID Connect.
6. Enter the Redirect URI you saved in step 6 of Okta configuration in Login Redirect URL field.
7. Scopes specify the level of access the access token has. The scopes are generally provided in the authorization request so, you don't have to specify them here. If the scopes are not mentioned by your service provider, you must add them in this field

8. Click Add Application to save these settings.
9. The Well-known Configuration URL in IdP details pop-up contains all the endpoint values, supported scopes, response modes, client authentication modes, and client details. This is enabled only after you save the application in ADSelfService Plus. You can provide this to your service provider if required.