Skip to main content

SCIM integration

note

This feature requires SAML integration to be already configured.

Qwiet preZero supports SCIM v2 (System for Cross-domain Identity Management). This allows for seamless integration with Identity Providers (IdPs) and simpler user provisioning and management.

Steps to enable SCIM for your organization​

  1. A reserved email domain is required to enable SCIM. To reserve your domain, send an email request to support@qwiet.ai stating you want to reserve your company domain for the purpose of enabling SCIM
  2. Once your email domain is reserved, you may configure your SCIM provider (i.e. Entra ID, Okta) to point to the Qwiet SCIM endpoint: https://app.shiftleft.io/api/v4/orgs/{orgID}/scim - be sure to insert your correct Organization ID
  3. If you prefer to have your Identity Provider groups brought over to Qwiet as User Groups that you can assign to Teams, make sure to enable the setting in your Organization Settings for "Prefer Groups". Otherwise, leave it disabled to sync your SCIM groups as Qwiet Teams

Endpoint​

The base URL for SCIM endpoints is: https://app.shiftleft.io/api/v4/orgs/{orgID}/scim

Authentication​

You can authenticate using a SCIM Integration Token or a Super Admin's Access Token found in the Organization Overview page, on the Qwiet preZero web UI.

User data handling​

The following data points are mapped into a Qwiet preZero user:

  • userName: when provided by the SCIM v2 provider, ensure that the userName field contains the primary work email
  • email: email should be included, preferably marked as primary
  • displayName: while not mandatory, it is recommended to include the displayName field for better user identification

Supported schemas​

The current SCIM v2 implementation supports the following schemas:

  • User (https://app.shiftleft.io/api/v4/orgs/{orgID}/scim/Users)
  • Group (https://app.shiftleft.io/api/v4/orgs/{orgID}/scim/Groups)

Schema discovery is available to facilitate the integration and the understanding of supported attributes and endpoints.

https://app.shiftleft.io/api/v4/orgs/{orgID}/scim/Schemas

For further assistance or inquiries, please contact your Customer Success representative.