搜索文档

浏览 Workforce · Business Data & Actions (Objects) 文档 ›
Docs/Workforce · Business Data & Actions (Objects)v0.1.0/使用指南/理解系统Authorization、readiness 与 Resource
提示·你正在阅读发布前文档(v0.1.0)。接口与行为在稳定发布前仍可能变化。
文档源码基线
b75e0ff924b17231d712860ead910970f4c098de
核对日期

使用指南 · 理解系统

Authorization、readiness 与 Resource

本页内容

为什么 identity、authorization、admission、readiness、selection、tool approval 与 credential custody 必须分开。

Awaken Workforce 不使用一个含糊的“权限”开关。每道 gate 回答不同问题,也留下不同证据:

Gate问题
Identity哪个 principal 发出请求或执行工作?
Authorization该 principal 能否在此 scope 执行该 action?
Admission提交的声明是否有效且内部安全?
Readinessdependency、Resource、provider 和 worker 现在是否齐备?
Selection哪个合格 Actor/provider/Resource 应服务这项工作?
Approval这次具体 subject action 或 tool call 能否继续?
Egress/lease到副作用边界时 live authority 是否仍有效?

HTTP authorization 集中经过 Workforce IAM layer 与 scoped role binding。Team membership 参与 selection 和 access policy,但不是隐式 grant。Visibility 也投影到同一授权路径; public read 经过 scrub 且只读,不可见 scope 返回 404。

Tool permission 不等于 Resource permission。Runtime 可以允许 tool call,但拥有该 Resource action 的 Workforce service 仍会授权,并可能要求自己的 approval;宽泛 tool grant 因此不能绕过领域数据边界。

Content 让这个区分更具体:只有精确冻结 Resource grant 包含 content read 时, Agent 才看到 resource.content.get;只有包含 submit mutation 时才看到 resource.submit。每次调用都重新派生 live activation/revision grant,解析到达的 精确 ResourceType 与 Project,再应用普通 Resource IAM。approval 拒绝或 pending 发生在 content normalization/storage 之前,因此不会留下部分 Resource write。

ResourceBinding 以 handle 让 Resource 在 scope 可用,ResourceLink 连接已声明 role。 Credential Resource 保存 opaque backing reference,托管 secret 值留在 vault 中,只在 受治理的 Connector/sandbox 边界 materialize。Readiness 会在使用前报告缺失 Resource 或 link,而不会依赖 ambient credential 或猜测默认值。

实现依据

当前 Workforce 文档源码基线中的 crates/app/awaken-flow-server/src/mcp_api/agent_interaction.rs,在读取和变更 Resource 前拥有 live Agent grant 检查。

crates/app/awaken-flow-server/src/resource_content_api.rs 中的 agent_tools_complete_submission_and_reauthorize_content_reads,用原因—效果表 覆盖获准提交与读取、移除提交权限、移除内容读取权限。撤去一种权限不会授予另一种权限。 该用例检查 Resource 访问边界;工具可见不等于已经授权。

实际收益是:operator 可以区分 access、configuration、capacity、approval 或过期 live authority,并修复正确问题,而无需削弱其他边界。