企业内部有 Grafana、Gitea、Mattermost、内部工具……每个系统一套用户名密码,员工需要记住 10 个账号,管理员需要在每个系统单独管理用户。Keycloak 是企业级开源身份认证平台,提供 OAuth2/OIDC 单点登录——用户只需登录一次,即可访问所有集成的系统。
一、Docker 部署
<code"># /opt/keycloak/docker-compose.yml
version: '3.8'
services:
keycloak:
image: quay.io/keycloak/keycloak:24.0
container_name: keycloak
restart: unless-stopped
command: start
environment:
KC_DB: postgres
KC_DB_URL: jdbc:postgresql://postgres:5432/keycloak
KC_DB_USERNAME: keycloak
KC_DB_PASSWORD: keycloak_pass_2026
KC_HOSTNAME: auth.yourdomain.com
KC_HTTPS_ENABLED: "false" # 由 Nginx 处理 TLS
KC_HTTP_ENABLED: "true"
KC_PROXY: edge # 告知 Keycloak 在反向代理后面
KEYCLOAK_ADMIN: admin
KEYCLOAK_ADMIN_PASSWORD: KeycloakAdmin2026!
ports:
- "127.0.0.1:8080:8080"
depends_on:
- postgres
postgres:
image: postgres:16-alpine
environment:
POSTGRES_DB: keycloak
POSTGRES_USER: keycloak
POSTGRES_PASSWORD: keycloak_pass_2026
volumes:
- /opt/keycloak/postgres:/var/lib/postgresql/data二、创建 Realm 和客户端
<code"> 登录 https://auth.yourdomain.com(管理员控制台): 1. 创建 Realm(类似命名空间,隔离不同组织) Realm 名称:mycompany 2. 创建 OAuth2 客户端(为每个要接入的应用创建) 以 Grafana 为例: Clients → Create Client - Client ID: grafana - Client Protocol: openid-connect - Access Type: confidential Valid Redirect URIs: https://grafana.yourdomain.com/login/generic_oauth Credentials 选项卡 → 复制 Client Secret(后面配置 Grafana 用)
三、接入 Grafana(OIDC 配置)
<code"># Grafana 配置文件 /etc/grafana/grafana.ini [auth.generic_oauth] enabled = true name = 企业单点登录 allow_sign_up = true client_id = grafana client_secret = 从Keycloak复制的Secret scopes = openid email profile auth_url = https://auth.yourdomain.com/realms/mycompany/protocol/openid-connect/auth token_url = https://auth.yourdomain.com/realms/mycompany/protocol/openid-connect/token api_url = https://auth.yourdomain.com/realms/mycompany/protocol/openid-connect/userinfo # 角色映射(Keycloak 角色 → Grafana 角色) role_attribute_path = contains(realm_access.roles[*], 'grafana-admin') && 'Admin' || 'Viewer' systemctl restart grafana-server
四、接入 Gitea
<code"> Gitea 管理后台 → 站点管理 → 认证源 → 新增认证源 类型:OAuth2 名称:企业账号 提供商:OpenID Connect 客户端 ID:gitea(在 Keycloak 中创建的 Client ID) 客户端密钥:对应的 Secret OpenID Connect 自动发现 URL: https://auth.yourdomain.com/realms/mycompany/.well-known/openid-configuration 保存后,Gitea 登录页面出现「企业账号」按钮
五、MFA 双因素认证配置
<code"> 在 Keycloak 中为所有用户强制开启 MFA: Realm Settings → Authentication → Required Actions → Configure OTP → 设置为 Default Action(默认必须配置) 用户首次登录时: 1. 输入用户名密码 2. 弹出 MFA 配置页面 3. 用 Google Authenticator / Authy 扫描二维码 4. 输入6位验证码完成绑定 5. 之后每次登录都需要输入动态验证码 或设置为可选(用户自愿开启): Authentication → Required Actions → Configure OTP → Default: Off
六、RBAC 角色控制
<code"> Keycloak RBAC 设计示例: Realm Roles: - admin(平台管理员) - developer(开发者) - ops(运维) - viewer(只读) 应用内角色映射: Grafana: admin → Grafana Admin ops → Grafana Editor * → Grafana Viewer Gitea: admin → Gitea Admin developer → Gitea User(可创建仓库) viewer → Gitea User(只读) 用户分配角色: Users → 选择用户 → Role Mappings → Realm Roles → 分配角色
七、总结
Keycloak 解决了企业内部「账号爆炸」问题——员工只需一套凭证(用户名+密码+MFA)即可访问所有内部系统。管理员在 Keycloak 统一管理用户账号,员工离职时只需在 Keycloak 禁用账号,该员工立即失去所有系统的访问权,无需逐一处理各系统的账号。对于有合规要求(SOC2/ISO27001)的团队,Keycloak 是企业身份认证合规的关键基础设施。
遇到问题解决不了?
把服务器 IP、报错截图和操作步骤发给我们,工程师 7×24 在线,工单平均 10 分钟内响应。
