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.
-
Add a custom SAML application
Section titled “Add a custom SAML application”In the JumpCloud Admin Portal, open SSO Applications, add a new application, choose a custom SAML application and give it a display name.
-
Enter the entity IDs
Section titled “Enter the entity IDs”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}
- SP entity ID:
-
Enter the ACS URL
Section titled “Enter the ACS URL”Paste
{acs_url}into the ACS URL field.Paste into JumpCloud:
- ACS URL:
{acs_url}
- ACS URL:
-
Send the email address as the name ID
Section titled “Send the email address as the name ID”Set the SAML subject name ID to the user’s email and its format to email address.
Fixes:
saml_nameid_missing -
Check the signing settings
Section titled “Check the signing settings”Sign the assertion (or the response) and set the signature algorithm to RSA-SHA256.
Fixes:
saml_signature_missing,saml_signature_algorithm_weak -
Add the attributes
Section titled “Add the attributes”Add user attributes named email, firstName and lastName mapped to the user’s email, first name and last name.
Fixes:
saml_email_missing -
Bind your user groups
Section titled “Bind your user groups”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 -
Share the identity provider metadata
Section titled “Share the identity provider metadata”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 -
Test the connection
Section titled “Test the connection”Run a test sign-in in this setup, signing in as a member of a bound group.
Optional: add the standby ACS URL
Section titled “Optional: add the standby ACS URL”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.
Sources
Section titled “Sources”- Single sign-on (SSO) with SAML 2.0 (JumpCloud Support), read on 2026-10-11