提交工单

香港服务器部署Keycloak:企业OAuth2/OIDC统一身份认证平台完整配置

企业内部有 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 是企业身份认证合规的关键基础设施。

Telegram
Telegram服务器销售@IDCSELL
Telegram技术支持@IDCService