Skip to main content
Top

How to set up Okta SSO for use with Retrium

Learn how to set up Okta SSO with Retrium to improve security and streamline login for your organization.

premier_plans.pngadmin_role_only.png

Retrium now has direct integration with Okta! Follow these steps to set up the Retrium app within Okta (including SCIM support for Enterprise Edition customers!) If you would prefer to set up a custom SAML integration, follow the steps on this page.

Table of Contents

What to expect

Your onboarding email from Retrium’s Customer Success team includes a link to an SSO form you will need to submit to initiate your implementation.

Our SSO integrations have the option to enable JIT (Just-In-Time) provisioning and automatic addition of users to your Organization upon logging in for the first time, provided they are provisioned within your IdP.

What to expect for your SSO implementation with Retrium:

  1. After submitting your form, you will receive an email confirming your submission and providing a link to schedule a testing call.
  2. Once the call has been scheduled, Retrium will provide you with the Single sign-on URL and Audience URI (SP Entity ID) to be entered within Okta.
  3. After you save the custom Retrium SAML app in Okta, you can then provide us with the following:
    • Attributes (if different from the defaults)
    • Certificate (Base64)
    • Login URL

Video overview

How to configure custom SAML app integration in Okta

  1. Click Applications in the lefthand sidebar
  2. Select Applications from the options presented
  3. Click Create App Integration at the top of the page
  4. Select SAML 2.0, then click Next
  5. Enter Retrium for the App name (and upload the logo we provided if you wish)
  6. Click Next
  7. Under SAML Settings > General, enter the Single sign-on URL and Audience URI (SP Entity ID) we emailed you
  8. Click Show Advanced Settings
  9. From the Assertion Encryption dropdown, select Encrypted
  10. In the Attribute Statements section, Retrium supports the following attributes:
  11. Name Value
    email* user.email*
    firstName user.firstName
    lastName user.lastName
    *required

    Click Next at the bottom of the page

  12. Select I'm an Okta customer adding an internal app, then click Finish

From the Sign On tab for the custom SAML app you created in Okta, click View SAML setup instructions. We'll request the following information from you to finish setting up your SSO configuration:

  • Identity Provider Single Sign-On URL
  • X.509 Certificate

If you have any questions as you configure SSO for use with Retrium, please don't hesitate to contact us!

Related articles