Introduction
If you see an SSO authentication error in Click Boarding, it usually means there is an issue with your Single Sign-On credentials or configuration. SSO is managed by your IT Team, and Click Boarding does not have access to your SSO settings. In most cases, the first step is to verify that you are using the correct login URL. If the error continues after confirming the URL, contact your IT Team for assistance.
What the SSO error means
An SSO error indicates that Click Boarding could not authenticate your SSO login. This may happen if the login link is incorrect, the application name is entered incorrectly, the subdomain is missing, or there is an issue with your organization's SSO configuration. Because SSO is administered by your IT Team, Click Boarding Support cannot review or change your SSO setup.
Verify you are using the correct login URL
Click Boarding uses a single point of authentication called the Identity application. To sign in successfully, make sure you are using the correct root URL, login path, and query parameters for your environment.
Root URLs
| Environment | Root URL |
|---|---|
| Production | https://sso.clickboarding.com |
| UAT | https://sso.clickboardinguat.com |
Login path and parameters
The login path is /Login and must be added to the root URL. Two query parameters are required: App and Sub. The full format is: https://sso.clickboarding.com/Login?App=[appName]&Sub=[clientSubdomain]
Use the correct App value for the type of user signing in:
- App=Admin for Admin users
- App=Candidate for Employee or Candidate users
- App=ClickHub for Click Hub
If your organization uses SSO or is in a single tenant environment, you must include your unique subdomain in the Sub parameter. If you do not have a unique subdomain, use Sub=click. Click Hub does not use a subdomain query parameter.
Examples
| Use case | Example URL |
|---|---|
| Admin UAT with unique subdomain abc | https://sso.clickboardinguat.com/Login?App=admin&sub=abc |
| Employee or Candidate Production with no unique subdomain | https://sso.clickboarding.com/Login?App=candidate&sub=click |
| Click Hub Production | https://sso.clickboarding.com/Login?App=ClickHub |
Basic troubleshooting steps
Use this checklist to confirm the most common causes of SSO authentication errors before contacting your IT Team.
- Confirm you are using the correct environment URL for Production or UAT.
- Make sure the login path includes /Login.
- Verify the App parameter matches your login type: Admin, Candidate, or ClickHub.
- Check that the Sub parameter is included when your organization has a unique subdomain.
- If you do not have a unique subdomain, confirm that Sub=click is being used.
- If you are using Click Hub, confirm that no subdomain parameter is added.
If the issue continues
If you have confirmed that you are using the correct login URL and you still receive an SSO authentication error, the issue is likely related to your organization's SSO configuration or credentials. Please contact your IT Team to review and resolve the issue. Click Boarding cannot access or modify SSO settings.
Additional information
For more information about signing in, see the Authenticating in Click Boarding article in the Help Center.
Comments
0 comments
Please sign in to leave a comment.