You are viewing an outdated version of the documentation.

This documentation is for an older version (1.4.7) of Dagster. You can view the version of this page from our latest release below.

Utilizing SCIM provisioning in Dagster Cloud#

The System for Cross-domain Identity Management specification (SCIM) is a standard designed to manage user identity information. With SCIM, you can:

  • Create users. Users that are assigned to the Dagster Cloud application in the IdP will be automatically added to your Dagster Cloud organization.
  • Update user attributes. Updating a user’s name or email address in the IdP will automatically sync the change to your user list in Dagster Cloud.
  • Remove users. Deactivating or unassigning a user from the Dagster Cloud application in the IdP will remove them from the Dagster Cloud organization
  • Push user groups. Groups and their members in the IdP can be pushed to Dagster Cloud as Teams.

Understanding SCIM provisioning#

SCIM provisioning eases the burden of manually provisioning users across your cloud applications. When enabled, you can automatically sync user information from your IdP to Dagster Cloud and back again, ensuring user data is always up-to-date.

For a detailed look at SCIM provisioning, check out this blog post.

Managing users#

When SCIM is enabled in Dagster Cloud, a few things about user management will change:

  • New users must be added in the IdP. The ability to add new users will be disabled in Dagster Cloud while SCIM is enabled.

  • Only 'unsynced' users can be removed in Dagster Cloud. 'Synced' users will have an icon indicating they're externally managed by the IdP, while unsynced users will not. For example, the first two users in the following image are synced, while the last isn't:

    Highlighted unsynced user in the Dagster Cloud UI

    You might see unsynced users in Dagster Cloud when:

    • Users exist in Dagster Cloud, but not in the IdP. In this case, create matching users in the IdP and then provision them. This will link the IdP users to the Dagster Cloud users.
    • Users are assigned to the Dagster Cloud IdP app before provisioning is enabled. In this case, you'll need to provision the users in the IdP to link them to the Dagster Cloud users.

If you choose to disable SCIM provisioning in Dagster Cloud, users and teams will remain as-is at the time SCIM is disabled.

Managing teams#

In addition to the above user management changes, there are a few things to keep in mind when managing user groups, otherwise known as Dagster Cloud teams.

User groups in your IdP can be mapped to Dagster Cloud teams, allowing you to centralize the management of user groups and memberships. When SCIM is enabled:

  • Teams can still be managed in Dagster Cloud. You can choose to map and sync these teams to the IdP or administer them solely in Dagster Cloud. Synced groups should be managed only in the IdP, or changes made in Dagster Cloud may be overwritten when a sync is triggered from the IdP.
  • If a group exists only in the IdP and is synced to Dagster Cloud, you'll be prompted to either create a new Dagster Cloud team with the same name or create a link between the IdP group and an existing team in Dagster Cloud.
  • If a group exists only in Dagster Cloud, the group will display in the IdP as an 'external' group with no members. In this case, you can either create a new group in the IdP and link it to an existing Dagster Cloud team, or choose to manage the team only in Dagster Cloud.

Enabling SCIM provisioning#

Prerequisites#

To use SCIM provisioning, you'll need:

Supported Identity Providers#

Dagster Cloud currently supports SCIM provisioning for the following Identity Providers (IdP):

Use the setup guide for your IdP to get started.