Skip to content
Dashboard
Theme
Theme

JumpCloud SAML single sign-on

Set up SAML single sign-on with JumpCloud

View Markdown

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.

The values in braces, such as {sp_entity_id}, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.

  1. In the JumpCloud Admin Portal, open SSO Applications, add a new application, choose a custom SAML application and give it a display name.

  2. On the SSO tab, enter an IdP entity ID that is unique to this app, and paste {sp_entity_id} into SP Entity ID.

    Paste into JumpCloud:

    • SP entity ID: {sp_entity_id}

    Fixes: saml_audience_mismatch, saml_issuer_mismatch

  3. Paste {acs_url} into the ACS URL field.

    Paste into JumpCloud:

    • ACS URL: {acs_url}

    Fixes: saml_destination_mismatch, saml_response_malformed

  4. Set the SAML subject name ID to the user’s email and its format to email address.

    Fixes: saml_nameid_missing

  5. Sign the assertion (or the response) and set the signature algorithm to RSA-SHA256.

    Fixes: saml_signature_missing, saml_signature_algorithm_weak

  6. Add user attributes named email, firstName and lastName mapped to the user’s email, first name and last name.

    Fixes: saml_email_missing

  7. On the app’s user groups tab, bind the groups whose members should sign in with single sign-on, then activate or save the app.

    Fixes: saml_idp_status_error

  8. Export the app’s metadata (or download its IdP certificate) and add it to this setup. Do this again whenever the certificate changes.

    Fixes: saml_signature_invalid

  9. Run a test sign-in in this setup, signing in as a member of a bound group.

If our main network ever has an outage, sign-ins can continue through a standby address, but only if JumpCloud accepts it. If the app lets you add more than one ACS URL, add {standby_acs_url} as the second one and keep {acs_url} as the default. If it allows only one, skip this step. Then confirm in this setup that you added it.

Paste into JumpCloud:

  • Standby ACS URL: {standby_acs_url}
  • ACS URL: {acs_url}

This step is optional. See standby route behavior for what the standby address does during an outage.