feat(docs): update docs about oidc login
This commit is contained in:
parent
ffda077746
commit
351a89e205
@ -69,58 +69,3 @@ TAVILY_API_KEY= # 获取搜索服务的 api key 请访问 https://app.tavily.co
|
|||||||
# KUBECONFIG_PATH=/root/.kube/config
|
# KUBECONFIG_PATH=/root/.kube/config
|
||||||
# THREAD_PVC=yuxi-thread
|
# THREAD_PVC=yuxi-thread
|
||||||
# SKILLS_PVC=yuxi-skills # 当前代码会读取,但 Pod 挂载实际仍只使用 THREAD_PVC
|
# SKILLS_PVC=yuxi-skills # 当前代码会读取,但 Pod 挂载实际仍只使用 THREAD_PVC
|
||||||
|
|
||||||
# =============================================================================
|
|
||||||
# OIDC 认证配置
|
|
||||||
# =============================================================================
|
|
||||||
# 是否启用 OIDC 认证 (true/false)
|
|
||||||
# OIDC_ENABLED=false
|
|
||||||
|
|
||||||
# 认证源名称(显示在登录按钮上的文字,建议简短且具有辨识度, 默认: OIDC登录)
|
|
||||||
# OIDC_PROVIDER_NAME="OIDC登录"
|
|
||||||
|
|
||||||
# OIDC Provider 的 Issuer URL (例如: https://auth.example.com)
|
|
||||||
# OIDC_ISSUER_URL=
|
|
||||||
|
|
||||||
# OIDC Client ID
|
|
||||||
# OIDC_CLIENT_ID=
|
|
||||||
|
|
||||||
# OIDC Client Secret
|
|
||||||
# OIDC_CLIENT_SECRET=
|
|
||||||
|
|
||||||
# OIDC 回调 URL (可选,默认自动构建为 /api/auth/oidc/callback, 不建议自定义)
|
|
||||||
# 需要确保此 URL 在 OIDC Provider 中已注册
|
|
||||||
# OIDC_REDIRECT_URI=
|
|
||||||
|
|
||||||
# 授权端点 (可选,自动从 discovery 获取)
|
|
||||||
# OIDC_AUTHORIZATION_ENDPOINT=
|
|
||||||
|
|
||||||
# Token 端点 (可选,自动从 discovery 获取)
|
|
||||||
# OIDC_TOKEN_ENDPOINT=
|
|
||||||
|
|
||||||
# UserInfo 端点 (可选,自动从 discovery 获取)
|
|
||||||
# OIDC_USERINFO_ENDPOINT=
|
|
||||||
|
|
||||||
# 登出端点 (可选,自动从 discovery 获取)
|
|
||||||
# OIDC_END_SESSION_ENDPOINT=
|
|
||||||
|
|
||||||
# 请求的 scope (默认: openid profile email)
|
|
||||||
# OIDC_SCOPES=openid profile email
|
|
||||||
|
|
||||||
# 是否自动创建用户 (true/false,默认: true)
|
|
||||||
# OIDC_AUTO_CREATE_USER=true
|
|
||||||
|
|
||||||
# OIDC 用户的默认角色 (user/admin,默认: user)
|
|
||||||
# OIDC_DEFAULT_ROLE=user
|
|
||||||
|
|
||||||
# OIDC 用户的默认部门名称 (默认: OIDC用户)
|
|
||||||
# OIDC_DEFAULT_DEPARTMENT=OIDC用户
|
|
||||||
|
|
||||||
# 用户名映射字段 (默认: preferred_username)
|
|
||||||
# OIDC_USERNAME_CLAIM=preferred_username
|
|
||||||
|
|
||||||
# 邮箱映射字段 (默认: email)
|
|
||||||
# OIDC_EMAIL_CLAIM=email
|
|
||||||
|
|
||||||
# 姓名映射字段 (默认: name)
|
|
||||||
# OIDC_NAME_CLAIM=name
|
|
||||||
|
|||||||
@ -1,19 +1,20 @@
|
|||||||
# 第三方登录认证
|
# 第三方登录认证
|
||||||
Yuxi 支持以OIDC接入第三方登录认证,方便企业用户集成现有的身份认证系统。
|
Yuxi 支持以OIDC接入第三方登录认证,方便企业用户集成现有的身份认证系统。
|
||||||
|
> 此功能默认关闭,需要在配置文件中启用并提供相关参数。
|
||||||
|
|
||||||
## 配置步骤
|
## 配置步骤
|
||||||
1. 前提条件:
|
### 1. 前提条件
|
||||||
在你的SSO系统中注册一个新的客户端应用,获取以下信息:
|
在你的SSO系统中注册一个新的客户端应用,获取以下信息:
|
||||||
- 客户端ID(Client ID)
|
- 客户端ID(Client ID)
|
||||||
- 客户端密钥(Client Secret)
|
- 客户端密钥(Client Secret)
|
||||||
- ISSUER URL
|
- ISSUER URL
|
||||||
|
|
||||||
回调地址(Redirect URI):<your_yuxi_host>/api/auth/oidc/callback
|
填入回调地址(Redirect URI):https://<your_yuxi_host>/api/auth/oidc/callback
|
||||||
|
|
||||||
2. 配置Yuxi:
|
### 2. 配置Yuxi
|
||||||
在Yuxi的.env文件中添加以下配置项:
|
在Yuxi的.env文件中添加以下配置项:
|
||||||
|
|
||||||
```env
|
```sh
|
||||||
# 是否启用 OIDC 认证 (true/false)
|
# 是否启用 OIDC 认证 (true/false)
|
||||||
# OIDC_ENABLED=false
|
# OIDC_ENABLED=false
|
||||||
|
|
||||||
@ -30,6 +31,7 @@ Yuxi 支持以OIDC接入第三方登录认证,方便企业用户集成现有
|
|||||||
# OIDC_CLIENT_SECRET=
|
# OIDC_CLIENT_SECRET=
|
||||||
|
|
||||||
# OIDC 回调 URL (可选,默认自动构建为 /api/auth/oidc/callback, 不建议自定义)
|
# OIDC 回调 URL (可选,默认自动构建为 /api/auth/oidc/callback, 不建议自定义)
|
||||||
|
# 填写完整的地址:https://<your_yuxi_host>/api/auth/oidc/callback
|
||||||
# 需要确保此 URL 在 OIDC Provider 中已注册
|
# 需要确保此 URL 在 OIDC Provider 中已注册
|
||||||
# OIDC_REDIRECT_URI=
|
# OIDC_REDIRECT_URI=
|
||||||
|
|
||||||
@ -67,7 +69,7 @@ Yuxi 支持以OIDC接入第三方登录认证,方便企业用户集成现有
|
|||||||
# OIDC_NAME_CLAIM=name
|
# OIDC_NAME_CLAIM=name
|
||||||
|
|
||||||
```
|
```
|
||||||
3. 重启Yuxi服务使配置生效
|
### 3. 重启Yuxi服务使配置生效
|
||||||
```bash
|
```bash
|
||||||
docker restart api-dev web-dev
|
docker restart api-dev web-dev
|
||||||
```
|
```
|
||||||
Loading…
Reference in New Issue
Block a user