配置 SCIM 用户预配
跨域身份管理系统 (SCIM) 是一种开放标准,允许自动化用户预配和管理。通过 SCIM,您可以自动化将用户和组从您的身份提供者预配到 Grafana。
注意
在 Grafana Enterprise 和 Grafana Cloud Advanced 中可用。
注意
此功能位于
enableSCIM
功能开关后面。您可以通过配置文件或环境变量启用功能开关。有关更多信息,请参阅功能开关文档。
优点
注意
SCIM 用户预配仅适用于 SAML 身份验证。不支持其他身份验证方法。
SCIM 在 Grafana 中管理用户和团队方面具有以下优势:
- 自动化用户预配:当您的身份提供者中发生更改时,在 Grafana 中自动创建、更新和禁用用户
- 自动化团队生命周期管理:当添加新组时自动创建团队,更新团队成员资格,以及当从身份提供者中移除组时删除团队
- 减少管理开销:消除手动用户管理任务,减少人为错误的风险
- 增强安全性:当用户离开组织时自动禁用访问
身份验证和访问要求
在 Grafana 中启用 SCIM 时,适用以下要求和限制:
使用相同的身份提供者:您必须使用相同的身份提供者进行身份验证和用户预配。例如,如果您使用 Azure AD 进行 SCIM,则必须也使用 Azure AD 进行身份验证。
身份验证限制:
- 尝试通过其他方法(LDAP、OAuth)登录的用户将被阻止
- 默认情况下,未通过 SCIM 预配的用户无法访问 Grafana
- 您可以通过设置
allow_non_provisioned_users = true
来允许非 SCIM 预配的用户
例外:具有基本身份验证凭据的用户以及使用其 Grafana Cloud 账户的用户仍可以登录,不受这些限制的影响。
在 Grafana 中配置 SCIM
下表描述了所有 SCIM 配置选项。与任何其他 Grafana 配置一样,您可以将这些选项作为环境变量应用。
设置 | 必需 | 描述 | 默认值 |
---|---|---|---|
user_sync_enabled | 是 | 启用 SCIM 用户预配。启用后,Grafana 将根据您的身份提供者发送的 SCIM 请求创建、更新和停用用户。 | false |
group_sync_enabled | 否 | 启用 SCIM 组预配。启用后,Grafana 将根据您的身份提供者发送的 SCIM 请求创建、更新和删除团队。如果已启用团队同步,则无法启用此选项。 | false |
allow_non_provisioned_users | 否 | 允许非 SCIM 预配的用户登录 Grafana。 | false |
警告
团队同步兼容性:
- SCIM 组同步 (
group_sync_enabled = true
) 和团队同步不能同时启用- 您可以将 SCIM 用户同步 (
user_sync_enabled = true
) 与团队同步同时使用- 有关迁移和兼容性的更多详细信息,请参阅SCIM vs 团队同步
SCIM 配置示例
[auth.scim]
user_sync_enabled = true
group_sync_enabled = false
支持的身份提供者
支持以下身份提供者:
工作原理
同步过程如下:
- 在您的身份提供者和 Grafana 中配置 SCIM
- 您的身份提供者将 SCIM 请求发送到 Grafana SCIM API 端点
- Grafana 处理这些请求以创建、更新或停用用户和团队,并同步团队成员资格
与其他同步方法的比较
Grafana 提供了多种同步用户、团队和角色的方法。下表将 SCIM 与其他同步方法进行比较,以帮助您了解其优势:
同步方法 | 用户 | 团队 | 角色 | 自动化 | 主要优点 | 限制 | 本地部署 | Cloud |
---|---|---|---|---|---|---|---|---|
SCIM | ✅ | ✅ | ⚠️ | 完全 | 通过自动创建团队实现完整的用户和团队生命周期管理 | 需要 SAML 身份验证;使用角色同步进行基本角色分配 | ✅ | ✅ |
团队同步 | ❌ | ⚠️ | ❌ | 部分 | 同步团队成员资格到现有团队 | 需要手动创建团队;无团队生命周期管理 | ✅ | ✅ |
活动 LDAP 同步 | ✅ | ❌ | ❌ | 完全 | LDAP 用户的后台同步 | 仅限于 LDAP 环境 | ✅ | ❌ |
角色同步 | ❌ | ❌ | ✅ | 完全 | 基本角色分配的完全自动化 | 仅限于基本角色 | ✅ | ✅ |
组织映射 | ❌ | ❌ | ⚠️ | 完全 | 每个组织的基本角色分配的完全自动化 | 仅限于基本角色;仅限本地部署 | ⚠️ | ❌ |
主要优势
- 全面的用户和团队自动化:SCIM 提供完整的用户和团队预配自动化,而角色管理则通过角色同步单独处理
- 动态团队创建:根据身份提供者组自动创建团队
- 近实时同步:身份提供者中的更改根据提供者的同步计划反映
- 企业级:专为具有复杂用户管理需求的大型组织设计