- Generate a public certificate and private key pair.
- The Service Provider requires an administrator account to configure SAML.
- How to configure User authorization.
Configure the JumpCloud SSO Application
- Access the JumpCloud Administrator Console at https://console.jumpcloud.com.
- Select Applications in the main navigation panel.
- Select the + in the upper left, scroll or search for the application in the 'Configure New Application' side panel, then select 'configure'.
- You can upload a service provider application's XML metadata file to populate SAML connector attributes for that application. The attributes populated by the metadata file may vary by the application. To apply a metadata file for the application you're connecting, click Upload Metadata. Navigate to the file you want to upload, then click Open. You'll see a confirmation of a successful upload. Be aware that if you upload more than one metadata file, you'll overwrite the attribute values applied in the previously uploaded file.
- In the IDP Entity ID field, enter
- Select Upload IdP Private Key and upload the private.pem file generated according to the above prerequisites.
- Select Upload IdP Certificate and upload the cert.pem file generated according to the above prerequisites.
- In the Default Relay State field, copy the 'Relay State' value from the Service Provider and paste it into the field (See the Configure Service Provider instructions below for further information).
- In the field terminating the IdP URL, either leave the default value or enter a plaintext string unique to this connector.
- (Optional) In the Display Label field, enter a label that will appear under the Service Provider logo within the JumpCloud User console.
- Select Activate.
- Re-open the application and select Export Metadata on the bottom bar and save it to your computer (See the Configure Service Provider instructions below for further information).
Configure the Service Provider
- In the Service Provider's console, select the user icon in the upper right-hand corner.
- Select Settings from the drop-down menu
- Select Identity Providers from the sidebar.
- Copy the Relay State value and paste it into the JumpCloud console configuration.
- Select Browse and upload the metadata document that was exported in the previous steps.
- Select Save
Validate SSO authentication workflows
- Access the JumpCloud User Console at https://console.jumpcloud.com.
- Select the Service Provider icon.
- This should automatically launch and login to the application.
- Navigate to your Service Provider application URL.
- You will be redirected to log in to the JumpCloud User Portal.
- The browser will be redirected back to the application and be automatically logged in.