使用 Grafana 用户界面配置 LDAP 身份验证
本页面介绍如何使用 Grafana 用户界面配置 LDAP 身份验证。有关使用配置文件配置 LDAP 身份验证的更多详细信息,请参阅 LDAP 身份验证。
使用 Grafana 用户界面配置 LDAP 身份验证的优势包括
- 无需手动编辑配置文件。
- 快速测试与 LDAP 服务器的连接。
- 更改后无需重启 Grafana。
注意
通过 Grafana 用户界面 (UI) 进行的任何配置更改将优先于 Grafana 配置文件或环境变量中指定的设置。如果您在 UI 中修改任何配置设置,它们将覆盖通过环境变量或配置文件中定义的任何相应设置。
开始之前
按照这些说明操作,您需要
- 了解 LDAP 身份验证及其工作原理。
- Grafana 实例版本 v11.3.0 或更高版本。
- 具有
settings:auth.ldap:*
范围的settings:read
和settings:write
权限。 - 启用
ssoSettingsLDAP
特性开关。
配置 LDAP 身份验证的步骤
登录 Grafana 并导航到 Administration > Authentication > LDAP。
1. 完成必填字段
必填字段旁边标有星号 (*)。填写以下字段
- 服务器主机:LDAP 服务器的主机名或 IP 地址。
- 搜索过滤器:用于在目录中查找条目的 LDAP 搜索过滤器。
- 搜索基础 DN:要搜索的基础 DN 列表。
2. 完成可选字段
根据需要填写可选字段
- 绑定 DN:用于绑定的用户的专有名称 (DN)。
- 绑定密码:服务器密码。
3. 高级设置
点击高级设置部分的编辑按钮来配置以下设置
1. 其他设置
LDAP 身份验证的补充设置。
- 允许注册:允许新用户在登录时注册。
- 端口:LDAP 服务器的端口号。默认为 389。
- 超时:等待 LDAP 服务器响应的秒数。
2. 属性
用于将 LDAP 用户声明映射到 Grafana 用户属性的属性。
- 姓名:要映射到 Grafana 用户姓名的声明属性名称。
- 姓氏:要映射到 Grafana 用户姓氏的声明属性名称。
- 用户名:要映射到 Grafana 用户用户名的声明属性名称。
- 所属成员:要映射到 Grafana 用户成员资格的声明属性名称。
- 邮箱:要映射到 Grafana 用户邮箱的声明属性名称。
3. 组映射
将 LDAP 组映射到 Grafana 角色。
跳过组织角色同步:此选项避免同步组织角色。当您想手动管理角色时非常有用。
组搜索过滤器:用于在目录中查找组的 LDAP 搜索过滤器。
组搜索基础 DN:指定匹配组位置的基础 DN 列表。
组名属性:识别组条目中的用户。
管理组映射:
管理组映射时,以下字段可用。要添加新的组映射,请点击添加组映射按钮。
- 添加组 DN 映射:用于提取 ID token 的键名称。
- 添加组织角色映射:选择映射到此组的基本角色。
- 添加组织 ID 成员资格映射:将组映射到组织 ID。
- 定义 Grafana 管理员成员资格:为该组启用 Grafana 管理员权限。
4. 额外安全设置
LDAP 身份验证的其他安全设置选项。
- 启用 SSL:此选项将启用 SSL 连接到 LDAP 服务器。
- 启动 TLS:使用 StartTLS 加密连接到 LDAP 服务器。
- 最小 TLS 版本:选择要使用的最小 TLS 版本。TLS1.2 或 TLS1.3
- TLS 密码套件:列出用于连接的密码套件。有关完整的密码套件列表,请参阅 Cipher Go 库。
- 加密密钥和证书供应规范:本节允许您指定 LDAP 服务器的密钥和证书。您可以通过两种方式提供密钥和证书:Base64 编码或文件路径。
- Base64 编码证书:本节中使用的所有值都必须是 Base64 编码。
- 根 CA 证书内容:根 CA 证书列表。
- 客户端证书内容:客户端证书内容。
- 客户端密钥内容:客户端密钥内容。
- 文件路径:文件系统中密钥和证书文件的路径
- 根 CA 证书路径:根 CA 证书的路径。
- 客户端证书路径:客户端证书的路径。
- 客户端密钥路径:客户端密钥的路径。
- Base64 编码证书:本节中使用的所有值都必须是 Base64 编码。
4. 持久化配置
配置完 LDAP 设置后,点击保存以持久化配置。
如果您想删除通过 UI 进行的所有更改并恢复到配置文件设置,请点击三点菜单图标,然后点击重置为默认值。