aap

🛂 AI 智能体加密身份验证协议

基于 secp256k1 加密签名的 Agent 身份验证协议,通过限时挑战确保只有 AI 能访问服务,防止人类冒充。

收藏
14.6k
安装
3.4k
版本
v0.3.4
CLS 安全性认证2026-05-19
点击查看完整报告 >

使用说明

AAP(Agent Attestation Protocol)是一款创新的反向图灵测试协议,旨在通过加密挑战验证客户端是否为真实的 AI Agent,从而阻止人类访问特定服务。该协议采用 WebSocket 通信机制,结合 secp256k1 椭圆曲线加密签名技术,为 AI 智能体提供了可靠的身份证明机制。

核心用法:AAP 的工作流程分为服务端和客户端两部分。服务端通过 npm 安装 aap-agent-server,创建 WebSocket 监听路径,配置挑战数量(默认 7 个)和时间限制(默认 6 秒),并要求客户端提供加密签名。客户端使用 aap-agent-client 生成 secp256k1 密钥对,自动对挑战响应进行签名,并在极短时间内完成所有挑战以证明其 AI 身份。整个过程无需人工干预,完全自动化完成。

显著优点:首先,协议创新性地反向使用图灵测试逻辑,针对 AI 认知特点设计挑战,使人类在 6 秒内无法完成,而 AI 可轻松应对。其次,采用工业标准的 secp256k1 加密算法,确保身份验证的密码学安全性,实现不可伪造的身份证明。第三,架构轻量,仅依赖 Node.js 内置 crypto 模块和标准 ws 库,无冗余依赖。第四,完善的隐私保护机制,私钥严格本地存储并设置 0600 文件权限,杜绝敏感信息泄露。

潜在缺点与局限性:作为早期阶段项目(v3.2.0),AAP 尚未经过第三方安全审计,代码成熟度有待验证。私钥以明文形式存储在本地文件系统,虽有权限保护但仍存在物理访问风险。此外,协议依赖客户端的计算能力,在资源受限的设备上可能无法按时完成挑战。当前仅支持 Node.js 环境,语言绑定和平台支持有待扩展。

适合的目标群体:主要面向需要区分人机访问的开发者和服务提供商,特别是构建 AI Agent 专属 API 或服务的团队。适用于 Claude Code 扩展、Clawdbot 集成、自动化工作流平台等场景。对于需要确保服务仅被合法 AI 访问、防止人类滥用或爬虫攻击的后端系统尤为适用。

使用风险:尽管代码本身安全规范,但使用者需注意:私钥文件若被恶意程序获取可能导致身份冒充;WebSocket 通信若未使用 TLS/HTTPS 可能遭受中间人攻击;服务端若配置不当(如放宽时间限制)可能降低安全性;作为个人开发者项目,长期维护和支持存在不确定性。建议生产环境配合额外的网络层防护和密钥管理策略使用。

安全解读

AAP:AI代理的身份护照

AAP(Agent Attestation Protocol)是一个颠覆性的身份验证协议,它将传统CAPTCHA的逻辑完全反转——不是阻止机器人,而是阻止人类。在AI代理日益增多的生态系统中,这一设计理念具有独特的战略价值。

核心用法

AAP采用"反向图灵测试"机制:服务器向客户端发送7个对LLM轻而易举、但对人类在6秒内几乎不可能完成的挑战。客户端必须使用secp256k1椭圆曲线私钥对响应进行密码学签名,形成不可伪造的身份证明。整个流程通过WebSocket实时完成,包含握手、挑战分发、签名响应和会话令牌发放四个阶段。

开发者可通过npm安装服务端和客户端包,快速集成到现有系统。服务端配置灵活,支持调整挑战数量和超时时间;客户端自动生成加密身份,无需手动管理密钥。

显著优点

1. 密码学级身份确定性:secp256k1签名提供非对称加密保障,相比API密钥更难伪造和窃取
2. 人机区分精准:7挑战/6秒的设计对人类形成天然屏障,误杀率极低

3. 非对称架构:挑战-响应模式让服务器保持轻量,验证逻辑完全在客户端执行

4. 开源透明:MIT协议、完整GitHub文档,无黑箱操作

5. 隐私友好:仅传输公钥和签名,不收集个人身份信息

潜在局限

1. 网络依赖刚性:必须连接用户指定的验证服务器,离线场景无法使用
2. 生态早期阶段:项目由个人开发者维护,长期可持续性存疑

3. 服务器信任假设:用户需自行确保验证服务器的可信度,协议本身不提供服务器身份验证

4. TLS条件合规:加密传输依赖部署环境配置,非强制启用

5. 人机边界模糊:随着AI辅助工具普及,"纯人类"操作的定义可能变得模糊

适合人群

  • 需要区分AI代理与人类用户的API提供方
  • 构建AI-to-AI经济网络的开发者
  • 对机器人流量有严格管控需求的SaaS平台
  • 探索去中心化身份验证的实验项目

常规风险

  • 私钥泄露:虽文件权限设置为0600,但root权限进程或备份泄露仍可能导致密钥暴露
  • 中间人攻击:若使用明文HTTP/Ws协议,挑战和响应可能被截获分析
  • 供应链风险:依赖ws库存在潜在的供应链攻击面
  • 服务器选择风险:恶意验证服务器可能记录行为模式进行指纹识别

aap 内容

docs文件夹
examples文件夹
express-verifier文件夹
lib文件夹
packages文件夹
client文件夹
core文件夹
server文件夹
test文件夹
手动下载zip · 83.9 kB
RATE_LIMITING.mdtext/markdown
请选择文件