使用文档权限与身份

权限与身份

配置组织角色、项目权限、API 令牌和身份登录方式。

角色与数据范围

权限由组织角色、成员身份和数据范围共同决定。能看见一个项目,不代表可以修改其所有资源;能读取文档,也不代表可以管理成员或工作流。

配置协作时,以实际职责分配权限。让普通成员拥有完成工作所需的范围,管理权限保留给对应负责人。

API 令牌

在 API 令牌页面创建并管理访问令牌。读取和检索先使用只读档位,需要变更时再按任务提供读写权限。

项目白名单、IP 限制、到期时间和撤销状态都会参与鉴权。发现令牌泄露时及时吊销,并检查相关审计记录。

不要把真实令牌放进公开网页、URL、截图、文档正文或版本库。Agent 使用令牌时,同样受其所属账号和范围约束。

统一身份接入

平台支持按需配置 OIDC、LDAP / AD、双因素验证和 SCIM 2.0。接入前准备现有身份系统的地址、应用配置和相关权限。

在专用管理入口配置身份,不通过知识助手或普通工作项完成登录、2FA 等身份验证流程。配置变更后保留可用的恢复方式,实际验证登录、登出和成员停用。

查看审计记录

关键操作可以通过审计记录追踪。管理员应检查代理配置,确保日志中的客户端 IP 与真实访问来源一致。

界面、内置助手和 MCP 使用同一套业务权限规则。对写入请求,执行后重新读取数据,确认修改结果;通过审计记录查看操作人和时间。

成员访问异常

  1. 确认账号状态和组织成员身份。
  2. 检查项目成员关系及角色。
  3. 检查资源本身的可见范围。
  4. API 请求额外检查令牌档位、白名单、IP 和有效期。

进一步排查见常见问题。

输入关键词,搜索全部使用文档。