SSO & Directory Sync

Edited

Single sign-on (SSO) lets your people sign in to Careerminds through your identity provider, such as Okta, Microsoft Entra ID or Google, instead of using a separate password. Directory Sync goes a step further: it creates, updates and archives Careerminds users based on your identity provider.

Before you start

  • SSO has to be switched on for your account by our team. Email support@careerminds.com to ask about availability and pricing.

  • You need to be an organisation admin in Careerminds.

  • The person who sets up the connection needs admin access to your identity provider. This is usually someone in IT.

Set up SSO

  1. Click your name at the bottom of the side menu, then [your organisation] settings.

  2. Open Integrations and select SSO.

  3. If you see "Your organisation does not currently have SSO provisioned", select Provision SSO. Your email domain is added to the Domains list. To add or change domains, contact us.

  4. Under Connections, select Generate SSO Link. The link is copied to your clipboard.

  5. Send the link to the person who manages your identity provider. They follow the on-screen steps to connect it.

Important

The setup link expires 5 minutes after you generate it, and anyone with the link can configure SSO for your organisation. Only send it to your IT admin, and select Regenerate if it runs out.

Once connected, the service appears under Connections with its status. To make later changes, such as uploading a new certificate, generate a fresh link for your IT admin.

Set up Directory Sync

  1. On the same SSO page, scroll to Directories.

  2. If you use Google, enter the groups to sync under Select Groups to Sync (Google Only) as a comma-separated list, then select Update Groups. Skip this step for other providers.

  3. Select Create Directory and follow the on-screen steps.

Google users

Add your groups before connecting a Google directory. If you leave the field blank, no users sync. Enter an asterisk (*) to sync everyone.

How Directory Sync works

  • Adding people: when someone is given access to Careerminds in your identity provider, an account is created for them automatically. They don't get an invite email.

  • Removing people: when someone loses access, for example they're removed from the group or deleted, their Careerminds account is archived. If access is given back, the account becomes active again.

  • Updating details: changes to first name, last name and email sync across. The manager also syncs when it matches an existing user in your organisation.

Billing

Users added or archived by Directory Sync count towards your seats in the same way as users you add yourself. See How seat numbers change.

Frequently asked questions

Can team and position sync too?

Yes, if your organisation has this turned on. Team and position values must match teams and positions that already exist in Careerminds. Contact us to ask about it.

Can I set up SSO for only some of my people?

Yes. In Okta, assign people to groups and give those groups access to the app. In Google, list the groups you want on the SSO page before you connect your directory.

Which identity providers are supported?

Most major providers, including Okta, Microsoft Entra ID (Azure AD) and Google, as well as generic SAML and OpenID Connect. If you're unsure about yours, contact us.

Someone already has a Careerminds account in another organisation. Will they sync?

No. A person can't be synced into your organisation if their email is already used by an account elsewhere. Contact us and we'll help.

Someone can't get in after SSO is set up. What should they try?

A hard refresh, clearing cookies, or logging out and back in usually fixes it. If not, contact us.