Okta SSO

Installation

  1. Sign in to your Okta organization with your administrator account.

  2. From the admin console's sidebar, click Applications > Applications, then click on "Add Application".

  3. Search for Sentry and click "Add", and you will be brought to the setup wizard.

    Sentry in Okta Gallery of Integrations

  4. For "1. General Settings", no special settings are needed.

  5. For "2. Sign On Options", fill in these fields as follows:

    • Base URL: https://sentry.io

      • Important: There should not be a trailing slash at the end of the URL as it will break the redirect from Okta to Sentry.
    • Organization Slug: YOUR_ORG_SLUG

      • You can find your organization slug in the URL: https://sentry.io/organizations/YOUR_ORG_SLUG/
    • Email: Email

    Configuring Sentry in Okta

  6. Click "Save", and the Sentry app will be created.

  7. You'll be redirected to the app settings page. Click "Sign On", and you'll be brought back to the same settings in Step 5. This time, click on "View Setup Instructions" in the bright yellow card, and a new tab will open.

  8. In the new tab, look for the "Metadata URL" in the setup instructions and copy it.

    Okta metadata URL in setup instructions

  9. Sign in to Sentry. Click Settings > Auth > Configure Okta.

    Sentry Single Sign-On configuration page

  10. Paste the Metadata URL from Step 8, and click "Continue".

    Sentry Single Sign-On configuration for Okta

  11. Sentry will attempt to authenticate and link your account with Okta. After successful authentication, you'll be redirected to Sentry's SSO configuration page, where you can take the following actions:

    • You can share the "Login URL" value, which will be used for SP-initiated SSO, with the users in your organization.

    • Scroll down to the bottom and ensure that "Require SSO" is checked if you want to enforce logging in with Okta.

    • Set a "Default Role" for new SSO users. Selecting "Member" should cover most use-cases.

    • If you made changes, click "Save Settings" to complete your setup.

    Sentry Single Sign-On settings for Okta

You can edit this page on GitHub.