Files
knowledge-governance/docs/DWS_LOGIN.md
T
姚章浩 3825859da6
build / build (push) Successful in 2m20s
feat(settings): 打通 PP 认证配置并统一 DWS 来源授权
PP 增加受控凭据更新、真实登录与目录检查,待验证修改不会替换生效配置;扫描与取件共享生效修订。
钉钉来源向导、校验与登记共用 DWS 授权,支持中途恢复与换账号保护,取消旧扫码自动回落。
认证审计复用已有来源审计页,配置响应不回传密码;补齐运行镜像脚本与权限。

验证:make verify 退出 0;PP/DWS/httpapi 目标 race 回归通过;隔离 HTTP 服务验证 PP 协议及扫描/取件消费者。
尚未部署;真实 PP 凭据与目录可用性在测试站部署后验证。
2026-11-17 19:08:46 +08:00

3.1 KiB

DWS 登录授权

管理员入口:系统设置 → 数据源配置 → 钉钉账号(DWS)。

  • 未登录时点击“登录授权”,在弹窗中打开钉钉官方授权页,由本人选择账号与组织并确认。
  • 平台等待设备授权完成。成功后自动刷新账号、组织和续期凭证有效期,并检查知识库、钉盘目录访问。
  • “重新授权”采用同一流程;授权中可取消,失败或过期后可重新发起。
  • “检查连接”只列目录与读取登录元数据,不登记来源、不扫描已有来源、不发起入库或生产发布。
  • 登录成功与目录可用分开显示;部分范围无权限时保留其他已成功范围,并展示原因。

服务端接线

API 直接管理 dws auth login --device --no-browser --format json 子进程,不复用旧浏览器扫码侧车。 CLI 负责官方 OAuth 协议、组织 CLI 权限校验及凭据加密持久化。平台只解析官方设备授权链接、用户授权码、有效期与状态;原始输出、access token、refresh token不进入接口或日志。

API 与 worker 必须使用相同 UID,以及同一组可写挂载:

配置 用途
DWS_BIN 固定版本的 DWS 程序
DWS_CONFIG_DIR 共享的 DWS 状态目录
DWS_HOME 共享 home,包含 .local/share/dws-cli 文件型密钥存储
DWS_DISABLE_KEYCHAIN=1 容器使用文件型凭据存储

子进程 HOME 由 DWS_HOME 指定,只透传所需环境。禁止把认证状态复制成多份,避免轮换令牌互相失效。

接口与生命周期

  • POST /api/v1/dws-login:立即返回 starting,后台生成设备授权;同一浏览器管理员会话重复请求复用在途授权。
  • GET /api/v1/dws-login/{id}:读取本人发起的授权。
  • DELETE /api/v1/dws-login/{id}:取消并等待旧 CLI 退出,清除授权链接与用户码。
  • 上述接口均为管理员专用;授权绑定管理员及其登录会话,另一会话无法读取或取消。
  • 创建和取消要求同源操作意图;响应禁止缓存。仅允许 https://login.dingtalk.com/oauth2/device/verify.htm 官方链接。
  • 每次只运行一个授权,防止覆盖共享状态。服务重启会结束在途授权;页面提示重新发起。
  • CLI 成功退出后必须再次读到有效本地凭据才显示登录成功;真实目录访问另行检查。

添加来源

添加来源向导与账号卡共用官方 DWS 授权;列举、校验、登记使用同一身份。来源登记不再自动回落旧扫码侧车。保存中授权失效时保留已成功项并恢复剩余项;换账号或组织后需重新确认范围。详细交互、认证审计与 PP 接线见 数据源认证配置。

验证边界

自动回归覆盖授权生成、成功后状态更新、目录访问失败与部分可用、取消与进程退出、过期、重试、跨管理员/会话隔离、同源限制、官方链接校验及元数据脱敏。 真实本人授权需要管理员在钉钉官方页面确认;自动测试与生成真实授权链接不替代本人授权,也不证明其公司目录权限。