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.


​
Supported Features

  • IDP-initiated user provisioning
  • IDP-initiated user deprovisioning
  • IDP-managed group assignment

​
Setup Steps

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.

​
Set up SCIM in Chalk

  1. 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.
  2. In the team navigation, select Single Sign-On, then open the SCIM (access control) tab.
  3. Click Generate SCIM token and store the token securely. Generating the first token enables SCIM for your team.
  4. 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.

​
Set up SCIM in Entra ID

  1. Open the Entra ID admin dashboard and find or create your application.
  2. In your application, open the provisioning tab and click Connect Your Application.
  3. 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
  4. Navigate to Attribute mapping in the provisioning sidebar.
  5. Add attribute mappings for users. The following attributes are supported:
    • userName: Use your preferred email attribute
    • active
    • displayName
    • title
    • name.givenName
    • name.familyName
  6. 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.

App Integration Configuration