JumpCloud Setup

You will need to generate a certificate to setup the SSO integration with Jumpclound. You can check how to generate one on their website.

On GitBook, you will need to upload the public certificate and fill the following informations:

  • Provider Label: Label that will prompted to the users on sign in

  • SAML SSO URL: The URL used for the SAML, you need to use the same URL that you set on JumpCloud (you can use https://sso.jumpcloud.com/saml2/gitbook if you follow this guide)

  • Identity Provider Issuer: This ID is a unique, case-sensitive identifier used by JumpCloud for this Service Provider (SP). Your domain name, SSO Connect server name or IP address are possible examples.

  • Public certificate: Upload your public certificate generated previously

Log into the JumpCloud Administrator console.

Select the Applications tab on the side menu.

Next, select the + icon in the upper left corner.

Search for SAML in the application list search bar. Select Configure.

Next, on SAML Application connector page, enter the IDP ENTITY ID:

The IDP ENTITY ID should match the value that you set on GitBook for the identity provider issuer.

Next, Upload the IdP Private Key (private.pem file) and IDP Certificate (cert.pem file).

In the SP Entity ID field, enter the value found in the Entity ID field of the Service Provider Section from GitBook SSO settings. In the ACS URL field, enter the value found in the ACS URL field from GitBook SSO Settings.

Ensure that the SAML format matches the one that GitBook uses:

In the field terminating the IdP URL, enter a plaintext string unique to this connector. It needs to match the URL that you set on the first step.

Select Save and Your GitBook SSO setup is now complete!