Skip to content

配置OIDC认证

修改 config.yaml 文件的内容来配置 OIDC(OpenID Connect)认证。OIDC 是建立在 OAuth 2.0 协议之上的认证层,允许应用程序通过授权服务器执行的认证来验证用户的身份。这种方法广泛用于实现现代应用程序的单点登录。

配置详细信息

以下是在 config.yaml 中配置 OIDC 设置的逐步指南:

yaml
oauth2:
  type: oidc  # (必填)指定认证类型为 OIDC
  oidcDisplayName: OIDC  # (可选,默认值为 OIDC)登录页面显示的名称
  admin: ""  # (至少填写 admin 或 adminGroups 中的一个;默认为空)管理员用户名,用逗号分隔。列在此处的用户被视为管理员
  adminGroups: ""  # (至少填写 admin 或 adminGroups 中的一个;默认为空)管理员组,用逗号分隔。属于这些组的用户被视为管理员。如果不使用组管理,可以省略此项
  clientid: # (必填)OIDC 客户端 ID
  clientsecret: # (必填)OIDC 客户端密钥
  oidcIssuer: https://auth.example.com/realms/master  # (必填)OIDC 提供商的 issuer URL,可以从您的OIDC 提供商处获取
  # oidcLogoutUrl: https://auth.example.com/realms/master/protocol/openid-connect/logout  # (因 bug 目前不能使用)
  # oidcRegisterUrl: # (可选)OIDC 提供商的注册链接
  oidcScopes: openid,profile,email  # (可选,默认值为 openid,profile,email )OIDC 请求的 scope,用逗号分隔
  oidcLoginClaim: sub  # (可选,默认值为 sub)OIDC 返回的用户名字段,可以是 preferred_username、sub 或email
  oidcGroupsClaim: groups  # (如果使用 adminGroups,则必填,默认值为 groups )OIDC 返回的用户组信息字段,可以是 groups 或 roles
  oidcAutoCreate: false  # (可选,默认值为 false)如果用户不存在,是否自动创建用户
  oidcAutoLogin: false  # (可选,默认值为 false)当地址是 /login 时,是否自动跳转到OIDC登录页面