Configure SCIM for self-managed GitLab instances

Introduced in GitLab 15.8.

You can use the open standard System for Cross-domain Identity Management (SCIM) to automatically:

  • Create users.
  • Block users.

The internal GitLab SCIM API implements part of the RFC7644 protocol.

If you are a GitLab.com user, see configuring SCIM for GitLab.com groups.

Configure GitLab

Prerequisites:

To configure GitLab SCIM:

  1. On the left sidebar, expand the top-most chevron ().
  2. Select Admin Area.
  3. Select Settings > General.
  4. Expand the SCIM Token section and select Generate a SCIM token.
  5. For configuration of your identity provider, save the:
    • Token from the Your SCIM token field.
    • URL from the SCIM API endpoint URL field.

Remove access

Removing or deactivating a user on the identity provider blocks the user on the GitLab instance, while the SCIM identity remains linked to the GitLab user.

To update the user SCIM identity, use the internal GitLab SCIM API.