gate-authority-network

GATE — 权限验证网络

Stage 17 开发者预览版 · 已有公开用户采用

此主体到该执行者的实时委托路径此刻是否仍然存在？

GATE 是面向跨信任域委托 Agent 的实时权限状态解析器。

它使用来自外部信任域的实时权限状态，在实际生效时解析当前是否仍存在有效的权限路径。GATE 不会签发专有委托令牌、取代 OAuth、取代你的策略引擎，也不要求使用 MCP。

GATE Stage 17 — 当前开发者预览版

当前运行边界： 一个加拿大主数据库，没有生产环境区域副本，且没有独立的第三方颁发者传播 SLA。maxStalenessMs 仅衡量主数据库快照的时效。此开发者预览版尚未达到企业级 GA。

• 从托管沙盒开始 — 使用合成图学习 GATE 撤销语义。
• 创建真实的 Free GATE Network 项目 — 使用真实 API 密钥和托管配额连接实时 gate-network。
• 连接你自己的 ES256 权限来源。
• Stage 16 冻结版公开基线发布。
• Stage 17E Free → 付费的连续性与计费强化。
• Stage 17D 外部问题验证。
• 生产环境／预览版运行边界。
• 当前 API、拓扑结构与限制。

Stage 17 已验证真实的 Free 用户引导流程、独立的 CAEP/SSF 撤销互操作性、外部问题验证，以及从 Free 到付费的权益连续性。GATE 仍处于开发者预览阶段；接下来的验证目标是独立用户采用和企业级规模运营。

GATE 的定位

Identity / credentials / policy / issuer systems
                      |
                      | authority state + trust signals
                      v
             +-------------------+
             |       GATE        |
             | live authority    |
             | state resolver    |
             +-------------------+
                      |
                 gate.verify()
                      |
                      v
             trusted effect boundary

GATE 可与身份、凭证、策略和网关系统协同使用。MCP 只是其中一种集成方式，并非 GATE 的定义。

其差异化优势不只是支持多跳，而是结合了上游实时撤销、备用路径保留、联合颁发者状态、新鲜度语义，以及与协议无关的生效时解析。

请阅读：docs/POSITIONING.md、docs/INTEGRATION-MODEL.md、docs/RELEASE-BOUNDARY.md。

开发者公开快速入门

GATE 提供两种独立的入门方式。

沙盒

使用托管沙盒，在合成权限图上了解 GATE 的语义：

https://gate-phi-eosin.vercel.app/quickstart.html

临时密钥：7 天。配额：每天每个项目 500 次验证。

实时 Free Network

规范端点：

https://ufqtoyakmrddqytrkcje.supabase.co/functions/v1/gate-network

当前 Free 开发者预览版：每月 50,000 次验证、1 个权限颁发者、一致性受限。不包含严格一致性。

使用 @gate-avn/sdk 中的 GateClient。完整的实时网络流程请参阅 docs/QUICKSTART.md。

5 分钟演示

要求：Node.js 20+。

npm install
npm test
npm run demo

演示会调用公开 SDK 接口：

import { GateClient } from './packages/sdk/dist/index.js';

const gate = new GateClient({ endpoint: process.env.GATE_URL });

const result = await gate.verify({
  principal: 'user:jerome',
  actor: 'agent:C@company-c',
  action: {
    protocol: 'mcp',
    name: 'delete_customer_data',
    resource: 'customer:3456'
  },
  consistency: 'bounded',
  maxStalenessMs: 200
});

if (result.decision !== 'ALLOW') throw new Error(result.reason);

GATE 验证的内容

GATE 回答一个范围刻意限定的问题：根据足够新鲜的外部权限状态，该执行者是否仍至少拥有一条来自主体的实时委托路径。

公开契约将权限状态与应用策略区分开来。凭证在语法上仍然有效，但 GATE 仍可能返回 INVALID 或 UNKNOWN，因为其背后的权限已不再有效，或无法按照所请求的新鲜度要求得到确认。

可能的返回结果：

• VALID / ALLOW — 至少存在一条有效权限路径。
• INVALID / DENY — 已知路径均已撤销／无效。
• UNKNOWN / DENY — 新鲜度或可用性不足，无法满足所请求的一致性契约。

GATE 不做什么

GATE 不是你的业务策略 PDP。在此预览版中，携带操作对象是为了集成／审计上下文；“此主体是否可以删除客户 3456？”之类的策略应由 AuthZEN、Cedar、OPA、Permit、Cerbos、OpenFGA 或你现有的授权系统处理。

GATE 也无意取代 OAuth、MCP、A2A、OpenID Federation、Security Event Tokens、Shared Signals、IdP 或 API／AI 网关。它的预期角色是在这些系统之下／旁边，充当实时权威状态解析器。

Developer Preview 不声称提供可移植的加密签名权威证明。它会返回实时解析结果；签名的 GATE 收据可能成为未来的一层，但并非当前版本的承诺。

为什么需要网络服务？

本地验证器可以验证签名、到期时间、范围和令牌链。但它无法独立获知每个外部颁发方当前的撤销状态、信任变更、替代委托路径或跨域新鲜度。GATE 的假设是，站得住脚的价值在于共享的低延迟状态网络，而不是秘密的验证算法。

一致性契约

• bounded：在 v7 上从规范主节点进行实时验证，并限制主节点读取快照的时效；尚未部署区域副本。
• strict：仅符合条件的计划可使用规范主节点读取验证；不代表会同步确认外部颁发方系统。

仓库结构

packages/sdk/      public developer-facing client
examples/          minimal SDK demonstration
services/          experimental control plane / edge / trust services
src/               PoC verification primitives
mcp/               MCP enforcement harness
test/              SDK + distributed consistency tests
docs/              architecture, integration contract, due diligence

安装

SDK

npm install @gate-avn/sdk@dev

仓库 Stage 16 基线：0.1.0-dev.4

已发布的 npm @dev 版本：0.1.0-dev.3

MCP 服务

npm install @gate-avn/mcp@dev

仓库 Stage 16 基线：0.1.0-dev.8

已发布的 npm @dev 版本：0.1.0-dev.5

Official MCP Registry：

io.github.Projetxana/gate-authority-network

状态

GATE 已通过 npm 和 Official MCP Registry 以 Developer Preview 形式公开提供。

SDK 和 MCP 服务目前可从公共 npm 注册表安装。也可以通过 Official MCP Registry 查找到 MCP 服务。

HTTP、x402、AuthZEN、A2A、AP2 和 SSF 适配器已存在于 Stage 16 仓库基线中，但尚未作为公共 npm 包发布。

这仍是实验性的 Developer Preview 软件，尚未达到生产就绪状态。

接下来请阅读：docs/STAGE17D-EXTERNAL-VALIDATION.md、docs/STAGE17E-FREE-PAID-CONTINUITY.md、docs/DUE-DILIGENCE-2026-10-02.md 和 docs/PUBLIC-VALIDATION-PLAN.md。

许可证

Apache-2.0。本仓库旨在让验证逻辑易于检查和质疑；长期的产品假设是共享的实时权威网络，而非专有验证器代码。