# @crvouga/mockingbird-service-aws-secrets 中文文档

规范地址：https://npmcn.com/package/%40crvouga/mockingbird-service-aws-secrets/

版本：3\.11\.0
npm 元数据更新时间：2026-11-11T02:01:48.001Z
中文译文更新时间：2026-11-11T04:52:49.160Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40crvouga/mockingbird-service-aws-secrets
原文对照：https://npmcn.com/package/%40crvouga/mockingbird-service-aws-secrets/?lang=original
项目主页：https://github.com/crvouga/mockingbird/tree/main/packages/service/aws-secrets#readme
源码仓库：https://github.com/crvouga/mockingbird

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.3 MB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-09-22T23:52:32.274Z
- 最新版本发布：2026-11-11T02:01:47.618Z
- 近 30 天下载量：3197（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：41（近 12 个月 41 个）

## 中文简介

状态 AWS 秘密管理器和 SSM 参数存储模拟器,带有版本,相位,旋转,以及被修改的控制.

## 安装

```sh
npm install @crvouga/mockingbird-service-aws-secrets
```

也可以使用：`pnpm add @crvouga/mockingbird-service-aws-secrets`、`yarn add @crvouga/mockingbird-service-aws-secrets`、`bun add @crvouga/mockingbird-service-aws-secrets`

## README

# @crvouga/嘲笑鸟-服务-锯-秘密

> 本地模拟器。 真正的API合同. 部分 [嘲笑鸟](https://github.com/crvouga/mockingbird)。 。 。 .

为官方的AWS SDK v3客户端开发的状态仿真器AWS保密管理器和SSM参数存储器. 它模拟了秘密版本和阶段,二进制值,定心旋转,SafeString元数据,参数版本,拒绝,解密失败,以及不与AWS联系而修改的控制.

## 安装

```bash
npm install -D @crvouga/mockingbird-service-aws-secrets
```

仅限无害环境管理。 节点22+或Bun 1.2+.

## 使用量

指着两个客户 `endpoint` 选项。 接受Fixture SigV4证书.

```ts
import { GetSecretValueCommand, SecretsManagerClient } from "@aws-sdk/client-secrets-manager"
import { GetParameterCommand, SSMClient } from "@aws-sdk/client-ssm"
import { createServer } from "@crvouga/mockingbird-service-aws-secrets/server"

// Test setup: seed the emulator and point the AWS SDK clients your application uses at it.
const emulator = await createServer({
  secrets: [{ name: "database/password", value: "fixture-password" }],
  parameters: [{ name: "/app/region", value: "us-east-1" }],
})
const config = {
  endpoint: emulator.url,
  region: "us-east-1",
  credentials: { accessKeyId: "fixture", secretAccessKey: "fixture" },
}
const secrets = new SecretsManagerClient(config)
const ssm = new SSMClient(config)

// Application code: ordinary SDK calls.
const { SecretString } = await secrets.send(
  new GetSecretValueCommand({ SecretId: "database/password" }),
) // "fixture-password"
const { Parameter } = await ssm.send(new GetParameterCommand({ Name: "/app/region" }))
// Parameter.Value === "us-east-1"

await emulator.close() // after the test
```

秘密管理器支持 CreateSecret, PutSecretValue, GetSecretValue, 并按名称或ARN描述Secret, 包括版本Id, 版本Stage, 机密String, 和机密Binary. SSM支持PutParemeter,GetParemeter,以及带有String,StringList,securityString,WithDecryption,版本,ARNs,和数据类型的GetParemeters.

### 管理和确定性控制

-   `GET /__admin/secrets` 财务报告和审定财务报表 `/__admin/parameters` 显示每个数值的元数据.
-   `POST /__admin/secrets/:name/rotate` 解剖学将AWSCURENT转移到AWSPREVIUS.
-   `PUT /__admin/controls/:name` 配置拒绝、 stale- version 读取或解密失败 .
-   错误预设为 `throttled` 财务报告和审定财务报表 `unavailable`。 。 。 .

值被编码为持久状态,因此时间和快照不包含平文本标记. 请求日记从不记录请求或响应机构. 共享运行时间还提供重置、时钟、时间表、度量、断层和命名空间隔离 `x-mockingbird-namespace`, (中文(简体) ), `/__admin/ns/<name>`,或SigV4存取键映射.

### 故意不模拟

KMS加密、自动旋转Lambdas、资源政策、复制、SSM分级和标签超出支持的读取、生产配额、AWS仪表板、计费和外出销售商的呼号没有模型化。 未解密而返回的SafeString密码文本是决定性的仿真器密码文本,而不是KMS输出.

## API 密码

-   `AwsSecretsAPI`, (中文(简体) ), `AwsSecretsAPIOptions`, (中文(简体) ), `SecretSeed`, (中文(简体) ), `ParameterSeed`:处理器和固定装置.
-   `Secret`, (中文(简体) ), `SecretVersion`, (中文(简体) ), `SecretControl`, (中文(简体) ), `Parameter`: 耐用状态类型.
-   `createRuntime`, (中文(简体) ), `AwsSecretsRuntime`, (中文(简体) ), `AwsSecretsRuntimeOptions`:满口口鸟跑.
-   `AWS_SECRETS_NAMESPACE`, (中文(简体) ), `AWS_SECRETS_PRESETS`, (中文(简体) ), `accessKeyCredential`:常数与控制.
-   `document`, (中文(简体) ), `operationIds`, (中文(简体) ), `supportedOperationIds`: 生成了 OpenAPI 元数据.
-   `createServer`, (中文(简体) ), `AwsSecretsServerOptions`, (中文(简体) ), `DEFAULT_PORT`, (中文(简体) ), `serveTarget` 从 `./server`:节点HTTP适配器和CLI集成.

官方预言: [AWS 保密管理器 API 参考](https://docs.aws.amazon.com/secretsmanager/latest/apireference/Welcome.html) 财务报告和审定财务报表 [AWS 系统管理器 API 参考](https://docs.aws.amazon.com/systems-manager/latest/APIReference/Welcome.html)。 。 。 .

## 常见问题

### @crvouga/mockingbird-service-aws-secrets 是什么？

状态 AWS 秘密管理器和 SSM 参数存储模拟器,带有版本,相位,旋转,以及被修改的控制\.

### 如何安装 @crvouga/mockingbird-service-aws-secrets？

在项目目录运行 npm install @crvouga/mockingbird-service-aws-secrets，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mockingbird-aws-secrets，可以用 npx mockingbird-aws-secrets 直接运行。

### @crvouga/mockingbird-service-aws-secrets 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @crvouga/mockingbird-service-aws-secrets 支持 ESM 还是 CommonJS？

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

### @crvouga/mockingbird-service-aws-secrets 可以商用吗？

@crvouga/mockingbird-service-aws-secrets 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @crvouga/mockingbird-service-aws-secrets 的下载量有多少？

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

### @crvouga/mockingbird-service-aws-secrets 还在维护吗？

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