> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Single Sign-On with JumpCloud (SAML)

> Configure SAML-based SSO between JumpCloud and Iru Endpoint. Create the SAML application in JumpCloud and map user attributes for admin authentication.

### About JumpCloud SAML Integration

JumpCloud SAML integration in Iru Endpoint lets you set up SAML-based SSO integration with JumpCloud for users accessing Iru Endpoint through their JumpCloud credentials.

#### How It Works

When users attempt to access Iru Endpoint, they're redirected to JumpCloud for authentication. After successful authentication, JumpCloud sends a SAML assertion back to Iru Endpoint, which validates the user's identity and grants access. SSO can be used for [Iru Endpoint Web App](/en/endpoint/getting-started/foundation/admins-and-access) sign-in and for [Require Authentication with Automated Device Enrollment](/en/endpoint/enrollment/configure-require-authentication-for-enrollment).

<Tabs>
  <Tab title="Iru Web App Configuration">
    ### Setting Up the SAML Connection

    <Note>
      You'll need to complete the initial setup in Iru Endpoint first to get the configuration information required for JumpCloud. After copying the Entity ID and ACS URL, switch to the [**JumpCloud Application Configuration**](#jumpcloud-application-configuration) tab and continue with [**Configuring JumpCloud Application**](#configuring-jumpcloud-application).
    </Note>

    <Steps>
      <Step title="Navigate to the Account Menu Button">
        In Iru Endpoint, in the sidebar, click the [**Account Menu Button**](/en/iru/platform-overview/account-menu).
      </Step>

      <Step title="Access Authentication Settings">
        Click the **Access** option in the menu.

        <Frame>
          <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-access.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=466fdf5fb47efd6bab8b450a5a1e8302" alt="Screenshot of the account menu with Access option highlighted" width="562" height="1040" data-path="assets/media/images/iru-nav-access.png" />
        </Frame>
      </Step>

      <Step title="Select Admin and Authentication">
        Select the **Admin and authentication** tab (selected by default) and scroll down to **Authentication methods**.
      </Step>

      <Step title="Add Authentication Method">
        Click **+ Authentication method**.
      </Step>

      <Step title="Enter Display Name">
        Enter a display name for the SSO Connection.
      </Step>

      <Step title="Select Authentication Method">
        Select **SAML** for the Authentication method.
      </Step>

      <Step title="Create Connection">
        Click **Create**.
      </Step>

      <Step title="Configuration Information">
        Click **Configuration information** if that section is not already expanded.
      </Step>

      <Step title="Copy Service Provider Entity ID">
        Copy the **Service provider entity ID** into a text document for later use. You'll need this for the JumpCloud configuration.
      </Step>

      <Step title="Copy ACS URL">
        Copy the **Assertion consumer service (ACS) URL** into a text document for later use. You'll need this for the JumpCloud configuration.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_11-08-26.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=7d56d5b22f71fb05dd59c83555c02430" alt="Configuration Information, Service provider entity ID, and Assertion consumer service (ACS) URL" width="2166" height="940" data-path="assets/media/images/iru-support-google-saml_11-08-26.png" />
        </Frame>
      </Step>

      <Step title="Keep Tab Open">
        Keep the Iru Endpoint configuration modal open, then switch to the [**JumpCloud Application Configuration**](#jumpcloud-application-configuration) tab to continue with [**Configuring JumpCloud Application**](#configuring-jumpcloud-application).
      </Step>
    </Steps>

    ### Configuring Iru Endpoint SAML Connection

    <Note>
      After completing the JumpCloud Application Configuration, return here to finish [**Configuring Iru Endpoint SAML Connection**](#configuring-iru-endpoint-saml-connection) in Iru Endpoint. You'll need the Sign-in URL, IdP Entity ID, and certificate from JumpCloud.
    </Note>

    <Steps>
      <Step title="Return to Iru Endpoint">
        Go back to the Custom SAML modal in Iru Endpoint.
      </Step>

      <Step title="Configure IdP Attribute">
        Keep the **IdP attribute** setting as **Subject**.
      </Step>

      <Step title="Configure Attribute Name">
        Leave the **Attribute name** blank.
      </Step>

      <Step title="Configure User Attributes">
        Set **User attribute** to **User Principal Name (UPN)**.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_16-30-02.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=2930827accee0a59fec9a95d0d0e229f" alt="Iru Endpoint User attribute set to User Principal Name UPN" width="1430" height="652" data-path="assets/media/images/jumpcloud-saml_16-30-02.png" />
        </Frame>
      </Step>

      <Step title="Add IdP Entity ID">
        Paste the unique **IdP Entity ID** you created earlier in JumpCloud into the **IdP Entity ID** field in Iru Endpoint.
      </Step>

      <Step title="Add Sign-in URL">
        Paste in the **Sign-in URL** you copied from JumpCloud: [https://sso.jumpcloud.com/saml2/iru](https://sso.jumpcloud.com/saml2/iru).
      </Step>

      <Step title="Upload Certificate">
        Upload the **certificate** you downloaded from JumpCloud.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_16-36-10.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=0ea6278256adeaad609bd62437d01a53" alt="Iru Endpoint upload certificate from JumpCloud" width="1428" height="960" data-path="assets/media/images/jumpcloud-saml_16-36-10.png" />
        </Frame>
      </Step>

      <Step title="Set Request Binding">
        Set the **Request Binding** to **HTTP-POST**.
      </Step>

      <Step title="Set Request Signature Algorithm">
        Ensure that **Request Signature Algorithm** is set to **RSA-SHA256**.
      </Step>

      <Step title="Set Request Digest Algorithm">
        Ensure that **Request Digest Algorithm** is set to **SHA256**.
      </Step>

      <Step title="Enable Request Signing">
        Ensure that **Sign SAML Authentication Request** is enabled.

        <Frame>
          <img src="https://mintcdn.com/iru/oTTnm7ow-OS4GUo-/assets/media/images/jumpcloud-saml_16-38-11.png?fit=max&auto=format&n=oTTnm7ow-OS4GUo-&q=85&s=06715218d2f70099cc56b97e0e00f680" alt="Iru Endpoint Sign SAML Authentication Request enabled" width="1426" height="744" data-path="assets/media/images/jumpcloud-saml_16-38-11.png" />
        </Frame>
      </Step>

      <Step title="Set Response Signature Verification">
        Set **Response Signature Verification** to **Assertion**.
      </Step>

      <Step title="Set Destination">
        Leave the optional **Destination** blank.
      </Step>

      <Step title="Set Allowed Signature Algorithm">
        Set **Allowed Signature Algorithm** to **RSA-SHA256**.
      </Step>

      <Step title="Set Allowed Digest Algorithm">
        Set **Allowed Digest Algorithm** to **SHA-256**.
      </Step>

      <Step title="Save Configuration">
        Click **Save**.

        <Frame>
          <img src="https://mintcdn.com/iru/oTTnm7ow-OS4GUo-/assets/media/images/jumpcloud-saml_16-44-23.png?fit=max&auto=format&n=oTTnm7ow-OS4GUo-&q=85&s=68fd7c47e1bd1da4f940d962f5ba82de" alt="Iru Endpoint Save for SAML configuration" width="1424" height="820" data-path="assets/media/images/jumpcloud-saml_16-44-23.png" />
        </Frame>
      </Step>
    </Steps>

    ### Allow for Tenant Authentication

    Once you have configured the SAML connection in Iru Endpoint and your identity provider, you can allow its use for tenant authentication. For step-by-step instructions, please refer to the **Allowing Tenant Authentication and Managing Connections** section in our [Single Sign-on support article](/en/endpoint/integrations/single-sign-on-integrations/single-sign-on).

    ### Limit Authentication to Domain

    When configuring the SAML connection, you can optionally limit authentication to one or more domains. This can be useful when the SSO connection could authenticate to multiple domains. You can limit the authentication to your Iru tenant to a subset of the available domains.

    ### Enforcing Single Sign-On

    Once you have configured at least one Single Sign-on connection, you can disable Passkey, Google Social, and Microsoft Social connections. Disabling these connections will disable the ability for Iru Endpoint administrators in your tenant to authenticate via those methods. Please refer to our [Single Sign-on support article](/en/endpoint/integrations/single-sign-on-integrations/single-sign-on) for step-by-step instructions.

    ### Testing the Integration

    <Steps>
      <Step title="Add User to Admin Team">
        Add a user to the **Admin Team** in Iru Endpoint by clicking **New User**.
      </Step>

      <Step title="Fill User Information">
        Fill in all of the corresponding user information. This user must exist in JumpCloud and must be assigned to the Iru Endpoint SSO app in your JumpCloud tenant.
      </Step>

      <Step title="Submit User">
        Click **Submit**.
      </Step>

      <Step title="Close Invite Window">
        Once the invite is submitted, close the Invite User window.
      </Step>

      <Step title="Refresh Access Page">
        Refresh the Access page in Iru Endpoint. You should see the user you just added.
      </Step>

      <Step title="Test SSO Login">
        Check the user's email to accept the invitation and log into Iru Endpoint with the new SAML SSO connection.
      </Step>
    </Steps>

    ## Considerations

    **Security**: Ensure that your JumpCloud tenant has appropriate security policies configured for SAML authentication.

    **User Management**: Users must exist in both JumpCloud and Iru Endpoint to successfully authenticate via SSO.

    **Testing**: Always test the SSO integration with a small group of users before rolling out to your entire organization.

    **Certificate Management**: Keep track of certificate expiration dates and ensure timely renewal to maintain SSO functionality.
  </Tab>

  <Tab title="JumpCloud Application Configuration">
    <Note>
      Before starting the JumpCloud configuration, complete [**Setting Up the SAML Connection**](#setting-up-the-saml-connection) in the [**Iru Web App Configuration**](#iru-web-app-configuration) tab to get the Service Provider Entity ID and ACS URL. You'll need these values to configure the JumpCloud application.
    </Note>

    ### Configuring JumpCloud Application

    <Steps>
      <Step title="Access JumpCloud Console">
        Log in to the [JumpCloud Admin Portal](https://console.jumpcloud.com/login/admin).
      </Step>

      <Step title="Select SSO Applications">
        In the lefthand navigation bar's **Access** section, select **SSO Applications**.

        <Frame>
          <img src="https://mintcdn.com/iru/oTTnm7ow-OS4GUo-/assets/media/images/jumpcloud-saml_5-21-55.png?fit=max&auto=format&n=oTTnm7ow-OS4GUo-&q=85&s=f7708ec0e1ae7e3f5dcaec6428b5fc74" alt="JumpCloud Access SSO Applications" width="2578" height="1218" data-path="assets/media/images/jumpcloud-saml_5-21-55.png" />
        </Frame>
      </Step>

      <Step title="Create New Application">
        Click on the **+ Add New Application** button, or, if this is your first application, click **Get Started**.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-28-24.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=968171b48028f5cd1184cdc9304fa8f4" alt="JumpCloud Add New Application or Get Started" width="2640" height="1332" data-path="assets/media/images/jumpcloud-saml_15-28-24.png" />
        </Frame>
      </Step>

      <Step title="Select Custom Application">
        At the bottom of the screen, click **Select** in the Custom Application tile.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-33-34.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=dc8dff89a3338d1727068b7b43fbad96" alt="JumpCloud Custom Application Select" width="2208" height="1920" data-path="assets/media/images/jumpcloud-saml_15-33-34.png" />
        </Frame>
      </Step>

      <Step title="Click Next">
        Click **Next**.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-35-33.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=e7bad43912d016318135ec2f29e2ec96" alt="JumpCloud Next" width="2296" height="1318" data-path="assets/media/images/jumpcloud-saml_15-35-33.png" />
        </Frame>
      </Step>

      <Step title="Configure SSO Options">
        Select **Manage Single Sign-On (SSO)**.
      </Step>

      <Step title="Select Configure SSO with SAML">
        Select **Configure SSO with SAML**.
      </Step>

      <Step title="Continue Setup">
        Click **Next**.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-37-06.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=bfdc004631fb375a88bc5d5bd3f9eec5" alt="JumpCloud Manage SSO Configure SSO with SAML Next" width="2208" height="1978" data-path="assets/media/images/jumpcloud-saml_15-37-06.png" />
        </Frame>
      </Step>

      <Step title="Configure General Information">
        On the **Enter** **General Info** tab:

        1. Add a name for the **Display Label**.
        2. Add a **Description** if desired.
        3. Choose either a color Indicator or upload a logo for the **Display Portal Image**.
        4. Optionally, choose to show the application in the User Portal.
        5. Expand the disclosure triangle beside **Advanced Settings**.
        6. In the **SSO IdP URL** field, enter **iru**. The full URL should read [https://sso.jumpcloud.com/saml2/iru](https://sso.jumpcloud.com/saml2/iru).
        7. Click **Save Application**.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-41-18.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=e67cf0dd5522297d4ae042b701f23eba" alt="JumpCloud General Info Display Label SSO IdP URL iru Save Application" width="2206" height="2056" data-path="assets/media/images/jumpcloud-saml_15-41-18.png" />
        </Frame>
      </Step>

      <Step title="Configure Application">
        After your application is saved, click **Configure Application**.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-48-22.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=e53e69d74b3e62bb5c7cdbbac8cafe31" alt="JumpCloud Configure Application" width="2300" height="1476" data-path="assets/media/images/jumpcloud-saml_15-48-22.png" />
        </Frame>
      </Step>

      <Step title="Configure SSO Settings">
        On the **SSO** tab of the configuration modal:

        1. For the **IdP Entity ID**, create a unique Entity ID (e.g. `iru-saml-jumpcloud`) and enter it in the **IdP Entity ID** field. Save this unique IdP Entity ID for use in Iru Endpoint later.
        2. Copy the **Entity ID** from Iru Endpoint that you saved earlier and paste it into the **SP Entity ID** field in JumpCloud only (do not paste it into the IdP Entity ID field).

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-52-36.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=827bcbe6ba57a72a3bbd16f2708b11af" alt="JumpCloud SSO tab IdP Entity ID and SP Entity ID" width="2620" height="2340" data-path="assets/media/images/jumpcloud-saml_15-52-36.png" />
        </Frame>

        3. Copy the **Assertion Consumer Service URL** from Iru Endpoint that you saved earlier and paste it into the **ACS URL** field.
        4. Leave the **SAML Subject NameID** set to **email**.
        5. In the **SAML Subject NameID-Format** field, select **urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress** from the dropdown menu.
        6. Set the **Signature Algorithm** to **RSA-SHA256**.
        7. Select **Assertion** in the **Sign** section.
        8. Ensure the **IDP URL** is [https://sso.jumpcloud.com/saml2/iru](https://sso.jumpcloud.com/saml2/iru). If it is not, you will need to delete the integration and create a new one. Copy this URL and save it for use in Iru Endpoint later.
        9. Click **Save**.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-59-45.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=3c89fa68a4b6c780615b4fed7529f077" alt="JumpCloud SSO tab ACS URL NameID Signature Assertion Save" width="2592" height="2674" data-path="assets/media/images/jumpcloud-saml_15-59-45.png" />
        </Frame>
      </Step>

      <Step title="Open Action Menu">
        Click **Action** at the top right.
      </Step>

      <Step title="Download Certificate">
        Click **Download Certificate**. It will be used in Iru Endpoint later.
      </Step>

      <Step title="Click User Groups">
        Click on the **User Groups** tab.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_16-13-53.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=db07abcec2abee78fd6b1161797e1e5f" alt="JumpCloud User Groups tab" width="2674" height="1612" data-path="assets/media/images/jumpcloud-saml_16-13-53.png" />
        </Frame>
      </Step>

      <Step title="Assign User Groups">
        Add a user group to the SSO application. If you want to restrict who can access the SSO app, create another user group in your JumpCloud console and assign it to the SSO app.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_16-20-10.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=d3aef115251eafd5d5e3403a3c9ce010" alt="JumpCloud assign user group to SSO application" width="2342" height="1296" data-path="assets/media/images/jumpcloud-saml_16-20-10.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      After completing the JumpCloud Application Configuration, return to the **Iru Web App Configuration** tab to finish setting up the SAML connection using the Single Sign-on URL, IdP Entity ID, and certificate you copied from JumpCloud.
    </Note>
  </Tab>
</Tabs>
