InsightHireHelp Center

Single sign-on & SCIM

Connect your identity provider so your team signs in with their company account, keep the team list in sync, map groups to roles and require single sign-on.

Organization Admins can connect your company's identity provider (for example Okta, Microsoft Entra ID or Google Workspace) from Settings → Security. The page is called Security & provisioning and walks through four steps.

Who can do what

TaskWho
Set up single sign-on, directory sync, group mapping and the SSO requirementOrganization Admins
Configure the identity provider itselfYour IT administrator, from the setup link. They don't need an InsightHire account.

1. Single sign-on

  1. Open Settings → Security.
  2. Under Single sign-on, enter your IT administrator's email (optional).
  3. Select Email setup link to send it to them, or Create setup link to copy it yourself.
  4. Your IT administrator opens the link and configures your identity provider.

When it is done, the card shows Connected to your provider. Your team then sees Continue with company SSO (or your provider's name) on the sign-in page.

2. Directory sync (SCIM)

Directory sync keeps your team list current. When someone is deactivated in your identity provider, their InsightHire access is removed, even if they never sign in again.

  1. Under Directory sync (SCIM), select Turn on directory sync.
  2. Copy the token straight away. It is shown only once.
  3. Paste the token and the Tenant URL into your identity provider's provisioning settings.

Once it is on, the card shows the status and the last sync time. Open guided setup (or Email directory-sync instructions if you entered your IT administrator's email) gives step-by-step instructions for your provider. Use Rotate token to replace the token.

3. Group permissions

Map a group from your identity provider to an InsightHire role, so people get the right role when they arrive.

  1. Under Group permissions, enter the Group name and, optionally, the Group ID from your identity provider.
  2. Choose the role: Recruiter, Hiring manager or Organization admin.
  3. Select Add.

Someone in no mapped group gets Recruiter. Select Remove next to a mapping to delete it. See Roles & permissions for what each role can do.

4. Require single sign-on

When single sign-on is required, your team can only sign in through your identity provider. Email links, emailed codes and passkeys are turned off for everyone in your workspace.

  1. Finish step 1 first. You can't require single sign-on before it is connected, so nobody gets locked out.
  2. Select Require SSO only.

To undo it, select Allow email sign-in again.

Audit log

The View audit log link at the top of the page opens your organization's audit log. See Team & roles.

Troubleshooting

  • The page says it can't reach the identity service: try again in a few minutes. If it continues, contact InsightHire support.
  • Someone can't sign in after you required SSO: check that they exist in your identity provider and are assigned to the InsightHire app there.
  • A new person got the wrong role: check which identity-provider groups they are in and your group mappings.