> ## 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 OneLogin

## Overview

How to set up SSO between Hireflix and OneLogin.

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

OneLogin supports SAML 2.0, but since Hireflix doesn't have a predefined integration, you'll need to use the **Custom Connector** approach OneLogin provides.

> [!NOTE]
>
> This page contains more specific details on top of [OneLogin's official Custom Connector instructions](https://onelogin.service-now.com/support?id=kb_article\&sys_id=8a1f3d501b392510c12a41d5ec4bcbcc\&kb_category=de885d2187372d10695f0f66cebb351f).

## Steps

**1. Enable SSO in Hireflix**

From your [Hireflix account settings](https://admin.hireflix.com/en/my-account/sso), enable SSO and open the **Service Provider Metadata Endpoint** file.

**2. Add the Custom Connector in OneLogin**

In OneLogin, add the **SAML Custom Connector (Advanced)** application, then open its Configuration settings and set the following fields:

| Field | Value |
| :- | :- |
| RelayState | `https://admin.hireflix.com/en/jobs` |
| Audience (EntityID) | The `EntityID` string from the Service Provider Metadata Endpoint XML file, e.g. `hireflix-1a2b3cbf-12f0-2a7b-1332-f1c7617226ef` |
| Recipient | Leave unset |
| ACS (Consumer) URL Validator | `^https:\/\/admin\.hireflix\.com\/sso\/saml2\/callback\/hireflix-.*$` |
| ACS (Consumer) URL | The `Location` attribute of the `<AssertionConsumerService>` entry in the same XML file, e.g. `https://admin.hireflix.com/sso/saml2/callback/hireflix-1a2b3cbf-12f0-2a7b-1332-f1c7617226ef` |

Leave all other fields untouched.

**3. Upload the metadata to Hireflix**

In the OneLogin App Configuration page, select **More Actions** and download the SAML metadata. Upload this file to Hireflix on the SSO configuration page, under **Identity Provider Metadata XML**.

![Uploading the Identity Provider Metadata XML to Hireflix](https://mintcdn.com/hireflixsl/VDRYCrZwKf8DNtoK/images/hireflix-userguide-okta-10.png?fit=max\&auto=format\&n=VDRYCrZwKf8DNtoK\&q=85\&s=2e6d8540295458d5c765c5ba43e4581d)

You should be all set!

> [card] [Need help?](mailto:support@hireflix.com)
>
> Contact us at [support@hireflix.com](mailto:support@hireflix.com) and we'll help you out.


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