> ## Documentation Index
> Fetch the complete documentation index at: https://hireflixsl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting Up SSO with Okta

## Overview

How to set up SSO between Hireflix and Okta.

<Warning>
  Only assign people whose email matches an email that's part of your team in Hireflix — otherwise they won't be able to log in.
</Warning>

## Steps

<Steps>
  <Step title="Create the app integration in Okta">
    Go to **Okta > Applications > Create App Integration**.

    <Frame>
      <img src="https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-1.png?fit=max&auto=format&n=VDRYCrZwKf8DNtoK&q=85&s=9ddfa51e9870f6791332f5d8a53f69ef" alt="Creating an app integration in Okta" width="3456" height="1810" data-path="images/hireflix-userguide-okta-1.png" />
    </Frame>
  </Step>

  <Step title="Choose SAML 2.0">
    Choose **SAML 2.0** as the sign-on method.

    <Frame>
      <img src="https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-2.png?fit=max&auto=format&n=VDRYCrZwKf8DNtoK&q=85&s=d8e6b967147153629a2dfe7cab581bcc" alt="Choosing SAML 2.0 in Okta" width="3456" height="1798" data-path="images/hireflix-userguide-okta-2.png" />
    </Frame>
  </Step>

  <Step title="Name the app">
    Set the app name and logo (optional). We suggest using "Hireflix".

    <Frame>
      <img src="https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-3.png?fit=max&auto=format&n=VDRYCrZwKf8DNtoK&q=85&s=24d5c6a592bdf1b826eb1e19e6863e0b" alt="Naming the app in Okta" width="3456" height="1794" data-path="images/hireflix-userguide-okta-3.png" />
    </Frame>
  </Step>

  <Step title="Enable SSO in Hireflix">
    Go back to [**Hireflix > My Account > Single Sign On**](https://admin.hireflix.com/en/my-account/sso). Enable SSO and copy the **Service Provider Metadata Endpoint URL** to your clipboard. Open a new browser tab and load the URL — this displays an XML-formatted document (see the next step).

    <Frame>
      <img src="https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-4.png?fit=max&auto=format&n=VDRYCrZwKf8DNtoK&q=85&s=e5a26c41762489dea613ba41f023debd" alt="Enabling SSO in Hireflix" width="3456" height="1786" data-path="images/hireflix-userguide-okta-4.png" />
    </Frame>
  </Step>

  <Step title="Copy the Location URL">
    Within the XML document, copy the URL in the **Location** property. It should look like `https://admin.hireflix.com/sso/saml2/callback/<unique-id>`.

    <Frame>
      <img src="https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-5.png?fit=max&auto=format&n=VDRYCrZwKf8DNtoK&q=85&s=80a4c9976e1e74d6e1bb10d4ca89dda6" alt="Copying the Location URL from the XML document" width="3132" height="624" data-path="images/hireflix-userguide-okta-5.png" />
    </Frame>
  </Step>

  <Step title="Copy the entityID">
    Copy the **entityID** property from the same XML document.

    <Frame>
      <img src="https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-6.png?fit=max&auto=format&n=VDRYCrZwKf8DNtoK&q=85&s=6e2a6ba88df73eea9b03581bd7d537bb" alt="Copying the entityID from the XML document" width="3448" height="558" data-path="images/hireflix-userguide-okta-6.png" />
    </Frame>
  </Step>

  <Step title="Paste the values into Okta">
    Paste the values you copied into the corresponding fields in Okta.

    <Warning>
      Make sure the following settings are configured **exactly** as shown:

      * Name ID format → `EmailAddress`
      * Application username → `Email`
      * Update application username on → `Create and update`
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-7.png?fit=max&auto=format&n=VDRYCrZwKf8DNtoK&q=85&s=396f5c3b172da310557a03af83f7b114" alt="Pasting values into Okta" width="3456" height="1700" data-path="images/hireflix-userguide-okta-7.png" />
    </Frame>
  </Step>

  <Step title="Finish the Okta configuration">
    Click **Next** and finish the last configuration step. Once done, go to the **Sign On** tab in Okta.

    <Frame>
      <img src="https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-8.png?fit=max&auto=format&n=VDRYCrZwKf8DNtoK&q=85&s=f01d4527fe1b60b70070f1730751a1a2" alt="The Sign On tab in Okta" width="1236" height="354" data-path="images/hireflix-userguide-okta-8.png" />
    </Frame>
  </Step>

  <Step title="Download the metadata file">
    Under **Settings > Sign on methods > SAML 2.0 > Metadata details**, copy the Metadata URL and load it in another browser tab. Save the metadata contents as an XML file — you'll need it for the next and final step.
  </Step>

  <Step title="Upload the metadata to Hireflix">
    Go to **[Hireflix > My Account > Single Sign On](https://admin.hireflix.com/en/my-account/sso) > Identity Provider Metadata XML** and upload the metadata file from the previous step. Once uploaded, click **Save**.

    <Frame>
      <img src="https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-10.png?fit=max&auto=format&n=VDRYCrZwKf8DNtoK&q=85&s=2e6d8540295458d5c765c5ba43e4581d" alt="The Sign On tab in Okta" width="3456" height="1780" data-path="images/hireflix-userguide-okta-10.png" />
    </Frame>
  </Step>
</Steps>

## Assign Okta users to the Hireflix SSO app

You need to give Okta users access to the Hireflix SSO app you just configured. Within the Hireflix SSO app configuration in Okta, go to **Assignments > Assign**.

<Frame>
  <img src="https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-assign-users-1.png?fit=max&auto=format&n=VDRYCrZwKf8DNtoK&q=85&s=9c11d54b45ebbd50a473a88b4002284b" alt="Assigning users in Okta" width="3456" height="1558" data-path="images/hireflix-userguide-okta-assign-users-1.png" />
</Frame>

Then assign either people or groups to the Hireflix SSO app.

<Frame>
  <img src="https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-assign-users-2.png?fit=max&auto=format&n=VDRYCrZwKf8DNtoK&q=85&s=9b52a51593b1fbf1f1ae7582e9de721c" alt="Assigning people or groups to the Hireflix SSO app" width="3536" height="1740" data-path="images/hireflix-userguide-okta-assign-users-2.png" />
</Frame>

Hireflix with Okta SSO is now configured.
