SuperAPI AI 工具集

use-link-identity

智能体与模型

查看项目

更新于 10-16 09:59

技能介绍

用途:当服务接受 Link 证明或签名用户声明时,使用 Link CLI 身份命令获取并使用相应凭据。命令处于 beta,出现在 link-cli identity --help 中,无需 preview 标志。

主要能力:

  • AAT:通过 WWW-Authenticate: PrivateToken 请求,JSON 字段 authorization 对应 HTTP 头 Authorization。
  • 签名声明:通过 WWW-Authenticate: Identity-Presentation 请求,字段 presentation 对应头 Identity-Presentation。AAT 证明由 Link 签发而不披露用户声明;出示会披露所选声明并证明持有者密钥对受众与 nonce 的占有。服务同时要求时,发送两个头。

使用方式:需 Link Agent Wallet v0.27.0 或更高版本。用 link-cli --version 检查;若过旧或缺失,用 npm install -g @stripe/link-cli@latest 安装或更新。身份命令通过 CLI 提供,不在其 MCP 工具中。仅 request 需要 Link 认证;list、pop、present 使用本地文件。

示例命令: link-cli identity attestations list --format json link-cli identity attestations request --count 10 --format json link-cli identity attestations pop --format json link-cli identity credentials list --format json link-cli identity credentials request --format json link-cli identity credentials present --aud 'https://service.example' --nonce '<nonce-from-challenge>' --claim email --format json

用 --format json 捕获输出并用 JSON 解析器或 jq 解析,把确切证明传给 HTTP 客户端或浏览器自动化;不要手工转写、重建或重新编码令牌与出示。

限制:只有 storage 为 pool 的条目可 pop;已 pop 的令牌不会回到池中。缓存身份文件属于主目录,切换 --auth 或换用户登录不会切换缓存身份,不同用户需使用独立主目录。present 的三个选项均必填,nonce 消耗或过期后需重新获取挑战。不要将证明、私钥和声明值放入日志或转录中,交接文件应使用严格权限。常见错误包括 ATTESTATION_POOL_EMPTY、声明不可用、持有者密钥缺失或不匹配、受众或 nonce 被拒。未提供的细节暂未说明。