a2a-trustgate

a2a-trustgate

面向生产环境中 AI 系统的合规方案。

你已将 AI Agent 部署到生产环境。现在，向审计师、监管机构和董事会证明它是安全的。

A2A TrustGate 会在 Agent 执行每项操作之前进行筛查，并将决策写入不可变、可直接接入 SIEM 的审计记录。这不是一份声称 Agent 应该如何行事的策略文档，而是一项能阻止违规行为的控制措施，以及证明它有效的证据。

• 强制执行，而非空口承诺。 每项 Agent 操作都必须通过 4 道关卡防火墙才能执行。违反策略的操作会在数毫秒内被拦截，而不是事后才被标记。
• 审计师认可的审计记录。 每项决策——无论允许还是拦截，均附带推理依据——都会写入仅追加、原生支持 OCSF 的日志，可直接接入 Splunk、Sentinel、Chronicle 或 Elastic。
• 映射到你接受评估的框架。 可按 EU AI Act、SOC 2、NIST AI RMF、HIPAA 和学术诚信控制措施导出同一份证据，逐条款、逐控制项对应。
• 范围可验证。 每个 Agent 只能在获授权限范围内执行操作。默认拒绝，且所有边界都会记录在日志中。

适用对象： 将 AI 部署到受监管生产环境中的合规与风险团队，涵盖金融服务、医疗保健、网络运营、创意作品/IP 权利、企业 AI 应用以及研究机构。如果有人问你*“证明你的 AI 是安全的”*，这就是答案。

Agent 提出操作，关卡进行筛查，决策写入审计记录——观看完整演示。

---

审计师认可的审计记录

大多数“AI 治理”只是一份描述意图的 PDF。A2A 会生成证据。每项经过筛查的操作都会形成真正的 OCSF Detection Finding——采用你的 SOC 已在接收的同一架构——并附带可显示篡改痕迹的内容哈希和完整决策推理依据：

a2a audit                          # recent decisions, allowed and blocked
a2a audit export --format ocsf     # OCSF Detection Findings — straight into your SIEM
a2a audit export --format csv      # hand a spreadsheet to an auditor

• 原生支持 OCSF（架构 1.1.0）。 不是一个标注为“OCSF”的定制 JSON 数据块，而是真正的 Detection Finding，Splunk / Sentinel / Chronicle / Elastic 无需自定义连接器即可解析。
• 可显示篡改痕迹。 每条记录都带有内容哈希；导出内容仅追加。你可以证明日志事后未被编辑。
• 映射到合规框架的导出内容。 可将同一组底层事件导出为你正接受审计的控制集：

框架	可提交的材料
EU AI Act	针对筛查、日志记录和人工监督的逐条款证据（第 12、14、26、53 条）
SOC 2	映射到控制项的决策日志（CC 系列）
NIST AI RMF	GOVERN / MAP / MEASURE / MANAGE 证据
HIPAA	安全与隐私规则下的访问决策
学术诚信 / QAA	研究伦理与负责任 AI 记录

作为 EU AI Act 的部署者？ 请阅读 EU AI Act 合规参考——其中提供逐条款对照（第 12 条记录保存、第 14 条人工监督、第 26 条部署者义务），并引用 EUR-Lex 官方文本。该法规将于 2026 年 8 月 2 日起普遍适用。

执行前强制检查——四道防火墙关卡

可验证的合规始于真正能阻止操作的控制。每项操作在获准执行前都必须通过四道关卡：

• 关卡 1 — 确定性规则。 在毫秒内筛查模式和策略：破坏性操作、秘密泄露、注入特征。无需调用模型。
• 关卡 2 — 自我评估。 对于关卡 1 无法直接放行的操作：结合上下文和租户策略，这项操作应该执行吗？
• 关卡 3 — 行为分析。 分析一次运行中的滥用模式——突发操作、探测、权限提升——而不只是孤立地检查单项操作。
• 关卡 4 — 范围强制执行。 按 Agent 设置权限：每个 Agent 只能在授予的范围内操作。默认拒绝超出范围的操作。

防火墙只会收紧决策——放行 → 复核 → 拦截。安全操作仍能快速通过；风险操作会被拦截并记录原因。

---

开发者指南——用一条命令筛查操作

整个控制可通过 CLI（以及 MCP 服务）使用。只需一行即可包装风险步骤，退出代码也便于编写脚本：

a2a eval "rm -rf ./build"          # ✓ ALLOWED   (exit 0)
a2a eval "rm -rf /"                # ✗ BLOCKED   (exit 1) — filesystem destruction pattern
a2a eval "command" --context ctx   # add decision context   (exit 2 = needs review)

代码	含义
0	已放行——可以安全执行
1	已拦截——不得执行
2	需要复核——需要进行关卡 2 自我评估

适用对象： Claude Code · Cursor · Cline · Windsurf · Aider · Codex · 任意 MCP 客户端。

安装

npm install -g a2a-trustgate

npm 包名为 a2a-trustgate；命令为 a2a。

快速开始

# Create a tenant (agent-first — human activates the key)
a2a signup my-company --local

# Screen a command — exit 0 = allowed, 1 = blocked, 2 = needs review
a2a eval "rm -rf ./build"
# ✓ ALLOWED

a2a eval "rm -rf /"
# ✗ BLOCKED: filesystem destruction pattern

# See plan, usage, limits
a2a status

# Full reference
a2a --help

你的密钥会立即签发，但在开始 7 天免费试用（今天费用为 0 美元）之前会返回 402——运行 a2a signup 即可获取激活链接。在第 7 天之前取消，就不会产生任何费用。

评估调用有几个可调参数，也支持编写脚本——为任意风险步骤添加包装：

a2a eval "command" --gate2 self    # self-evaluate (default)
a2a eval "command" --gate2 skip    # Gate 1 only (fast path)
a2a eval "command" --pipeline ID   # route through a named pipeline

if a2a eval "rm -rf ./build" --json 2>/dev/null; then
  rm -rf ./build
fi

为六类团队打造

A2A 为所有团队采用相同的筛查方式，并生成相同的审计记录——但各团队接触的界面以及所依据的评估框架各不相同。选择适合你的方案。

网络运维——在每台设备前设置一道关卡

你的 Agent 会对路由器、交换机和站点运行命令。A2A 会注册每台设备、强制执行设备级策略，并提供一个可同时停止所有 Agent 的紧急停止开关。

a2a device add --name core-rtr-1 --host 10.0.0.1 --vendor cisco
a2a device policy DEVICE-ID --mode strict --require-approval --max 5
a2a device lock DEVICE-ID           # freeze a single device
a2a killswitch                      # freeze every agent, everywhere
a2a device import --file hosts.csv  # bulk onboard (name,host,vendor,model,role,siteCode)

Agent 筛查命令	人工查看设备锁定状态

观看完整片段：网络运维 →

AI Agent——对 Agent 间通信进行筛查并签名

在多 Agent 系统中，一个 Agent 的输出会成为另一个 Agent 的输入。A2A 为它们提供范围受限的工作区和 HMAC 签名通道，因此恶意或遭注入的消息无法越过你未授权的边界。

a2a workspace create "research-swarm"
a2a workspace WS-ID add-agent --name planner --role expert
a2a workspace WS-ID enforce --agent planner "command"   # screen an agent's action
a2a channel create ops-bus
a2a channel CH-ID send "interface frozen — you're clear to build"  # HMAC-signed

Agent 间评估	人工查看拦截结果和审计记录

观看完整片段：AI Agent →

受监管行业 — 不可篡改、可导出的审计追踪

每项决策——无论允许还是阻止，以及相应的理由——都会写入一份只能追加的日志，你可以将其导出给审计人员。原生支持 OCSF Detection Findings，并符合《欧盟 AI 法案》。

a2a audit                          # recent decisions
a2a audit export --format ocsf     # OCSF Detection Findings → your SIEM
a2a audit export --format csv      # hand to an auditor (csv/json)
a2a approvals                      # human-in-the-loop queue
a2a approve TASK-ID
a2a reject TASK-ID "out of policy" # reason recorded in the trail

已筛查的命令	人工导出审计记录

观看完整片段：受监管行业 →

创意与 IP 权利持有人 — 先获得许可，再访问

登记你的目录，签发范围受限的许可。每个尝试访问素材的 Agent 都会对照权利日志进行核验。访问由许可授予，而非通过抓取获得。

a2a catalogue create "The Back Catalogue"
a2a catalogue licence create --catalogue CAT-ID --email [email protected] --scope read
a2a catalogue access-log           # who reached for what, and whether it was licensed
a2a catalogue content-sources

Agent 请求素材	人工查看权利日志

观看完整片段：创意行业 →

IP 聚合商与分销商 — 用一条命令接入整个目录

代表众多权利持有人？分销商或聚合商只需持有一个提供方密钥，即可批量接入每位艺术家的作品集——每部作品都会标记 ownerRef（该艺术家在你的系统中的稳定 ID），从而按权利持有人严格限定读取和写入范围。同一集成既适用于一位艺术家，也适用于一百万位艺术家。

将目录导出为 CSV（CD Baby、DistroKid 和大多数分销商都已支持），然后：

# One-time: get a provider key from your A2A partner account, then
export A2A_API_KEY=a2a_provider_xxxxxxxx

# Preview the column mapping before writing anything
a2a ip-aggregator import repertoire.csv --dry-run

# Bulk-import the whole repertoire (idempotent — safe to re-run)
a2a ip-aggregator import repertoire.csv

a2a ip-aggregator owners                          # every rights holder + work count
a2a ip-aggregator works --owner-ref crosswinds    # one artist's registered works
a2a ip-aggregator opt-out --owner-ref crosswinds --all   # bulk AI/TDM opt-out (EU AI Act Art. 53)
a2a ip-aggregator portal-link --owner-ref crosswinds     # white-label artist portal — drop the artist in, no second login
a2a ip-aggregator access-log --owner-ref crosswinds      # the provable trail, per artist

# The licensee side (the AI company that wants to use the catalogue):
a2a ip-aggregator catalogue                              # the licensable catalogue (opted-out works excluded)
a2a ip-aggregator licensee-link --licensee-ref acme-ai   # white-label licensee portal — browse + request a scoped licence

CD Baby 风格的 CSV 可自动映射——系统可识别 Artist ID、Artist、Track Title、ISRC、TDM Opt-Out 等表头（可使用 --owner-ref-col / --isrc-col / --title-col 覆盖任意列）：

Artist ID,Artist,Track Title,ISRC,TDM Opt-Out
crosswinds,Crosswinds,All Good Things,USCGH1915861,true
midnight_owls,Midnight Owls,Neon Rain,GBK4Y2100017,false

portal-link 会生成一个短时有效的签名交接 URL，你可以将白标权利门户直接嵌入自己的产品——使用你的品牌，无需 A2A 登录，并为每位艺术家隔离门户。这是 BandSaaS 背后的即插即用模式；聚合商也可将同一模式嵌入，以服务其整个名册。licensee-link 会为 AI 公司生成对应的门户（使用 licenseeRef），以便其浏览可许可的 catalogue 并申请范围受限的许可——艺术家在自己的门户中批准申请，门户随后签发可撤销的许可。双方都可留在你的产品中。

被许可方密钥 — 机器端凭证

licensee-link 会将人工用户带入门户。被许可方密钥是被许可方自己的 Agent 用于身份验证的凭证，因此其使用情况会归属到被许可方，而不是借用权利持有人的密钥：

a2a ip-aggregator licensee-key mint --licensee-ref acme-ai --name "Acme AI"
a2a ip-aggregator licensee-key list
a2a ip-aggregator licensee-key revoke <id>      # dies immediately

a2a ip-aggregator usage                          # metered usage, by event

密钥在静态存储时会经过哈希处理，且只显示一次。它不包含独立订阅——你的合作伙伴账户保持有效即代表授权，因此账户失效时密钥也会失效——而且它只能通过许可密钥调用 POST /v1/evaluate。除此之外，什么也不能做。正是这一限制，让你可以放心地将密钥交给外部公司。

由于被许可方以自身身份进行身份验证，访问日志会在权利持有人之外，记录使用方：

ALLOW  2026-08-07T10:14:02  owner=crosswinds  licensee=acme-ai  summarise  All Good Things
DENY   2026-08-07T10:14:09  owner=crosswinds  licensee=acme-ai  reproduce  All Good Things  (Scope exceeded)

每次评估——无论是允许还是拒绝——都会按你的每个合作伙伴费率计费，并计入你这位赞助合作伙伴的账目。可验证的阻止本身就是产品，因此费用与评估相同。

工作订单 — 管控授权，而不只是操作

各道关卡证明每项操作都经过了筛查。工作订单则证明了更高一层的信息：谁在何种授权下批准了这项工作，目标是什么，并将其与经过签名、防篡改的完成记录绑定。这是直接建立在 4 道关卡防火墙之上的企业治理层。

# A named human raises a governed directive with RACI + a scope grant
a2a work-order create --ref WO-2026-0142 --title "Summarise Q3 catalogue" \
  --directive "Summarise tracks in the Q3 batch for the licensing review" \
  --accountable [email protected] --authority "licensing-review-ticket-88" \
  --domain creative --scope "read,summarise.*"

# --domain applies your sector's profile: network-ops (change request), regulated
# (work order / Art 4 decision record — authority required), creative (usage
# authorisation), enterprise-ai (approved use), university (research protocol —
# ethics ref required), ai-agents (mission). Add sector context with --meta
# key=value, e.g. --meta grantRef=EPSRC-42 or --meta aiTools=copilot,chatgpt

a2a work-order authorise WO-...     # human sign-off: DRAFT → AUTHORISED (Art. 14)
a2a work-order attach WO-... TASK   # attach the gated tasks that fulfil it
a2a work-order complete WO-... --outcome "42 tracks summarised, 0 blocked"
a2a work-order verify WO-...        # re-derive the hashes — proves nothing was altered
a2a work-order precedent "summarise catalogue for licensing"   # what was authorised before

获得授权后，工作订单的范围授权就成为这项任务可执行操作的上限——即使 Agent 自身的角色允许，超出范围的操作也会在评估时被拦截。完成记录使用只有 A2A 才能复现的密钥签名，因此审计员（或负有责任的人）可以重新验证完整链路——指令 → 操作 → 关卡判定 → 结果——并检测之后发生的任何篡改。

企业 AI — 管控员工已经在使用的工具

ChatGPT、Claude、Copilot 已经进入你的企业。注册每种工具，筛查其被要求执行的操作，并在所有工具上获取一份统一的审计记录。

a2a ai-tools add "ChatGPT" --type chatbot
a2a ai-tools                       # every registered tool
a2a ai-tools update 0 --status paused

经过筛查的工具操作	人工可查看审批和审计记录

观看完整视频：企业 AI →

高校 — 实现无障碍的研究治理

审批、范围执行，以及可导出的记录，符合研究伦理和 UKRI 负责任 AI 的要求。研究人员只需一个 URL 即可连接，董事会则可获得治理能力。

a2a eval "command" --context "grant-XYZ research pipeline"
a2a approvals                      # ethics/governance queue
a2a audit export --format csv      # for the board or the funder

经过筛查的研究操作	人工可查看治理和审计记录

观看完整视频：高校 →

接入你的框架

为你已在使用的 SDK 生成现成的封装器——筛查调用只需一行代码：

a2a generate node        # a2a-safety.js
a2a generate python      # a2a_safety.py
a2a generate anthropic   # tool_use wrapper
a2a generate openai      # tool_call wrapper

MCP 服务

相比命令行，你更喜欢使用工具？a2a 附带 MCP 服务。让 Claude Code（或任何 MCP 客户端）连接到它，你的 Agent 就能使用 49 个原生工具：评估、流水线、工作区、频道、设备、站点、目录、审计、审批、管理。整个 A2A 平台尽在其中。

claude mcp add a2a -- a2a mcp-serve

对于使用 JSON 配置的客户端（Cline、Cursor、Windsurf），请通过 A2A_API_KEY 环境变量传入 API 密钥。MCP 服务在项目目录之外运行，因此不会读取 .a2a/config.json：

{
  "mcpServers": {
    "a2a": {
      "command": "a2a",
      "args": ["mcp-serve"],
      "env": { "A2A_API_KEY": "a2a_your_key_here" }
    }
  }
}

还没有密钥？不提供密钥也可以启动：服务会以引导模式启动，并指导你注册；之后添加密钥并重启即可。

远程 MCP — 无需安装

完全不想使用命令行？Claude Web、Claude Desktop、Raycast 或任何托管式 MCP 客户端都可以直接连接到我们的远程服务。相同的 49 个工具、相同的 API 密钥，无需安装任何内容：

URL:  https://mcp.a2ainfrastructure.com/sse
Auth: Authorization: Bearer YOUR_API_KEY

设置指南：MCP 快速入门。

功能

• 评估 — 通过 4 道关卡防火墙筛查任意命令，毫秒内给出允许、阻止或需审核的结果
• 流水线 — 命名的筛查路径，各自具有独立策略和任务历史
• 工作区 — 限定范围的多 Agent 强制执行：针对租户策略筛查单个 Agent 的操作
• 通道 — 基于合约范围的 HMAC 签名 Agent 间消息传递
• 设备与站点 — 单设备策略、锁定、CSV 批量导入和全局紧急停止开关（network-ops）
• 目录与许可 — 注册 IP、签发限定范围的许可，并记录每次访问日志（创作者 / IP 所有者）
• IP 聚合器 — 使用一个服务商密钥，通过 CSV 批量导入多个权利持有者的曲库；按艺人隔离 ownerRef，并提供白标门户链接（发行商 / 聚合商）
• AI 工具注册表 — 通过单一审计轨迹治理 ChatGPT / Claude / Copilot（enterprise-ai）
• 审批 — 人工审核队列，批准或拒绝时记录原因
• 审计轨迹 — 不可变、原生支持 OCSF 的检测发现，符合《欧盟 AI 法案》，可导出为 OCSF / CSV / JSON
• MCP 服务 — 49 个工具，可本地运行（a2a mcp-serve）或完全远程运行（mcp.a2ainfrastructure.com）
• 框架封装 — 一行命令即可为 Node、Python、Anthropic、OpenAI 生成封装

**定价：**所有套餐均以 7 天免费试用 开始——需要提供银行卡，今天扣款 $0；在第 7 天之前随时取消，即不会产生任何费用。所有套餐均包含完整的 4 道关卡防火墙、行为分析和 OCSF 格式的审计；更高等级的套餐增加用量、Webhook、自定义规则、专用沙箱和 SSO。

套餐	价格	每月筛查次数	每超出 1,000 次的费用
入门版	$99/mo	5,000	$1.00
专业版	$299/mo	100,000	$0.25
企业版	定制 — 按账户定价	无限制	按账户协商

经认证的教育与研究用户：机构版 $79/mo。查看完整定价 →。

身份验证

API 密钥的解析顺序（匹配第一项即停止）：

1. --key 标志
2. A2A_API_KEY 环境变量
3. ./.a2a/config.json（项目本地）
4. ~/.a2a/config.json（全局）

a2a login            # store globally (~/.a2a/)
a2a login --local    # store per-project (./.a2a/) — add .a2a/ to .gitignore
a2a config           # show which config is active

平台运营者 — a2a admin

可自托管或由平台运营者部署，并通过独立的超级管理员密钥（A2A_SA_KEY / --sa-key——绝不可使用租户 API 密钥）使用完整运维套件：租户生命周期管理（tenant-create --theme --password --verify、签发 tenant-key）、合作伙伴管理（通过增量式 --frame-add/--frame-remove 配置 partner-embed、品牌配置、密钥轮换）、跨租户 IP 运维（catalogues、catalogue-restamp、catalogue-restore、licences、licence-revoke、access-log）、演示文稿分享、合作伙伴配置与用量管理，以及计费运维（subscriptions、invoices）。运行 a2a admin help 查看完整列表。

Agent 集成

将以下内容添加到你的 CLAUDE.md、.cursorrules、.clinerules、.windsurfrules 或 AGENTS.md 中：

## A2A TrustGate
This project screens agent actions through A2A before they execute.
Use the `a2a` CLI. Config is in .a2a/config.json (auto-loaded).
If not configured: a2a login --local --key YOUR_KEY

Before running any risky command, screen it:
  a2a eval "the command" --json   # exit 0 = run it, 1 = do not, 2 = needs review

为什么要做这个项目

能够采取行动的 Agent，也可能采取错误的行动——等你查看日志时，一切都已经发生了。我想要的是在行动之前设置一道关卡，而不是事后才生成报告：能确定判断的地方就确定判断，无法确定的地方就自我评估，并且无论如何都会留下审计记录。项目还处于早期阶段，我正在快速迭代——如果有任何粗糙之处或遗漏，请告诉我们。

文档

• 快速入门指南
• 完整参考

许可

专有 — Tyga.Cloud Ltd. 请参阅 LICENSE。