菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow 设置breadcrumb arrow 配置安全性breadcrumb arrow 配置 SCIM 用户预配
Grafana Cloud Enterprise RSS

配置 SCIM 用户预配

跨域身份管理系统 (SCIM) 是一种开放标准,允许自动化用户预配和管理。通过 SCIM,您可以自动化将用户和组从您的身份提供者预配到 Grafana。

注意

Grafana EnterpriseGrafana Cloud Advanced 中可用。

注意

此功能位于 enableSCIM 功能开关后面。您可以通过配置文件或环境变量启用功能开关。

有关更多信息,请参阅功能开关文档

优点

注意

SCIM 用户预配仅适用于 SAML 身份验证。不支持其他身份验证方法。

SCIM 在 Grafana 中管理用户和团队方面具有以下优势:

  • 自动化用户预配:当您的身份提供者中发生更改时,在 Grafana 中自动创建、更新和禁用用户
  • 自动化团队生命周期管理:当添加新组时自动创建团队,更新团队成员资格,以及当从身份提供者中移除组时删除团队
  • 减少管理开销:消除手动用户管理任务,减少人为错误的风险
  • 增强安全性:当用户离开组织时自动禁用访问

身份验证和访问要求

在 Grafana 中启用 SCIM 时,适用以下要求和限制:

  1. 使用相同的身份提供者:您必须使用相同的身份提供者进行身份验证和用户预配。例如,如果您使用 Azure AD 进行 SCIM,则必须也使用 Azure AD 进行身份验证。

  2. 身份验证限制:

    • 尝试通过其他方法(LDAP、OAuth)登录的用户将被阻止
    • 默认情况下,未通过 SCIM 预配的用户无法访问 Grafana
    • 您可以通过设置 allow_non_provisioned_users = true 来允许非 SCIM 预配的用户
  3. 例外:具有基本身份验证凭据的用户以及使用其 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 配置示例

ini
[auth.scim]
user_sync_enabled = true
group_sync_enabled = false

支持的身份提供者

支持以下身份提供者:

工作原理

同步过程如下:

  1. 在您的身份提供者和 Grafana 中配置 SCIM
  2. 您的身份提供者将 SCIM 请求发送到 Grafana SCIM API 端点
  3. Grafana 处理这些请求以创建、更新或停用用户和团队,并同步团队成员资格

与其他同步方法的比较

Grafana 提供了多种同步用户、团队和角色的方法。下表将 SCIM 与其他同步方法进行比较,以帮助您了解其优势:

同步方法用户团队角色自动化主要优点限制本地部署Cloud
SCIM⚠️完全通过自动创建团队实现完整的用户和团队生命周期管理需要 SAML 身份验证;使用角色同步进行基本角色分配
团队同步⚠️部分同步团队成员资格到现有团队需要手动创建团队;无团队生命周期管理
活动 LDAP 同步完全LDAP 用户的后台同步仅限于 LDAP 环境
角色同步完全基本角色分配的完全自动化仅限于基本角色
组织映射⚠️完全每个组织的基本角色分配的完全自动化仅限于基本角色;仅限本地部署⚠️

主要优势

  • 全面的用户和团队自动化:SCIM 提供完整的用户和团队预配自动化,而角色管理则通过角色同步单独处理
  • 动态团队创建:根据身份提供者组自动创建团队
  • 近实时同步:身份提供者中的更改根据提供者的同步计划反映
  • 企业级:专为具有复杂用户管理需求的大型组织设计

后续步骤