Setting Up SSO with Okta

Overview

How to set up SSO between Hireflix and Okta.

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.

   
2. Choose SAML 2.0

   Choose SAML 2.0 as the sign-on method.

   
3. Name the app

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

   
4. Enable SSO in Hireflix

   Go back to Hireflix > My Account > Single Sign On. 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).

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

   
6. Copy the entityID

   Copy the entityID property from the same XML document.

   
7. Paste the values into Okta

   Paste the values you copied into the corresponding fields in Okta.

   Make sure the following settings are configured exactly as shown:

   • Name ID format → EmailAddress
   • Application username → Email
   • Update application username on → Create and update

   
8. Finish the Okta configuration

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

   
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 > Identity Provider Metadata XML and upload the metadata file from the previous step. Once uploaded, click Save.

    

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.

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

Hireflix with Okta SSO is now configured.