Do you want to use single sign-on in Recruitee? In order to be able to use single sign-on in Recruitee, you need to have an already configured application on a supported authorization management platform. In this article we explain how to do this for Auth0.
Create a new application for SSO in Auth0
Go to your Auth0 dashboard and click Create application.
2. Under Name type in a relevant name for the new application (Recruitee is recommended as the Application Name) and select Regular Web Applications as application type and click Create.
3. After this you will be redirected to the application overview and go to tab Addons
4. Switch on SAML2 - WEB APP
5. In tab Settings of the pop-up add the following details:
Application Callback URL: https://auth.recruitee.com/sso/sp/consume/YOUR_COMPANY_NAME YOUR_COMPANY_NAME stands for your company subdomain from Recruitee - it will be used for generating a unique SSO login URL for your users.
Settings:
{
"mappings": {
"email": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/email"
},
"signResponse": true
}
6. Scroll down to the bottom of the Settings tab and click Enable.
7. Go to the Usage tab and download the Identity Provider Metadata. As a result an XML file will be downloaded.
8. Log into Recruitee and go to the Tellent Admin Center.
📌 If you don't see the Tellent Admin Center, make sure you are logged in via auth.tellent.com and that you have full permissions in your organisation.
9. In the Tellent Admin Center, click on "Set up SSO for your company".
10. Now click on "Continue to the next step".
11. Upload the XML file and click on "Continue to the next step".
12. Now enable the SSO for Recruitee and select the default role for new users. Click on "Start testing SSO" to finish the setup.
📌 After clicking on "Start testing SSO", then all users can sign-in with SSO, while the old login also remains accessible. When you're done testing, you can enable SSO for everyone, which means the old sign-in method will no longer work.
⚠️ It is possible to change a user's role within Recruitee after they signed up. If you select a role that has restricted access to jobs/talent pools, like Reviewer, you will have to assign jobs/talent pools to new users manually within Recruitee.
13. In your Auth0 account add or assign users, or a group of users, to the app to give them access to your SSO-enabled company in Recruitee.