账户控制台

Account Console 是一个自助式 Web 界面,允许最终用户在无需管理员协助的情况下管理自己的账户。

访问账户控制台

用户可通过以下地址访问 Account Console:

https://<keycloak-host>/realms/<realm>/account

用户必须经过身份验证才能访问控制台。如果尚未登录,用户将被重定向到 Realm 登录页面。

可用的自助服务功能

功能描述
个人信息查看并更新配置文件属性(姓名、电子邮件、区域设置)
账户安全更改密码,配置 MFA(OTP、WebAuthn),查看登录历史
设备活动查看和管理跨设备的活动会话。从特定设备退出登录。
关联账户查看和管理已关联的身份提供程序账户(例如,Google、GitHub)
原生应用查看已授权的原生应用并撤销同意

账户安全

更改密码

  1. 转到 账户安全 > 登录 > 基本认证。
  2. 单击 更新。
  3. 输入当前密码和新密码。
  4. 单击 提交。

设置 OTP

  1. 转到 账户安全 > 登录 > 双因素认证。
  2. 单击 设置 Authenticator application。
  3. 使用验证器应用(例如,FreeOTP、Google Authenticator)扫描 QR code。
  4. 输入应用中的验证码。
  5. 单击 提交。

注册 WebAuthn 安全密钥

如果 Realm 中已启用 WebAuthn:

  1. 转到 账户安全 > 登录 > 无密码 或 双因素认证。
  2. 单击 设置安全密钥。
  3. 按照浏览器提示注册硬件密钥或平台验证器。

设备活动

  1. 转到 账户安全 > 设备活动。
  2. 查看所有活动会话,包括 IP 地址、浏览器和上次访问时间。
  3. 在特定会话上单击 退出登录,即可远程终止该会话。

管理员控制

管理员可以控制哪些自助服务功能可用:

  • 用户配置文件 属性可对用户标记为只读(请参见 Security Hardening)。
  • 必需操作 可强制用户在下次登录时执行某些操作(例如,更新密码、配置 OTP、验证电子邮件)。
  • 可在 Realm Settings > 登录 选项卡中启用或禁用 自助注册。
  • 通过添加 删除账户 必需操作,可启用 账户删除。

自定义账户控制台

账户控制台的外观由 account theme 控制。有关创建自定义 theme 的说明,请参见 Customize Themes。