Tao Chen bc600e000d
add oidc config (#79)
* add oidc config

* add oidc config to separated page

* add oidc configuraton link to dashboard page

* add oidc configuration page to en_US

* Update dashboard.md

* Update dashboard.md

* Update dashboard.md

* Update dashboard.md

---------

Co-authored-by: Kris <116849421+cantoblanco@users.noreply.github.com>
2024-07-14 02:17:22 +02:00

23 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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