JumpCloud Setup

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

Configure SAML on GitBook

On GitBook, you will need to upload the public certificate and fill in the following information:‌

  • Provider Label: Label that will prompt the users to sign in

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

  • Identity Provider Issuer: This ID is a case-sensitive unique 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

​‌ Set up SAML on JumpCloud

Log into the JumpCloud Administrator console.

Select the Applications tab on the side menu.

Then, 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:‌

🧙♂ Tips: The IdP ENTITY ID should match the value that you set on GitBook for the identity provider issuer.‌

📥 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 up in the first step.‌

Select Save and your GitBook SSO setup is now complete! 🎉