> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hireflix.com/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.

## Steps

**1. Create the app integration in Okta**

Go to **Okta > Applications > Create App Integration**.

![Creating an app integration in Okta](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-1.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=9ddfa51e9870f6791332f5d8a53f69ef)

**2. Choose SAML 2.0**

Choose **SAML 2.0** as the sign-on method.

![Choosing SAML 2.0 in Okta](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-2.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=d8e6b967147153629a2dfe7cab581bcc)

**3. Name the app**

Set the app name and logo (optional). We suggest using "Hireflix".

![Naming the app in Okta](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-3.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=24d5c6a592bdf1b826eb1e19e6863e0b)

**4. 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).

![Enabling SSO in Hireflix](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-4.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=e5a26c41762489dea613ba41f023debd)

**5. 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>`.

![Copying the Location URL from the XML document](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-5.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=80a4c9976e1e74d6e1bb10d4ca89dda6)

**6. Copy the entityID**

Copy the **entityID** property from the same XML document.

![Copying the entityID from the XML document](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-6.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=6e2a6ba88df73eea9b03581bd7d537bb)

**7. 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`

![Pasting values into Okta](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-7.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=396f5c3b172da310557a03af83f7b114)

**8. Finish the Okta configuration**

Click **Next** and finish the last configuration step. Once done, go to the **Sign On** tab in Okta.

![The Sign On tab in Okta](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-8.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=f01d4527fe1b60b70070f1730751a1a2)

**9. 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.

**10. 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**.

![The Sign On tab in Okta](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-10.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=2e6d8540295458d5c765c5ba43e4581d)

## 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**.

![Assigning users in Okta](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-assign-users-1.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=9c11d54b45ebbd50a473a88b4002284b)

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

![Assigning people or groups to the Hireflix SSO app](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-assign-users-2.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=9b52a51593b1fbf1f1ae7582e9de721c)

Hireflix with Okta SSO is now configured.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.