Fixing single sign-on sign-in errors
What each single sign-on message means and what a System Admin should check or change to clear it.
What each single sign-on message means and what a System Admin should check or change to clear it.
This is for System Admins, and for anyone helping a colleague who cannot sign in through single sign-on. The fixes are made on Settings then Security (see "Setting up single sign-on") and, for missing accounts, under Settings then Users.
Messages at sign-in
| What you see | Cause and fix |
|---|---|
| Single sign-on isn't available for this sign-in. Sign in with your password or contact your administrator. | The sign-in could not go ahead with single sign-on, for example because the provider has no email domain mapped to it, so it is not offered. Add the domain under Domain routing. Until then, people sign in with their password. |
| No SSO button after entering an email | The domain is not mapped, is mapped to a different provider, or the provider is disabled. Check the Domain routing card and the provider badge. |
| No account found for this email address. Please contact your administrator. | The sign-in at your provider worked but there is no Recruit user with that email. Add or invite the user in Settings then Users, and check the email matches exactly. |
| Login failed, or "Something went wrong. Please try again." | Your provider rejected the request or Recruit could not complete it. Check the client ID and client secret (an expired or regenerated secret is the usual cause), the issuer URL, and that the redirect address registered in your provider is the one HireRoad gave you. Edit the provider to correct any of these. |
| You must sign in with single sign-on | Enforcement is on and the person tried a password. They should choose Continue with your provider. |
| Your organisation requires single sign-on, but no provider is configured. Contact your administrator. | Enforcement is on but the provider is disabled or missing. Enable a provider or turn enforcement off. See "Enforcing single sign-on and managing providers". |
Messages when you change settings
| What you see | Cause and fix |
|---|---|
| Failed to save the SSO provider. Please try again. | The provider could not be created or updated. Check the issuer URL is correct and reachable, then try again. If it keeps failing, contact HireRoad support. |
| Failed to delete the SSO provider, Failed to update SSO enforcement, or Failed to add the domain mapping | The change did not save. Try again, and contact HireRoad support if it repeats. |
| The Single sign-on cards are missing | Only System Admins see them on the Security page. Other roles cannot open the page. |