Skip to content
首页配置用户管理

用户管理 ​

KubeOsprey 支持多种用户管理方式,结合 OAuth 与本地密码用户,配合 RBAC 权限系统,实现灵活的访问控制。

用户类型 ​

  • OAuth 用户:通过第三方身份提供商(如 GitHub、OIDC 等)登录。

如何配置 OAuth 见 OAuth 配置指南

  • 密码用户: 通过用户名和密码登录。密码用户可以启用认证器应用 MFA,也可以注册 Passkey 用于免密码登录。
  • API 密钥:用于脚本、CI/CD 或外部系统调用 KubeOsprey API。参见 API 认证。

用户管理 ​

拥有 admin 角色的用户,可在页面右上角进入设置入口,进入用户与权限管理界面。

在该界面,您可以:

  • 查看当前所有用户及其角色信息
  • 新增用户(仅支持密码用户)
  • 禁用或删除不再需要的账号
  • 修改用户的角色分配,实现权限调整

User Management

账号安全 ​

MFA 和 Passkey 登录默认启用,管理员可以在 设置 -> 认证 中管理。

密码用户可以在账号设置弹窗中管理自己的安全设置:

  • 使用 TOTP 认证器应用启用 MFA
  • 添加或删除 Passkey
  • 在启用 Passkey 登录后使用 Passkey 登录

MFA 和 Passkey 仅适用于密码用户。OAuth 和 LDAP 用户应使用身份提供商侧的安全策略。

强制改密 ​

管理员创建密码用户或重置用户密码后,该账号会被标记为"首次登录需修改密码"。被标记的用户在下次登录时,只能访问修改密码相关接口,其余接口返回 403 password_change_required;完成修改密码后标记自动清除,账号恢复正常使用。

这确保了初始密码和临时重置的密码不会长期有效。

密码策略 ​

管理员可在 设置 -> 通用(General Settings) 中配置密码策略,对通过控制台设置的所有密码生效:

  • 密码有效期(天数):超过有效期的密码在下次登录时要求更换;0 表示不启用
  • 最小长度:默认 8
  • 复杂度要求:可分别要求包含大写字母、小写字母、数字、特殊字符
  • 历史密码限制:新密码不得与最近 N 次使用过的密码重复;0 表示不启用

创建用户或重置密码时设置的新密码同样受该策略约束,不满足策略的请求会被拒绝。

最佳实践 ​

  • 推荐优先使用 OAuth 用户,实现统一身份管理
  • 密码用户适用于特殊或临时场景
  • 为密码用户启用 MFA 或 Passkey
  • 定期审查用户列表和角色分配,确保权限最小化
  • 禁用未使用账号,降低安全风险

权限分配可参考 RBAC 权限管理

Released under the Apache License.