mirror of
https://github.com/hanzoai/kms.git
synced 2026-10-17 11:18:16 +00:00
- Fix 381 files where branding script corrupted variable names (e.g. isHanzo KMSTemplate -> isKmsTemplate) - Rebrand from "Hanzo KMS" to just "KMS" for white-label support (allows Lux KMS, Hanzo KMS, etc. via configuration) - 856 files, purely string replacements, no logic changes
64 lines
3.1 KiB
Plaintext
64 lines
3.1 KiB
Plaintext
---
|
|
title: "JumpCloud SCIM"
|
|
description: "Learn how to configure SCIM provisioning with JumpCloud for KMS."
|
|
---
|
|
|
|
<Info>
|
|
JumpCloud SCIM provisioning is a paid feature.
|
|
|
|
If you're using KMS Cloud, then it is available under the **Enterprise Tier**. If you're self-hosting KMS,
|
|
then you should contact [email protected] to purchase an enterprise license to use it.
|
|
</Info>
|
|
|
|
Prerequisites:
|
|
- [Configure JumpCloud SAML for KMS](/documentation/platform/sso/jumpcloud)
|
|
|
|
<Steps>
|
|
<Step title="Create a SCIM token in KMS">
|
|
In KMS, head to the **Single Sign-On (SSO)** page and select the **Provisioning** tab. Under SCIM Configuration,
|
|
press the **Enable SCIM provisioning** toggle to allow JumpCloud to provision/deprovision users and user groups for your organization.
|
|
|
|

|
|
|
|
Next, press **Manage SCIM Tokens** and then **Create** to generate a SCIM token for JumpCloud.
|
|
|
|

|
|
|
|
Next, copy the **SCIM URL** and **New SCIM Token** to use when configuring SCIM in JumpCloud.
|
|
|
|

|
|
</Step>
|
|
<Step title="Configure SCIM in JumpCloud">
|
|
In JumpCloud, head to your Application > Identity Management > Configuration settings and make sure that
|
|
**API Type** is set to **SCIM API** and **SCIM Version** is set to **SCIM 2.0**.
|
|
|
|

|
|
|
|
Next, set the following SCIM connection fields:
|
|
|
|
- Base URL: Input the **SCIM URL** from Step 1.
|
|
- Token Key: Input the **New SCIM Token** from Step 1.
|
|
- Test User Email: Input a test user email to be used by JumpCloud for testing the SCIM connection.
|
|
|
|
Alos, under HTTP Header > Authorization: Bearer, input the **New SCIM Token** from Step 1.
|
|
|
|

|
|
|
|
Next, press **Test Connection** to check that SCIM is configured properly. Finally, press **Activate**
|
|
to have JumpCloud start provisioning/deprovisioning users to KMS.
|
|
|
|

|
|
|
|
Now JumpCloud can provision/deprovision users and user groups to/from your organization in KMS.
|
|
</Step>
|
|
</Steps>
|
|
|
|
**FAQ**
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="Why do SCIM-provisioned users have to finish setting up their account?">
|
|
KMS's SCIM implmentation accounts for retaining the end-to-end encrypted architecture of KMS because we decouple the **authentication** and **decryption** steps in the platform.
|
|
|
|
For this reason, SCIM-provisioned users are initialized but must finish setting up their account when logging in the first time by creating a master encryption/decryption key. With this implementation, IdPs and SCIM providers cannot and will not have access to the decryption key needed to decrypt your secrets.
|
|
</Accordion>
|
|
</AccordionGroup> |