用途:在 ClickUp 企业版环境中治理访问权限,把 API 角色与 ACL 证据作为授权决策输入,而不是仅凭数字角色码判断实际权限。
主要能力:盘点用户、访客、用户组、自定义角色与受保护对象;对比直接与继承权限;制定最小权限变更计划(含新增、移除、费用影响与回滚);变更后重新读取实际权限并查询审计证据。
必要用法与事实:v2 成员角色字段为 1 owner、2 admin、3 member、4 guest,自定义角色需单独端点;groups 指用户组,v2 的 team_id 指 Workspace;用户/访客管理仅限企业版,v3 审计日志查询仅限企业版且仅 owner 可用;v3 ACL 变更可能改变隐私与共享并产生费用,实际权限可能从层级继承。认证可用个人令牌(仅限可追责的个人/测试)或 OAuth 授权码,令牌须经服务端受管密钥引用注入,放在 Authorization 中,校验授权的 Workspace ID,且不得打印令牌、OAuth 客户端密钥或 webhook 密钥。
限制与边界:不得自行批准权限提升、owner/admin 变更、广泛共享、访客扩展、付费 ACL 影响或用户移除;计划或 owner 前提不满足时停止并报告;实际权限不明确时先解决继承再授权或移除;会产生未批准费用时保持 ACL 不变;验证与目标状态不符时回滚安全变更并上报。输出应包含计划/端点资格、前后权限矩阵、继承注意事项、审批、已应用变更、审计证据与回滚。
资料未提供具体安装命令、价格与更多平台细节。