ChartHop for Administrators
...
Access Settings
Configuring SSO options

Setting up Okta SSO

You can configure your ChartHop organization with Okta SSO.

Generate the Okta metadata file

To set up Okta SSO with ChartHop you will need to configure the Okta ChartHop app and download your Okta metadata file:

  1. Select + Add Integration.
  2. Log in with your Okta account.
  3. Select the Sign On tab for the ChartHop SAML app. Select Edit.
  4. Enter your ChartHop organization's {org-slug} in the Organization ID field.
  5. Select Save.
  6. Select View Setup Instructions.
  7. Scroll down to the Optional section, and save the metadata XML content as a text file named “okta.xml”.
  8. Mark the task as DONE when complete.

Your organization's slug can be found in the Org nickname field under the General tab in Org settings.

Upload Okta metadata to ChartHop

Once you've set up your metadata configuration in Okta, you can return to ChartHop to enable Okta SSO and upload your metadata. Follow these steps to accomplish this:

  1. From the left sidebar, select Access.
  2. From the sub-menu, select Settings.
  3. Scroll to the SSO section on the page.
  4. Toggle Enable Okta SSO.
  5. Upload your Okta metadata file.
  6. Confirm your metadata file content is present.
  7. Select Save settings.

Test the new login with Okta SSO to ChartHop

After uploading your metadata file content to your Okta profile in ChartHop, test the integration by following these steps:

  1. Log out of ChartHop.
  2. Visit: https://app.charthop.com/{org-slug}/account/login where {org-slug} is your ChartHop organization's unique slug.
  3. Confirm that your Okta sign-in displays on the login screen.

If you encounter any issues during or after testing your SSO setup, please reach out to [email protected].

Automatically update Okta profiles and groups

You can automatically update Okta profiles and groups using the Okta Integration. Learn more.

The following SAML attributes are supported:

Attribute name

Name format

Value

org

unspecified

{org-slug-from-ChartHop}

email

unspecified

user.email

first_name

unspecified

user.firstName

last_name

unspecified

user.lastName