Setup guides for JumpCloud. IT administrators see the same steps, with their own values filled in, in the setup link they receive.
- Set up SCIM directory sync with JumpCloud: Turn on identity management with SCIM for your JumpCloud application, connect it with the URL and token from this setup and bind the groups to sync.
- Set up SAML single sign-on with JumpCloud: Add a custom SAML application in JumpCloud, paste the values from this setup, bind your user groups and share the app’s metadata with us.
Connection Doctor fixes
Section titled “Connection Doctor fixes”Connection Doctor shows these steps when a test or sign-in through JumpCloud fails. Codes without their own JumpCloud steps use the generic fixes. Values in braces are filled in with the connection’s own settings in the dashboard and portal.
Fix for oidc_email_missing
Section titled “Fix for oidc_email_missing”The identity provider did not release the user’s email claim.
- In JumpCloud, open the OIDC application and add the email scope/attribute.
See the oidc_email_missing error reference.
Fix for oidc_idp_error
Section titled “Fix for oidc_idp_error”The identity provider returned an error to the sign-in callback instead of signing the user in (most often the user is not assigned to the application, or canceled).
- In JumpCloud, open SSO Applications > the OIDC application > User Groups and bind a group that contains the user, then retry.
See the oidc_idp_error error reference.
Fix for oidc_token_exchange_failed
Section titled “Fix for oidc_token_exchange_failed”The identity provider refused to exchange the sign-in code (often a wrong client secret or redirect URI).
- In JumpCloud, open the OIDC application and add
{redirect_uri}to Redirect URIs; regenerate the client secret if needed.
See the oidc_token_exchange_failed error reference.
Fix for saml_audience_mismatch
Section titled “Fix for saml_audience_mismatch”The identity provider uses a different SP Entity ID (Audience) than this connection’s.
- In JumpCloud, open the SSO application and set SP Entity ID to
{sp_entity_id}.
See the saml_audience_mismatch error reference.
Fix for saml_destination_mismatch
Section titled “Fix for saml_destination_mismatch”The identity provider sends the response to a different address than this connection’s.
- In JumpCloud, open the SSO application and set ACS URLs to
{acs_url}.
See the saml_destination_mismatch error reference.
Fix for saml_email_missing
Section titled “Fix for saml_email_missing”The response does not include the user’s email address.
- In JumpCloud, open the SSO application > Attributes and add Service Provider Attribute Name email mapped to JumpCloud Attribute email.
See the saml_email_missing error reference.
Fix for saml_idp_status_error
Section titled “Fix for saml_idp_status_error”The identity provider refused the sign-in before sending an assertion.
- In the JumpCloud Admin Portal, open the SSO application > User Groups and bind the user’s group.
See the saml_idp_status_error error reference.
Fix for saml_issuer_mismatch
Section titled “Fix for saml_issuer_mismatch”The response comes from a different identity provider (issuer) than the one configured here.
- In JumpCloud, check the SSO application’s IdP Entity ID and upload its exported metadata here.
See the saml_issuer_mismatch error reference.
Fix for saml_nameid_missing
Section titled “Fix for saml_nameid_missing”The response has no user identifier (NameID).
- In JumpCloud, open the SSO application and set SAMLSubject NameID (for example email).
See the saml_nameid_missing error reference.
Fix for saml_signature_algorithm_weak
Section titled “Fix for saml_signature_algorithm_weak”The response is signed with SHA-1, which is not accepted.
- In JumpCloud, open the SSO application and set Signature Algorithm to RSA-SHA256.
See the saml_signature_algorithm_weak error reference.
Fix for saml_signature_invalid
Section titled “Fix for saml_signature_invalid”The signature does not match the identity provider certificate we have on file (often after a certificate change).
- In JumpCloud, open the SSO application > IDP Certificate and download it (or Export Metadata), then upload it here.
See the saml_signature_invalid error reference.
Fix for saml_signature_missing
Section titled “Fix for saml_signature_missing”The SAML response or assertion is not signed.
- In JumpCloud, open the SSO application and enable Sign Assertion (or Sign Response).