English Español Français
Go to YuJa
  1. YuJa Help Center
  2. EqualGround Accessibility Governance Platform
  3. Integrations
  4. SSO Integrations

Integrating Okta SSO with EqualGround

Avatar
YuJa
  • Updated

Integrating Okta SSO with EqualGround allows users to log in to EqualGround with their Okta credentials.

Locating Your EqualGround Identifier Key 

The identifier key is required to create an EqualGround application on Okta. 

  1. Log in to EqualGround as an admin.
  2. In the side navbar, select Configuration > Organization Info.
    EqualGround with configuration and organization info tabs circled
  3. Copy the Identifier Key for later use.
    EqualGround organization information page with identifier key field circled

Adding EqualGround to Okta as an Application

Next, you'll need to add EqualGround as an application on Okta.

  1. Log in to Okta as an admin.
  2. In the side navbar, select Applications > Create App Integration.
    Okta applications page with applications and create app integration button circled
  3. Select SAML 2.0, and then click Next.
    Okta new app integration modal with SAML and next button circled
  4. In the App name field, enter YuJa EqualGround, and then click Next.
    Okta general settings with app name field and next button circled
  5. Enter the Single sign-on URL and the Audience URI using your custom URL in the following format. If you do not have a custom URL, use your zone.
    Okta applications page with URL field circled
    • Single sign-on URL: Replace <YOUR_Identifier_Key> with the identifier key copied in step 3 of Locating Your EqualGround Identifier Key.
      • US Zone: https://equalground.yuja.com/api/sso/samlReceiveResponse?identifierKey=<YOUR_Identifier_Key>
      • Canadian Zone: https://equalground-cz.yuja.com/api/sso/samlReceiveResponse?identifierKey=<YOUR_Identifier_Key>
      • European Zone: https://equalground-ez.yuja.com/api/sso/samlReceiveResponse?identifierKey=<YOUR_Identifier_Key>
      • Australian Zone: https://equalground-az.yuja.com/api/sso/samlReceiveResponse?identifierKey=<YOUR_Identifier_Key>
      • Custom URL: https://<YOUR_CUSTOM_EqualGround_URL>/api/sso/samlReceiveResponse?identifierKey=<YOUR_Identifier_Key>
        • Example: https://hudsonu.equalground.yuja.com/api/sso/samlReceiveResponse?identifierKey=9856168ce455592621561e14123d4
    • Audience URI (SP Entity ID)
      • US Zone: https://equalground.yuja.com
      • Canadian Zone: https://equalground-cz.yuja.com
      • European Zone: https://equalground-ez.yuja.com
      • Australian Zone: https://equalground-az.yuja.com
      • Custom URL:  https://<YOUR_CUSTOM_EqualGround_URL>
        • Example: https://hudsonu.equalground.yuja.com
  6. In the Name ID format field, select EmailAddress.
    Okta applications page with name ID format field circled
  7. In the Attribute Statements section, enter the Attribute Statements using the following format.
    • Name: Email, Name format: Unspecified, Value: user.email
    • Name: FirstName, Name format: Unspecified, Value: user.firstName
    • Name: LastName, Name format: Unspecified, Value: user.lastName
    • Name: Role, Name format: Unspecified, Value: user.title
  8. Click Next.
    Okta applications page with attribute statements fields and next button circled
  9. Select the This is an internal app that we have created check box.
  10. Click Finish.
    Okta with internal app radio button and finish button circled
  11. Click the Assignments tab.
  12. Click Assign > Assign to People or Assign to Groups to add new users into EqualGround.
    Okta with assignments tab and assign button circled
  13. Locate the user or group you want and click Assign.
    Okta applications page with assign button circled
  14. Click Save and Go Back.
    Okta applications page with save and go back button circled
  15. Click Done. 
    Okta applications page with done button circled
  16. Click the user that you want to give the admin role to.
    Okta applications page with name circled
  17. Click the Profile tab > Edit.
    Okta profile tab with profile tab and edit button circled
  18. In the Title field, enter the role name for admins.
    Example: IT Manager.
  19. Click Save.
    Okta applications page with title field and save button circled
     

Getting Okta’s Identity Provider SSO URL and Certificate Fingerprint

Once you've added EqualGround to Okta as an application, you'll need Okta's identity provider SSO URL and certificate fingerprint.

  1. Log in to Okta as an admin.
  2. Click Applications.
  3. Select YuJa EqualGround from the Applications list.
    Okta application page with application and EqualGround circled
  4. Select the Sign On tab.
  5. Click View SAML setup instructions.
    Okta EqualGround page with sign on tab and view SAML setup instructions button circled
  6. Copy the Identity Provider Single Sign-On URL and X.509 Certificate, including the BEGIN CERTIFICATE and END CERTIFICATE text, for later use.
    Okta 509 certificate circled
  7. Go to One Login SAML Tool.
  8. In the X.509 field, paste the X.509 Certificate copied in step 6 and then click Calculate Fingerprint.
  9. Copy the FingerPrint for later use.
    One Login Calculate Fingerprint page with certificate and fingerprint buttons circled

Integrating Okta with EqualGround

Once you've gotten Okta's identity provider SSO URL and certificate fingerprint, you can integrate Okta with EqualGround.  

  1. Log in to EqualGround as an admin.
  2. In the side navbar, select Configuration > Integration Settings.
    EqualGround with Configuration and integration settings tabs circled
  3. In the Select Integration field, select SSO - SAML.
  4. Turn on the Allow authentication via SSO toggle.
    EqualGround integration settings with select integration field and allow authentication toggle circled
  5. Enter the information as shown below.
    EqualGround integration settings with fields circled
  6. Turn on the Enable SSO Mapping toggle.
  7. In the Admin Mapping field, enter the name of the admin role that you added in step 18 of Adding EqualGround to Okta as an Application.
    EqualGround integration settings with admin role toggle and button circled
  8. Click Save Changes to complete the integration.
    Note: Click Launch SSO Login Page to test the integration.
    EqualGround integration settings with save changes and Launch SSO login page buttons circled

Related articles

Contact Support