@bedrock/kms-http

中文文档

23.4.0发布于 2026/11/07ES Module近 30 天下载 1964

贝德洛克 KMS HTTP API

文档目录9 节

目录
安装
国家预防机制
发展
使用量
KMS HTTP API (韩语)
贡献
商业支助
许可证

Bedrock 密钥管理系统 API 模块 (@bedrock/kms-http) (中文(简体) )

HTTP 为 Bedrock 密钥管理服务的API.

安装

这个软件需要并支持维持了最新版本的Node.js. 更新可能会去除对旧的未维护的平台版本的支持. 请使用依赖版本锁定文件和测试以确保与此兼容软件.

国家预防机制

通过国家预防机制安装:

npm install @bedrock/kms-http

发展

在当地安装(用于开发):

git clone https://github.com/digitalbazaar/bedrock-kms-http.git
cd bedrock-kms-http
npm install

使用量

单位 lib/index.js (或 main.js酌情:

import '@bedrock/kms-http';

KMS HTTP API (韩语)

这个模块暴露出以下API端点.

创建 keystore - `POST /kms/keystores`

请求示例 :

{
  sequence: 0,
  controller: 'did:key:z6MkoyZVQSetDxU66AsfinUPzgSEu5N9Jf1anHEY4YCzcE54',
  meterId: 'https://localhost:18443/meters/z19ygjQcNmQ9AbG7hCF39Kizs',
  kmsModule: 'ssm-v1'
}

页眉

{
  accept: 'application/ld+json, application/json',
  host: 'localhost:18443',
  'capability-invocation': 'zcap id="urn:zcap:root:https%3A%2F%2Flocalhost%3A18443%2Fkms%2Fkeystores",action="write"',
  digest: 'mh=uEiAWwH_YYtljJn-tba5XZ_s5k9lcFoJW9Mg8EdPY3ShEvQ',
  'content-type': 'application/json',
  authorization: 'Signature keyId="did:key:z6MkoyZVQSetDxU66AsfinUPzgSEu5N9Jf1anHEY4YCzcE54#z6MkoyZVQSetDxU66AsfinUPzgSEu5N9Jf1anHEY4YCzcE54",headers="(key-id) (created) (expires) (request-target) host capability-invocation content-type digest",signature="hTFuyAyfdwmTRJ1DmK2AVgDZ+RCQYsc5n9YF///5t4QY3VaTtUGWRDWQHRTSMGHybda782fCW9XczmIJEMfFDQ==",created="1638504433",expires="1638505033"'
}

反应实例:

{
  id: 'https://localhost:18443/kms/keystores/z1AByGXEmfZnyG8rgM3aVpYxG',
  meterId: 'https://localhost:18443/meters/z19ygjQcNmQ9AbG7hCF39Kizs',
  sequence: 0,
  controller: 'did:key:z6MkoyZVQSetDxU66AsfinUPzgSEu5N9Jf1anHEY4YCzcE54',
  kmsModule: 'ssm-v1'
}

更新 Keystore 配置 - `POST /kms/keystores/:keystoreId`

请求示例 :

{
  controller: 'did:key:z6MknP29cPcQ7G76MWmnsuEEdeFya8ij3fXvJcTJYLXadmp9',
  id: 'https://localhost:18443/kms/keystores/z19xPXyqB3dnqKZ7BtVFvqSLH',
  sequence: 1
}

页眉

{
  accept: 'application/ld+json, application/json',
  host: 'localhost:18443',
  'capability-invocation': 'zcap id="urn:zcap:root:https%3A%2F%2Flocalhost%3A18443%2Fkms%2Fkeystores%2Fz19xPXyqB3dnqKZ7BtVFvqSLH",action="write"',
  digest: 'mh=uEiDiFdv-C0VNNIvltnoIxwqUA5crG1H42OyvQtPRa7mjvw',
  'content-type': 'application/json',
  authorization: 'Signature keyId="did:key:z6MkqnGN2jgckeejguN28RE1SM5a1rwu9nigkY5PhSQuTybX#z6MkqnGN2jgckeejguN28RE1SM5a1rwu9nigkY5PhSQuTybX",headers="(key-id) (created) (expires) (request-target) host capability-invocation content-type digest",signature="6i3yXShQMQ8H+XFJpUEi0WcO7hcrcpdApuyU2WrSAm0bMuAby+pZKSt+ACBWRrpocEaxAa6lwefvtGVYVXO7BQ==",created="1638505029",expires="1638505629"'
}

反应实例:

{
  success: true,
  config: {
    controller: 'did:key:z6MknP29cPcQ7G76MWmnsuEEdeFya8ij3fXvJcTJYLXadmp9',
    id: 'https://localhost:18443/kms/keystores/z19xPXyqB3dnqKZ7BtVFvqSLH',
    sequence: 1,
    meterId: 'https://localhost:18443/meters/z19zMxFgrtXrR3RArhogVQ78T',
    kmsModule: 'ssm-v1'
  }
}

获取 Keystore 配置 - `GET /kms/keystores/:keystoreId`

请求示例 :

页眉

{
  accept: 'application/ld+json, application/json',
  host: 'localhost:18443',
  'capability-invocation': 'zcap id="urn:zcap:root:https%3A%2F%2Flocalhost%3A18443%2Fkms%2Fkeystores%2Fz1A2Dahs56An4rttS3t2QKi69",action="read"',
  authorization: 'Signature keyId="did:key:z6MkoyZVQSetDxU66AsfinUPzgSEu5N9Jf1anHEY4YCzcE54#z6MkoyZVQSetDxU66AsfinUPzgSEu5N9Jf1anHEY4YCzcE54",headers="(key-id) (created) (expires) (request-target) host capability-invocation",signature="P8ZYsAO/oQPllqRCW4GJdKwHhGfk53li88pzySd2jJVhNJCkxwPVNTGS0CsK/tK1cLvwjUABUqO2VUlP//T3DA==",created="1638505290",expires="1638505890"'
}

反应实例:

{
  id: 'https://localhost:18443/kms/keystores/z1A2Dahs56An4rttS3t2QKi69',
  meterId: 'https://localhost:18443/meters/z19zMxFgrtXrR3RArhogVQ78T',
  sequence: 0,
  controller: 'did:key:z6MkoyZVQSetDxU66AsfinUPzgSEu5N9Jf1anHEY4YCzcE54',
  kmsModule: 'ssm-v1'
}

生成新密钥 - `POST /kms/keystores/:keystoreId/keys`

请求示例 :

{
  '@context': [
    'https://w3id.org/webkms/v1',
    'https://w3id.org/security/suites/ed25519-2020/v1'
  ],
  type: 'GenerateKeyOperation',
  invocationTarget: { type: 'Ed25519VerificationKey2020' }
}

标题 :

{
  accept: 'application/ld+json, application/json',
  host: 'localhost:18443',
  'capability-invocation': 'zcap id="urn:zcap:root:https%3A%2F%2Flocalhost%3A18443%2Fkms%2Fkeystores%2Fz19mH7zKauTKBWS3831MyWM2f",action="generateKey"',
  digest: 'mh=uEiC4fs8V2JzjgB25wxRhyKGc17b0yu-JvjnYF6IutYMEzQ',
  'content-type': 'application/json',
  authorization: 'Signature keyId="did:key:z6MkoSN3SbRHZAFdYwphhgHhuLXdBCMu7Yoam5H436b1PZAp#z6MkoSN3SbRHZAFdYwphhgHhuLXdBCMu7Yoam5H436b1PZAp",headers="(key-id) (created) (expires) (request-target) host capability-invocation content-type digest",signature="fntyQjEsGMIOwh7OftKS76yJ/1wpx+3eVWJjIToqcfJPOlmuU3DZmbag4bZ3cw3weLg4kDYQNxsJ8nNVtpd4DQ==",created="1638506601",expires="1638507201"'
}

反应实例:

{
  id: 'https://localhost:18443/kms/keystores/z19mH7zKauTKBWS3831MyWM2f/keys/z1A3XvbwPFZ5WceoeXcQMzBZ5',
  type: 'Ed25519VerificationKey2020',
  '@context': 'https://w3id.org/security/suites/ed25519-2020/v1',
  publicKeyMultibase: 'z6MknYsXcwi19ohJKGu5RHzxAkyVDGCP3ggpHY2FqxNFFyZb'
}

在已有密钥上启动 KMS 操作 - `POST /kms/keystores/:keystoreId/keys/:keyId`

请求示例 :

{
  '@context': 'https://w3id.org/webkms/v1',
  type: 'SignOperation',
  invocationTarget: 'https://localhost:18443/kms/keystores/z19zhh4xhWEeBn7u5NXQaeU2e/keys/z1A4nmgJS9XkDAsDDHFhAEba3',
  verifyData: 'aGVsbG8'
}

页眉

{
  accept: 'application/ld+json, application/json',
  host: 'localhost:18443',
  'capability-invocation': 'zcap id="urn:zcap:root:https%3A%2F%2Flocalhost%3A18443%2Fkms%2Fkeystores%2Fz19zhh4xhWEeBn7u5NXQaeU2e",action="sign"',
  digest: 'mh=uEiADFF5OnUq5SCTrVVBSAMP5DpXfSF7f1bIH-SrX6S9Fdw',
  'content-type': 'application/json',
  authorization: 'Signature keyId="did:key:z6MkoyZVQSetDxU66AsfinUPzgSEu5N9Jf1anHEY4YCzcE54#z6MkoyZVQSetDxU66AsfinUPzgSEu5N9Jf1anHEY4YCzcE54",headers="(key-id) (created) (expires) (request-target) host capability-invocation content-type digest",signature="upDUCqfbaIqixWmFjnHq/NIY2/r5TserYAQMOEkiwoUIyHgww/auN+cMYqH7x23cmymfmDIlDqqoE+Pi06j+AQ==",created="1638508033",expires="1638508633"'
}

反应实例:

{ signatureValue: 'qtL549jF562rlea6oQBzIKYCZeOPFX9OBzmn3iSzOpI' }

获取公钥描述 - `GET /kms/keystores/:keystoreId/keys/:keyId`

请求示例 :

页眉

{
  accept: 'application/ld+json, application/json',
  host: 'localhost:18443',
  'capability-invocation': 'zcap id="urn:zcap:root:https%3A%2F%2Flocalhost%3A18443%2Fkms%2Fkeystores%2Fz1AEdRUJm7Ld4xBNBKkAGHjzZ%2Fkeys%2Fz1A5vBtppSSaS1svFyQb6Ezwj",action="read"',
  authorization: 'Signature keyId="did:key:z6MkhRjrvpEAxh8oSWsPgMdP28xvrotsDBCvcwTtbUuUEp38#z6MkhRjrvpEAxh8oSWsPgMdP28xvrotsDBCvcwTtbUuUEp38",headers="(key-id) (created) (expires) (request-target) host capability-invocation",signature="gmB9DXTu29QKO4FlHXcEJGHMjaRpvXosRw+KeShiDB9YU2kwjMdd7eMT15TgeKzN3K5eqbEyEWh0NCgT/ULFAA==",created="1638539438",expires="1638540038"'
}

反应实例:

{
  '@context': 'https://w3id.org/security/suites/ed25519-2020/v1',
  id: 'https://localhost:18443/kms/keystores/z1AEdRUJm7Ld4xBNBKkAGHjzZ/keys/z1A5vBtppSSaS1svFyQb6Ezwj',
  type: 'Ed25519VerificationKey2020',
  publicKeyMultibase: 'z6MkuP4PkTPZy2KvictPAsAHAbH6Umw9tsRJzmpGR65brddP'
}

插入撤销 - `POST /kms/keystores/:keystoreId/revocations/:zcapId`

请求示例 :

{
  '@context': [
    'https://w3id.org/zcap/v1',
    'https://w3id.org/security/suites/ed25519-2020/v1'
  ],
  id: 'urn:zcap:38c42aff-76e0-4624-88dc-0341fe3f9ccd',
  invoker: 'did:key:z6MkootHWoSfwsPz1E3pE3aALJCEiawN1XNf4CPoUNeUEgY8#z6MkootHWoSfwsPz1E3pE3aALJCEiawN1XNf4CPoUNeUEgY8',
  parentCapability: 'urn:zcap:45bbf83c-bb97-474d-9a54-f4dac1e257ad',
  allowedAction: 'sign',
  invocationTarget: {
    publicAlias: 'did:key:z6Mkf8beJEDMQM77i12Siuw8UwuidEin6qvUQH65EBs3VqcW#z6Mkf8beJEDMQM77i12Siuw8UwuidEin6qvUQH65EBs3VqcW',
    id: 'https://localhost:18443/kms/keystores/z19zzGxGeo6Z4FhqhP1ZJZhNp/keys/z19qdYFKqymy8BoPpdfSkeRrZ',
    type: 'Ed25519VerificationKey2020'
  },
  proof: {
    type: 'Ed25519Signature2020',
    created: '2021-12-03T00:54:36Z',
    verificationMethod: 'did:key:z6MkfrMHgiLotA5tX5JqtmQw1WmtmHCay7eY651TQzKdHAcB#z6MkfrMHgiLotA5tX5JqtmQw1WmtmHCay7eY651TQzKdHAcB',
    proofPurpose: 'capabilityDelegation',
    capabilityChain: [
      'urn:zcap:root:https%3A%2F%2Flocalhost%3A18443%2Fkms%2Fkeystores%2Fz19zzGxGeo6Z4FhqhP1ZJZhNp',
      [Object]
    ],
    proofValue: 'z5UMPNnR2sXv5tZ4XVrRjGqwh6zPchrcNBgedXDS4XEnSgeQAFEuiAx89nUcxDZV2e2Tb17cZKoLvyvSdRorKHoHw'
  }
}

页眉

{
  accept: 'application/ld+json, application/json',
  host: 'localhost:18443',
  'capability-invocation': 'zcap id="urn:zcap:root:https%3A%2F%2Flocalhost%3A18443%2Fkms%2Fkeystores%2Fz1ADWeUn1vp2oTr33SaSoiiDj%2Frevocations%2Furn%253Azcap%253A61f9fce0-595d-4763-9854-c5db561e6981",action="write"',
  digest: 'mh=uEiCQYBu8dlESvD_MO4VxN3FcJMuSRg1HRh3B-ciaEHpsxQ',
  'content-type': 'application/json',
  authorization: 'Signature keyId="did:key:z6MkprpMfcYbjbCmhb84TWwhkwevqTX67EQvd7bdLTJ3DkA6#z6MkprpMfcYbjbCmhb84TWwhkwevqTX67EQvd7bdLTJ3DkA6",headers="(key-id) (created) (expires) (request-target) host capability-invocation content-type digest",signature="Z5DUpumlZYK3UplUDjz4szzWf+XO3zHd/Y6/wPMtUQn+7ZxNoLRa7Ny589CNASxYS7kg9Hv9KDF+R8wtiCJhAg==",created="1638492060",expires="1638492660"'
}

贡献

见贡献文件来啊!

公关接受.

请遵照标准读取规格.

商业支助

该图书馆的商务支助可应下列请求提供: 数字集市: 支持@ digitalbazaar.com

许可证

Bedrock 非商业许可证 v1.0 数字集市

版本与发布记录

@bedrock/kms-http 共发布 25 个版本，首次发布于 2022/04/06；过去 12 个月发布了 5 个版本。

版本	发布日期	距今
`23.4.0`latest	2026/11/07	1 天前
`23.3.1`	2026/10/23	16 天前
`23.3.0`	2026/10/21	18 天前
`23.2.0`	2026/04/25	6 个月前
`23.1.0`	2025/11/22	11 个月前
`23.0.0`	2025/10/15	1.1 年前

关于 @bedrock/kms-http 的常见问题

@bedrock/kms-http 是什么？

贝德洛克 KMS HTTP API

如何安装 @bedrock/kms-http？

在项目目录运行 npm install @bedrock/kms-http，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@bedrock/kms（^16.2.0）、@bedrock/core（^6.3.0）、@bedrock/did-io（^10.5.0）、@bedrock/express（^8.8.3）、@bedrock/validation（^7.3.0）、@bedrock/did-context（^6.0.0）、@bedrock/app-identity（^4.2.0）、@bedrock/zcap-storage（^9.7.0）、@bedrock/security-context（^9.0.0）、@bedrock/veres-one-context（^16.0.0）、@bedrock/meter-usage-reporter（^10.3.5）、@bedrock/jsonld-document-loader（^5.2.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

@bedrock/kms-http 支持 TypeScript 吗？

该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bedrock__kms-http 是否存在。

@bedrock/kms-http 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@bedrock/kms-http 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@bedrock/kms-http 可以商用吗？

@bedrock/kms-http 使用未声明许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

@bedrock/kms-http 的下载量有多少？

根据 npm 官方下载统计，@bedrock/kms-http 在 2026/10/08 – 2026/11/06 这 30 天内被下载 1,964 次，日均约 65 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@bedrock/kms-http 还在维护吗？

最新版本 23.4.0 发布于 2026/11/07（1 天前）；至今共发布 25 个版本，其中过去 12 个月发布了 5 个；首次发布于 2022/04/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

npm install @bedrock/kms-http

pnpmpnpm add @bedrock/kms-http
yarnyarn add @bedrock/kms-http
bunbun add @bedrock/kms-http

peer 依赖@bedrock/kms ^16.2.0@bedrock/core ^6.3.0@bedrock/did-io ^10.5.0@bedrock/express ^8.8.3@bedrock/validation ^7.3.0@bedrock/did-context ^6.0.0@bedrock/app-identity ^4.2.0@bedrock/zcap-storage ^9.7.0@bedrock/security-context ^9.0.0@bedrock/veres-one-context ^16.0.0@bedrock/meter-usage-reporter ^10.3.5@bedrock/jsonld-document-loader ^5.2.1

npm 7+ 与 pnpm 8+ 会自动安装必需的 peer 依赖，Yarn 需手动安装。

在你的项目目录中运行此命令。

近 30 天下载

1,964

约 1964 次日均 65 次

统计周期 2026/10/08 – 2026/11/06
数据来自 npm 官方下载统计，今天更新

最新版本23.4.0发布于 1 天前

开源许可未声明未声明

包体积51.3 kB13 个文件 · 解压后

运行依赖9 个另有 12 个 peer 依赖

模块格式ES Module

TypeScript未声明类型可查找 @types/bedrock__kms-http

Node.js>=22

发布版本25 个近 12 个月 5 个

首次发布2022/04/064 年前

元数据更新2026/11/07

每一个软件包背后，
都有分享与创造的人。

@bedrock/kms-http

Bedrock 密钥管理系统 API 模块 (@bedrock/kms-http) (中文(简体) )

目录

安装

国家预防机制

发展

使用量

KMS HTTP API (韩语)

创建 keystore - POST /kms/keystores

请求示例 :

页眉

反应实例:

更新 Keystore 配置 - POST /kms/keystores/:keystoreId

请求示例 :

页眉

反应实例:

获取 Keystore 配置 - GET /kms/keystores/:keystoreId

请求示例 :

页眉

反应实例:

生成新密钥 - POST /kms/keystores/:keystoreId/keys

请求示例 :

标题 :

反应实例:

在已有密钥上启动 KMS 操作 - POST /kms/keystores/:keystoreId/keys/:keyId

请求示例 :

页眉

反应实例:

获取公钥描述 - GET /kms/keystores/:keystoreId/keys/:keyId

请求示例 :

页眉

反应实例:

插入撤销 - POST /kms/keystores/:keystoreId/revocations/:zcapId

请求示例 :

页眉

贡献

商业支助

许可证

版本与发布记录

关于 @bedrock/kms-http 的常见问题

@bedrock/kms-http 是什么？

如何安装 @bedrock/kms-http？

@bedrock/kms-http 支持 TypeScript 吗？

@bedrock/kms-http 支持 ESM 还是 CommonJS？

@bedrock/kms-http 需要什么版本的 Node.js？

@bedrock/kms-http 可以商用吗？

@bedrock/kms-http 的下载量有多少？

@bedrock/kms-http 还在维护吗？

创建 keystore - `POST /kms/keystores`

更新 Keystore 配置 - `POST /kms/keystores/:keystoreId`

获取 Keystore 配置 - `GET /kms/keystores/:keystoreId`

生成新密钥 - `POST /kms/keystores/:keystoreId/keys`

在已有密钥上启动 KMS 操作 - `POST /kms/keystores/:keystoreId/keys/:keyId`

获取公钥描述 - `GET /kms/keystores/:keystoreId/keys/:keyId`

插入撤销 - `POST /kms/keystores/:keystoreId/revocations/:zcapId`