From d02e5ed450271e7e78199dd5f25de34f998c1b0c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 30 Mar 2026 15:01:27 +0000 Subject: [PATCH 1/2] Add SCIM_ENABLED=true requirement to SCIM integration docs Generated-By: mintlify-agent --- references/workspace/scim-integration.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/references/workspace/scim-integration.mdx b/references/workspace/scim-integration.mdx index 77a92e3e..e5e254cd 100644 --- a/references/workspace/scim-integration.mdx +++ b/references/workspace/scim-integration.mdx @@ -21,9 +21,10 @@ SCIM (System for Cross-domain Identity Management) is an open standard protocol This document describes the steps required to integrate SCIM into your Enterprise instance, allowing your IdP to manage users and groups within your organization. - **Important:** If you are self-hosting Lightdash, when using SCIM with SSO, you should enable the `AUTH_ENABLE_OIDC_TO_EMAIL_LINKING` environment variable. This allows linking OIDC identity to an existing user by email. Without this setting, Lightdash will attempt to create a new user when they sign in via SSO, which will fail if the user was already provisioned via SCIM. + **Important:** If you are self-hosting Lightdash, you must set the `SCIM_ENABLED` environment variable to `true` to enable SCIM. Additionally, when using SCIM with SSO, you should enable the `AUTH_ENABLE_OIDC_TO_EMAIL_LINKING` environment variable. This allows linking OIDC identity to an existing user by email. Without this setting, Lightdash will attempt to create a new user when they sign in via SSO, which will fail if the user was already provisioned via SCIM. ```bash + SCIM_ENABLED=true AUTH_ENABLE_OIDC_TO_EMAIL_LINKING=true ``` From 3c410c49ebcafb8e330db67b90caf69f7a74f317 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 30 Mar 2026 15:06:57 +0000 Subject: [PATCH 2/2] Move SCIM_ENABLED=true outside the warning callout Generated-By: mintlify-agent --- references/workspace/scim-integration.mdx | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/references/workspace/scim-integration.mdx b/references/workspace/scim-integration.mdx index e5e254cd..9451c757 100644 --- a/references/workspace/scim-integration.mdx +++ b/references/workspace/scim-integration.mdx @@ -20,11 +20,16 @@ SCIM (System for Cross-domain Identity Management) is an open standard protocol This document describes the steps required to integrate SCIM into your Enterprise instance, allowing your IdP to manage users and groups within your organization. +If you are self-hosting Lightdash, you must set the `SCIM_ENABLED` environment variable to `true` to enable SCIM: + +```bash +SCIM_ENABLED=true +``` + - **Important:** If you are self-hosting Lightdash, you must set the `SCIM_ENABLED` environment variable to `true` to enable SCIM. Additionally, when using SCIM with SSO, you should enable the `AUTH_ENABLE_OIDC_TO_EMAIL_LINKING` environment variable. This allows linking OIDC identity to an existing user by email. Without this setting, Lightdash will attempt to create a new user when they sign in via SSO, which will fail if the user was already provisioned via SCIM. + **Important:** When using SCIM with SSO, you should also enable the `AUTH_ENABLE_OIDC_TO_EMAIL_LINKING` environment variable. This allows linking OIDC identity to an existing user by email. Without this setting, Lightdash will attempt to create a new user when they sign in via SSO, which will fail if the user was already provisioned via SCIM. ```bash - SCIM_ENABLED=true AUTH_ENABLE_OIDC_TO_EMAIL_LINKING=true ```