Agent Auth

Agent Auth 为 Agent 提供最小的身份注册、调用签名与身份验证能力。它不管理模型、提示词、工作流或业务授权。

• verifiable-agent-auth-sdk：应用侧 SDK，Python import 为 agent_auth。
• verifiable-agent-auth-registry：单节点 SQLite 身份 Registry。

当前版本 1.1.0，支持 Python 3.11–3.14；OpenAI Agents 支持范围为 >=0.18.2,<0.19。

安装

pip install "verifiable-agent-auth-sdk==1.1.0"
pip install "verifiable-agent-auth-sdk[openai]==1.1.0"  # OpenAI Agents
pip install "verifiable-agent-auth-sdk[server]==1.1.0"  # OpenAI Agents + FastAPI endpoint

基础 SDK 只有 cryptography 和 httpx 两个直接依赖。

最短用法

from agent_auth import AgentAuth

async with AgentAuth() as auth:  # 读取 agent-auth.toml
    result = await auth.call("coordinator", "researcher", {"query": "分析这个问题"})

已有 OpenAI Agents 项目只需绑定身份并替换 Runner 入口：

auth = AgentAuth().bind({"coordinator": coordinator, "researcher": researcher})
async with auth:
    result = await auth.run(coordinator, "分析这个问题")

auth.run() 会认证 FunctionTool 执行事件、Agent.as_tool() 与 handoff；远程边界使用 remote_tool() 和 endpoint()。

运行模式

安全边界

• 所有 Agent 边界使用同一 SignedEnvelope v1，并校验 audience、timestamp、nonce 和响应关联。
• 同进程认证不提供进程级私钥隔离；生产建议一进程一身份。
• production 只信任中心 Registry，且不回退到任意 well-known URL。
• capability 是经过签名的声明，不等于授权；handler 必须根据 AuthContext 决策。
• Registry v1 是单节点、单 worker 服务，不支持 HA。

文档

• Quick Start
• 配置
• API
• OpenAI Agents
• Protocol v1
• 安全模型
• Registry 运维
• 示例

License: MIT