WorkOS Docs Homepage

JumpCloud SAML

Learn how to configure a connection to JumpCloud via SAML.

Each SSO Identity Provider requires specific information to create and configure a new Connection. Often, the information required to create a Connection will differ by Identity Provider.

To create a JumpCloud SAML Connection, you’ll need to upload a JumpCloud Metadata file.

WorkOS provides the ACS URL and SP Entity ID. They’re readily available in your Connection Settings in the WorkOS Dashboard.

A screenshot of the "Service Provider Details" of a JumpCloud Connection in the WorkOS Dashboard.

The ACS URL is the location an Identity Provider redirects its authentication response to. In JumpCloud’s case, the ACS URL and Entity ID need to be set by the Enterprise when configuring your application in their JumpCloud instance.

Specifically, the ACS URL and Entity ID will need to be set in the “Single Sign-On Configuration” section of the SAML app. You will input the ACS URL for “ACS URL” and the Entity ID as both “IdP Entity ID” and “SP Entity ID”:

A screenshot highlighting the fields "IdP Entity ID", "SP Entity ID" and "ACS URL" in the JumpCloud dashboard.

In order to integrate you’ll need the JumpCloud Metadata file. Here’s how to obtain it:

Log in to the JumpCloud admin dashboard, select “SSO” on the left and select your Application.

A screenshot highlighting the SSO tab and app selection in the JumpCloud dashboard.

In the “User Attributes” section of the Single Sign-On Configuration page for the SAML app, add the following field-value parameter pairs:

  • id → email
  • email → email
  • firstName → firstname
  • lastName → lastname
A screenshot showing user attribute mapping in the JumpCloud dashboard.

IMPORTANT: Be sure to check the “Sign Assertion” box.

A screenshot highlighting the checked "Sign Assertion" box in the JumpCloud dashboard.

Be sure to check “Declare Redirect Endpoint”.

A screenshot highlighting the checked "Declare Redirect Endpoint" box in the JumpCloud dashboard.

Click the “Export Metadata” button under “JumpCloud Metadata”. This will download an XML metadata file.

A screenshot highlighting the "Export Metadata" button in the JumpCloud dashboard.

In the Connection Settings of the WorkOS Dashboard, click “Edit Metadata Configuration”.

A screenshot highlighting the "Edit Metadata Configuration" button in the WorkOS Dashboard.

In the modal that pops up, upload the JumpCloud Metadata file and then select “Save Metadata Configuration”.

A screenshot showing the "XML File Metadata Configuration" modal in the WorkOS Dashboard.

Once the file has uploaded, your Connection will then be linked and good to go!