# Okta SSO

## [Installation](https://docs.sentry.io/.md#installation)

If you change your organization slug, you'll need to make the same update in the steps where you enter the SAML configuration values.

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

2. From the admin console's sidebar, click **Applications > Applications**, then click on "Browse App Catalog" (or "Add Application" for the old interface).

3. Search for `Sentry`, then click "Add Integration" to be brought to the setup wizard.

   [![Sentry in Okta Gallery of Integrations](https://docs.sentry.io/_next/image/?url=%2Fmdx-images%2Fokta-gallery-N6S553CH.png%232560x1000\&w=3840\&q=75)](https://docs.sentry.io/mdx-images/okta-gallery-N6S553CH.png)

4. Provide the settings. Note that for "1. General Settings", you will not need to provide any special settings. For "2. Sign On Options", provide the following:

   * Base URL: `https://sentry.io`

     Ensure that the Base URL does not have a trailing slash or whitespace at the end as they 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](https://docs.sentry.io/_next/image/?url=%2Fmdx-images%2Fokta-settings-for-sentry-4MRBQPLO.png%231332x2112\&w=3840\&q=75)](https://docs.sentry.io/mdx-images/okta-settings-for-sentry-4MRBQPLO.png)

5. Click "Save" to create the Sentry app.

6. When you're redirected to the app settings page, click "Sign On".

7. Copy the "Metadata URL" in the set up instructions.

   [![Okta metadata URL in setup instructions](https://docs.sentry.io/_next/image/?url=%2Fmdx-images%2Fokta-setup-instructions-page-3S3DZNQU.png%231890x672\&w=3840\&q=75)](https://docs.sentry.io/mdx-images/okta-setup-instructions-page-3S3DZNQU.png)

8. Sign in to Sentry. Select **Settings > Auth > Configure Okta**.

   [![Sentry single sign-on configuration page](https://docs.sentry.io/_next/image/?url=%2Fmdx-images%2Fokta-sentry-sso-settings-page-NHI7KU7L.png%231024x663\&w=2048\&q=75)](https://docs.sentry.io/mdx-images/okta-sentry-sso-settings-page-NHI7KU7L.png)

9. Paste the Metadata URL from Step 8, then click "Continue".

   [![Sentry single sign-on configuration for Okta](https://docs.sentry.io/_next/image/?url=%2Fmdx-images%2Fokta-sentry-settings-metadata-url-DNXJPERF.png%231024x292\&w=2048\&q=75)](https://docs.sentry.io/mdx-images/okta-sentry-settings-metadata-url-DNXJPERF.png)

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:

* 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 make any changes, click "Save Settings" to complete your set up.

[![Sentry single sign-on settings for Okta](https://docs.sentry.io/_next/image/?url=%2Fmdx-images%2Fokta-sentry-settings-for-okta-GIZIAQZJ.png%231024x980\&w=2048\&q=75)](https://docs.sentry.io/mdx-images/okta-sentry-settings-for-okta-GIZIAQZJ.png)

## [SCIM Integration](https://docs.sentry.io/.md#scim-integration)

* See [Okta SCIM Provisioning](https://docs.sentry.io/okta-scim.md).
