@ agenticprimitives/ap-kms (英语)
部分 代理先导 ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. 开发者工具包 • 妇女 所有软件包
具有代表性的管理型KMS管弦乐手。 一个声明 kms.manifest.json 是单源
程序签名身份的真相; ap-kms apply 然后采取每一个步骤让 Cloud-KMS 签名工作:
- 备抵 键盘 + 每名身份的 HSM secp256k1 签名键 + 每名身份的 IAM(无克云的 REST,通过)
@agenticprimitives/key-custody/provision-gcp(原始内容存档于2018-10-21) (中文(简体) ). 同上. - 衍生+报告 每个键的EVM地址(接通前验证).
- 决定 每一个代理名称 其智能代理地址(
@agenticprimitives/agent-naming) (中文(简体) ). - 线 每个部署目标通过一个 应用程序提供的秘密作家 没有
终端回声——
--write。管弦乐器为提供-不可知码;混凝土部署平台码 (Cloudflare/Vercel/.)生活在应用程序中,被注射为:writeSecret(ADR-0020) (英语).
人类的一步 它从来没有做 拥有者签名的代表团 (Smart Agent → KMS 密钥),生产
由内容签名仪式进行. ap-kms apply 逐个报告其是否受约束; ap-kms verify
证实每个探员的 现场直播 KMS 代表(来自密钥)仍然等于 拥有者授权 代表
存储在部署的绑定物中,存储的SA与名称的链上分辨率相匹配.
设计
核心(@agenticprimitives/ap-kms)为 纯 ——提供方,名称解析方,地址衍生方,
存储的绑定阅读器, 和秘密作家都是 已注射 (单位:千美元)KmsOrchestratorDeps) (中文(简体) ). 一直这样
key-custody 叶子和可测试的管弦乐 节点接线@agenticprimitives/ap-kms/node(中文(简体) )
组装提供者-不可知执行(提供/衍生/解析/绑定阅读器)和
fs 显示装载器 部署平台秘密写入器留在应用程序中 并注入:
import { applyKmsManifest } from '@agenticprimitives/ap-kms';
import { loadManifest, makeNodeDeps } from '@agenticprimitives/ap-kms/node';
import { writeSecret } from './my-app-secret-writers.js'; // app-owned: switches on deployment.platform
const manifest = loadManifest('kms.manifest.json');
await applyKmsManifest(manifest, makeNodeDeps(manifest, { writeSecret }), { write: true });
deployment.platform 是一个不透明的标签; 应用程序的 writeSecret(deployment, name, value) 决定如何
推出这个秘密(例如工人的秘密CLI,托管-提供REST API). 没有提供者主机名或
供应商专用代码在此包中活化.
国 际
ap-kms apply # provision + IAM + derive + resolve SA + REPORT (no secret writes)
ap-kms apply --write --writers ./w.js # also push runtime secrets via the app-supplied writer module
ap-kms apply --dry-run # print the plan only (no GCP mutations)
ap-kms verify # read-only drift check vs. stored owner-authorized delegations
ap-kms <cmd> --manifest path/to/kms.manifest.json
--writers <module> 正在动态导入,必须导出 writeSecret(deployment, name, value) (或
默认导出它)。 命名的 RPC URL 来自于由 Env var 命名的 Env var manifest.naming.rpcUrlEnv (安静)
包含 API 键.