Chalk implements SCIM in order to allow external
identity providers (IDPs) to automatically provision and
deprovision users as they are added and removed from
the external identity provider.
- IDP-initiated user provisioning
- IDP-initiated user deprovisioning
- IDP-managed group assignment
This guide assumes that an SAML application has been already set up for Chalk.
To view the base setup steps, see the Chalk documentation for Entra ID SAML.
- Open the Projects page in the Chalk dashboard. You can also get there
by clicking the Chalk logo in the top left of the page.
- In the team navigation, select Single Sign-On, then open the SCIM (access control) tab.
- Click Generate SCIM token and store the token securely. Generating the first token enables SCIM for your team.
- Copy the SCIM Connector Base URL.
The base URL is https://api.chalk.ai/scim/v2 for Chalk-hosted deployments. For an air-gapped
deployment, use the URL shown in your dashboard.
- Open the Entra ID admin dashboard and find or create your application.
- In your application, open the provisioning tab and click Connect Your Application.
- Configure SCIM with the following settings.
- Authentication Method: Bearer authentication
- Tenant URL: The SCIM Connector Base URL you copied from Chalk
- Secret token: The SCIM token you generated in Chalk
- Navigate to Attribute mapping in the provisioning sidebar.
- Add attribute mappings for users. The following attributes are supported:
- userName: Use your preferred email attribute
- active
- displayName
- title
- name.givenName
- name.familyName
- Add attribute mappings for groups. The following attributes are supported:
- displayName
- members
- If group syncs do not work as expected, it is potentially due to invalid attribute mappings and recommended to delete
mappings down to just these two.
