2026 年 10 月,TrueFoundry 发布 Agent Identity,为注册的智能体建立独立身份,并在网关调用中同时识别 Agent 与它所代表的用户。这项能力把企业身份管理延伸到了智能体:平台通过身份和授权配置,判断哪个 Agent 可以代表哪个主体、访问哪些资源。
本文从身份、凭据和授权讲起,解释委托访问的技术机制,再介绍艾体宝 TrueFoundry 方案中的具体实现。
一、身份、凭据与权限分别管理什么
企业的 IAM(Identity and Access Management,身份与访问管理)负责建立身份、验证身份,并控制资源访问。其基本对象是 Principal,即系统能够识别并授予权限的安全主体。员工、服务账号和注册后的 Agent 都属于这类主体。
身份描述主体是谁,凭据用于证明身份。 一个服务账号更换密钥或改用短期令牌后,主体身份保持不变。系统通过可信凭据识别 Agent,提示词中的名称和模型自我介绍不参与身份认证。
Authentication(身份认证)验证调用者的凭据,Authorization(授权)判断该主体能否对目标资源执行指定操作。Agent 访问模型或工具,必须同时通过身份认证和对应资源的授权检查。
IdP(Identity Provider,身份提供商)提供可信的身份认证结果,Okta 和 Microsoft Entra ID 是常见实现。业务系统根据这些身份信息及自身授权策略作出访问决策。身份提供商和授权服务器可以由同一个产品承载,分别承担身份认证与访问授权的职责。
二、API Key、Token 与 JWT:凭据如何表达身份
开发者调用 API 时,经常要在请求中附上一串 API Key。服务端收到它,就能找到对应的账号及权限。多个 Agent 共用同一把 Key 时,服务端凭这把 Key 识别到的是同一个账号。要分清每次操作由哪个 Agent 发起,就需要为它们提供独立的身份信息。
Access Token(访问令牌)也是调用 API 时提交的凭据。应用取得令牌后,携带它访问获准使用的接口。企业管理这类凭据时,重点关注谁签发、允许访问什么、多久失效,以及怎样撤销。
访问令牌有不同的表达方式。有的只是一串随机字符,服务端需要查询记录才能知道它对应谁;有的把身份和有效期等信息放在令牌里,JWT(JSON Web Token)就是常见格式。
JWT 中的一条身份或权限信息称为 Claim,即“声明”。常见的签名 JWT 包含头部、载荷和签名,其中“载荷”就是存放这些信息的内容部分。下面用一个虚构载荷展示常用字段:
{
"iss": "https://identity.example.com",
"sub": "agent-reporting-01",
"aud": "https://gateway.example.com",
"exp": 1893456000,
"scope": "reports:read"
}
这里的
iss 表示签发方,
sub 表示主体,
aud 指定令牌的预期接收方,
exp 是过期时间。系统结合签发方和
sub 识别主体,避免不同身份系统中的相同编号发生混淆。示例中的
scope 是可选的授权范围声明,具体含义由授权系统和目标 API 约定。
接收方读到这些内容后,要验证签名、允许的算法、签发方、接收方和有效期,再进行授权。
解码只是读出令牌里的内容,验签才是在检查内容是否被修改、是否来自可信的签发方。 普通签名 JWT 的载荷是可读的,因此密码和业务密钥应放在专门的秘密管理系统中。
接口文档里还经常出现 Bearer Token。Bearer 的意思是“持有者”:谁持有这枚有效令牌,谁就能用它发起相应的访问。令牌泄漏后,别人也能拿去使用。缩短有效期、保护存储和传输过程,以及提供撤销机制,都是围绕这个特点展开的保护措施。
三、OAuth、OIDC 与 SSO:令牌如何取得和使用
理解了令牌里有什么,接下来就要看应用怎样取得它。OAuth 2.0 提供了一套授权流程:应用向授权服务器申请访问资格,获得访问令牌,再携带令牌调用目标 API。JWT 负责表达信息,OAuth 2.0 负责组织取得和使用授权的流程,两者经常配合使用。
对于后台程序,Client Credentials(客户端凭据)流程允许应用以自身身份取得访问令牌。这类调用依据应用自己的权限运行,没有被代表的登录用户,适合经过明确授权的后台任务。
用户参与授权时,常见的是 Authorization Code(授权码)流程。用户先完成登录与授权,应用收到一个短期授权码,再用它兑换令牌。配套的 PKCE 机制会检查兑换方是否掌握发起流程时生成的校验码,防止别人仅凭截获的授权码换走令牌。
应用还需要知道当前登录的人是谁。OIDC(OpenID Connect)在 OAuth 2.0 之上增加了这部分能力,通过 ID Token 向应用传达用户认证结果。两种令牌各有用途:应用用 ID Token 确认登录用户,用 Access Token 访问获准调用的 API。
大家更熟悉的 SSO(Single Sign-On,单点登录),说的是一次登录后访问多个应用的使用体验。企业通过 OIDC 等身份协议实现这种体验。登录成功后,用户和 Agent 能读取哪些数据、执行哪些操作,由各个系统的授权规则决定。
四、Agent 自主访问与代表用户访问
把这些机制放到 Agent 上,就会出现两种访问方式。定时运行的 Agent 可以使用自己的账号和权限完成任务;员工在应用里发起任务时,Agent 可以代表这名员工访问业务系统。后一种方式需要让系统同时识别员工与 Agent,并检查两者之间的委托关系。
|
访问方式 |
授权依据 |
审计应关注的信息 |
|
以自身身份访问 |
Agent 或服务主体获授的资源权限 |
主体、任务、目标资源与执行结果 |
|
代表用户访问 |
用户授权、Agent 的委托资格及目标资源策略 |
用户、执行 Agent、委托关系与执行结果 |
用户的数据访问权限与 Agent 的委托资格分别授权。 接收方验证用户身份,同时检查该 Agent 是否有权代表用户执行这次访问。委托授权依赖可信身份和授权策略,请求参数中的用户编号只提供标识信息。
跨服务调用必须满足令牌的受众要求。仅以 API A 为受众的令牌用于访问 API A,访问 API B 则使用面向 API B 的令牌。授权服务器验证调用方、用户授权和目标资源策略后,签发适用于下一跳的令牌。
Microsoft Entra 的 OBO(On-Behalf-Of,代表用户)流程就是一种实现:中间层 API 接收面向自身的用户令牌,再通过授权服务器取得访问下游 API 的委托令牌。RFC 8693 定义了 Token Exchange(令牌交换)框架,通过主体令牌和可选的执行方令牌表达交换请求。Entra OBO 与 RFC 8693 使用不同的协议参数,客户端按照目标身份平台支持的流程完成集成。
下图展示基于令牌交换的通用委托调用流程;TrueFoundry 的具体实现见第五节。
暂时无法在飞书文档外展示此内容
令牌交换中的签发策略决定新令牌的受众、权限范围和执行方信息,资源服务负责验证并使用这些声明。Scope(权限范围)表达允许执行哪些操作,RBAC(基于角色的访问控制)通过角色组织和分配权限。业务系统检查订单归属、可见记录和金额上限,落实具体的数据与操作权限。
五、TrueFoundry Agent Identity 的实现逻辑
TrueFoundry 将上述身份管理机制应用到 Agent 注册、网关授权、凭据获取和调用审计中。
1. 为注册的 Agent 建立独立主体
TrueFoundry 在注册 Agent 时为其建立身份。凭据可以由 TrueFoundry 签发,也可以使用受支持的企业 IdP。Agent 可以托管在其他环境中;没有独立可代理端点的嵌入式 Agent,也可以在向网关发起调用时使用自己的身份。
这种设计将身份管理与运行位置分开,平台通过注册主体管理分布在不同环境中的 Agent 调用。
2. 在网关侧同时检查用户与 Agent
委托调用通过两个请求头分别提交用户与 Agent 的凭据:
Authorization: Bearer <USER_TOKEN>
x-tfy-agent-authorization: Bearer <AGENT_TOKEN>
第一组标识被代表的用户,第二组标识执行调用的 Agent。网关解析两者并检查这对身份的授权关系。凭据应由可信的调用代码或运行环境添加,避免进入模型可见的提示词或工具结果。
权限配置分为两个方向:在 Agent 上授予
Agent Access,决定哪些用户、团队或虚拟账号可以调用它并被它代表;在目标模型、MCP Server 或其他 Agent 上,将该 Agent 添加为获授权的协作者,决定它能访问哪些资源。
Agent Manager 则负责 Agent 配置管理,与调用权限用途不同。
双重身份检查发生在网关入站侧,下游认证由出站配置决定。 共享 API Key、OAuth 和凭据透传分别对应不同的下游身份处理方式。业务接口使用共享服务账号时,按该账号执行授权;按用户权限访问业务数据,需要下游能够识别并校验相应的用户身份。
Agent 身份请求头是可选的,未携带时请求按普通用户调用处理。纳入 Agent 治理的调用路径应统一携带该请求头,并通过凭据和网络访问管理控制旁路调用。
3. 通过资源授权和 Virtual MCP 控制工具范围
MCP Server 的资源授权决定 Agent 能否访问该入口,入口暴露的工具决定其可用操作范围。TrueFoundry 的 Virtual MCP Server 将选定工具组织成子集,供不同应用或 Agent 使用。
企业据此按用途建立入口,将查询工具与写入工具分开授权。直接在每个 Agent 的授权记录中指定工具范围属于规划中能力。
4. 用工作负载身份联合获取短期凭据
Workload Identity Federation(WIF,工作负载身份联合)用于让运行中的程序利用所在环境的身份,获取 TrueFoundry 访问凭据。这里的工作负载可以是 Kubernetes 中的服务或 GitHub Actions 中的任务。
管理员先配置可信签发方、允许的受众、验签公钥来源,以及身份声明到现有 Agent 或 Virtual Account(虚拟账号)的映射。工作负载取得外部 JWT 后,将其提交给 TrueFoundry 的令牌端点。平台验证令牌和映射关系,再签发短期访问令牌;权限沿用被映射主体的授权。
这类令牌的有效期为 60 至 3,600 秒,默认 3,600 秒;到期前通过再次交换获取新令牌,流程不提供刷新令牌。工作负载利用环境身份持续取得短期访问凭据,无需在任务配置中保存长期 TrueFoundry 密钥。
WIF 管理工作负载到 TrueFoundry 的入站认证,下游连接配置管理 Agent 到数据库、SaaS 和其他业务系统的认证。
5. 按用户与 Agent 追踪调用
TrueFoundry 将携带有效双重身份的调用归因到执行 Agent 和它所代表的用户,并记录请求量、延迟和错误。排查人员据此定位调用主体、目标资源和失败请求。
截至 2026 年 11 月 11 日,Agent Identity 处于 Beta 阶段,通用逐跳委托令牌交换与完整执行方链路的统一追踪展示属于规划中能力。已提供的特定 OBO 集成按各连接器定义的流程工作。
企业落地艾体宝 TrueFoundry 方案时,应沿实际调用链配置凭据获取、网关授权、下游身份传递、业务权限校验和审计关联。明确每一层的身份与授权职责,才能将 Agent 的访问权限落实到具体资源和操作。
六、身份管理术语速查
|
术语 |
中文与含义 |
|
IAM |
身份与访问管理,覆盖身份建立、认证、授权及生命周期管理。 |
|
Principal |
安全主体,系统能够识别并授予权限的用户、服务或 Agent。 |
|
Credential |
凭据,用于证明身份或访问资格,例如密钥和令牌。 |
|
Authentication / Authorization |
身份认证验证调用者;授权判断其能否执行目标操作。 |
|
IdP |
身份提供商,提供可信的身份认证结果。 |
|
Access Token / ID Token |
访问令牌用于资源 API;身份令牌向客户端表达用户认证结果。 |
|
JWT / Claim |
JWT 是令牌格式;Claim 是其中的声明,如签发方、主体和受众。 |
|
OAuth 2.0 / OIDC |
OAuth 2.0 提供授权框架;OIDC 在其上增加身份层。 |
|
SSO |
单点登录,一次登录后访问多个应用的体验。 |
|
PKCE |
将授权码兑换与发起流程的客户端绑定的保护机制。 |
|
Scope / RBAC |
Scope 表达权限范围;RBAC 通过角色组织和分配权限。 |
|
OBO |
代表用户访问下游资源的流程,具体实现取决于身份平台。 |
|
Token Exchange |
令牌交换,用已有令牌申请符合目标要求的新令牌。 |
|
WIF |
工作负载身份联合,信任外部工作负载身份并映射到本平台主体。 |