grafana单点登录

### Grafana 单点登录配置与实现方法

对于希望在 Grafana 中实施单点登录 (SSO)，可以采用 OAuth2 方式来完成这一目标。具体来说，在设置过程中，需先准备支持 OAuth2 的身份验证服务器，如 Keycloak 或 Maxkey。

#### 使用 Docker 安装并启动 Grafana 开源版本

为了便于测试 SSO 功能，建议按照以下方式部署最新稳定版的 Grafana：

docker run -d -p 3000:3000 --name grafana grafana/grafana-oss:latest

此命令会拉取官方镜像并以后台模式运行容器，使得可以通过浏览器访问位于 `http://localhost:3000` 的默认地址[^1]。

#### 配置 Generic OAuth 身份认证服务

进入 Grafana 设置页面后，导航至 "Configuration" -> "Authentication" 下找到 “Generic OAuth”。在此处输入来自 OAuth 提供商的相关参数，比如客户端 ID 和密钥等必要字段。这些信息通常由所选的身份提供商提供给管理员用于集成目的[^2]。

#### 修改 Grafana 配置文件以启用 OAuth 登录选项

如果偏好手动编辑配置文件，则可以在 `/etc/grafana/grafana.ini` 文件中的 `[auth.generic_oauth]` 段落下添加相应条目。下面是一个简单的例子展示如何指定授权端点、令牌交换 URL 及用户详情 API 地址等内容：

[auth.generic_oauth]
enabled = true
client_id = YOUR_CLIENT_ID
client_secret = YOUR_SECRET_KEY
scopes = profile email openid
auth_url = https://your-idp-provider/auth/realms/master/protocol/openid-connect/auth
token_url = https://your-idp-provider/auth/realms/master/protocol/openid-connect/token
api_url = https://your-idp-provider/auth/realms/master/protocol/openid-connect/userinfo

请注意替换上述模板里的占位符为实际值，并确保路径指向正确的 IdP 接口。

#### 测试连接并与现有账户关联

保存更改之后重启 Grafana 应用程序使新设定生效。此时应该能够在登录界面看到新增加的第三方登录按钮；点击它即触发跳转流程直至成功返回已鉴权状态下的仪表板首页。首次使用外部账号登录时可能还会提示创建本地映射关系以便日后识别同一主体的不同来源凭证。