飞书
飞书接入用于飞书账号登录和已有卷王账号的绑定。系统管理员先配置应用，用户再完成各自的授权或绑定。
配置入口与字段
进入 基础设施 → 配置管理 → 第三方登录 → 飞书登录，点击编辑。
| 卷王字段 | 飞书应用中的值 |
|---|---|
| Client ID | App ID |
| Client Secret | App Secret |
| 开启状态 | 完成凭据与回调配置后启用 |
截图展示未启用的配置，不包含真实密钥。
配置步骤
- 在 飞书开放平台创建企业自建应用，获取 App ID 和 App Secret。
- 配置应用可用范围和所需登录授权能力，按平台要求发布版本。
- 在飞书安全设置登记卷王实际发起授权使用的回调地址。域名、协议、路径和参数要求应与授权请求一致。
- 在卷王填入凭据，启用飞书登录并保存。
- 使用应用可见范围内的测试账号，从登录页的飞书入口完成验证。
回调地址不要照搬旧路径
PC 端账号绑定使用 /user/binding 页面，并携带第三方类型参数。它不是个人资料页 /user/profile。登录、PC 绑定和移动端绑定可能使用不同回调，应分别核对实际授权请求，不要只登记系统首页。
绑定已有账号
已登录用户可进入 个人设置 → 用户设置 → 账号绑定，选择飞书完成授权。移动端从个人中心的社交账号绑定进入。应先确认当前登录的是要绑定的卷王账号，再授权对应飞书身份。
飞书登录配置不等同于批量导入用户或同步组织。需要维护卷王用户、部门和权限时，参见用户与角色和部门与岗位。
常见问题
- 看不到入口：检查飞书配置是否启用，以及页面是否已刷新。
- 授权后报回调错误：检查部署域名是否变化，登录与绑定的地址是否都已登记。
- 只有部分成员可用：检查飞书应用的可用范围和版本发布状态。
- 绑定到错误账号：先停止继续授权，核对当前卷王账号与飞书账号，再在账号绑定页面处理。