@aws-lambda-powertools/data-masking

中文文档
2.36.0发布于 2026/10/06MIT-0TypeScriptESM + CJS构建来源已验证近 30 天下载 1.1万

AWS Lambda 函数中用于掩盖和加密敏感数据的工具

中文使用文档
文档目录12 节
  1. 主要特点
  2. 使用量
  3. 删除数据
  4. 加密和解密数据
  5. 贡献
  6. 路线图
  7. 连接
  8. 如何支持 AWS Lambda (TypeScript) 的 Powertools ?
  9. 成为参考客户
  10. 分享你的工作
  11. 使用 Lambda 层
  12. 许可证

AWS Lambda (TypeScript) - 数据遮掩工具

数据遮蔽工具可以加密,解密,或者不可逆转地去除敏感信息以保护数据保密性.

用于 AWS Lambda (TypeScript) 的 Powertools 是用于执行无服务器的开发者工具包 最佳做法和增加开发者的速度。您可以在 TypeScript 和 JavaScript 代码库中使用库.

要启动, 请通过运行安装软件包 :

npm i @aws-lambda-powertools/data-masking

主要特点

  • 简单加密、解密或不可逆转地去除数据
  • 在嵌入数据中的一个或多个字段中擦去敏感信息
  • 与 AWS 加密 SDK 工业安全最佳做法

使用量

删除数据

删除将删除原始数据并替换为 *****。这意味着无法回收已删除的数据,数据类型将更改为 string 对于所有被去除的值.

实地路径支持符号和 .*编号 :[*] 通配符可以到达巢数据.

import { DataMasking } from '@aws-lambda-powertools/data-masking';

const masker = new DataMasking();

const data = {
  name: 'Jane Doe',
  customer: { ssn: '123-45-6789', city: 'Anytown' },
  orders: [{ id: 1, card: '4111-1111-1111-1111' }],
};

const masked = masker.erase(data, {
  fields: ['customer.ssn', 'orders[*].card'],
});
// {
//   name: 'Jane Doe',
//   customer: { ssn: '*****', city: 'Anytown' },
//   orders: [{ id: 1, card: '*****' }],
// }

您也可以使用自定义遮盖规则来部分遮盖数据,同时保留其部分结构,例如保存电子邮件地址的域名或值的长度:

import { DataMasking } from '@aws-lambda-powertools/data-masking';

const masker = new DataMasking();

const masked = masker.erase(
  { email: '[email protected]', ssn: '123-45-6789' },
  {
    maskingRules: {
      email: { regexPattern: /^(.)([^@]*)(@.*)$/, maskFormat: '$1****$3' },
      ssn: { dynamicMask: true },
    },
  }
);
// { email: 'j****@example.com', ssn: '***********' }

加密和解密数据

要加密和解密数据,需要加密提供者. 默认情况下,我们通过AWS加密SDK供应商使用Amazon密钥管理服务(KMS),作为自己的子路径导出 @aws-crypto/client-node 仅当您使用时需要对等依赖 :

npm i @aws-crypto/client-node
import { DataMasking } from '@aws-lambda-powertools/data-masking';
import { AWSEncryptionSDKProvider } from '@aws-lambda-powertools/data-masking/providers/kms';

const masker = new DataMasking({
  provider: new AWSEncryptionSDKProvider({
    keys: ['arn:aws:kms:us-east-1:123456789012:key/my-key'],
  }),
});

const encrypted = await masker.encrypt(data, {
  fields: ['customer.ssn'],
});

const decrypted = await masker.decrypt(encrypted, {
  fields: ['customer.ssn'],
});

关于如何使用这一工具的更多信息,请参见: 文档。 。 。 .

贡献

如果你有兴趣为这个项目捐款,请参见我们 贡献准则。 。 。 .

路线图

AWS Lambda(英语:TypeScript)的"Powertools"行进图受顾客需求所驱动.
帮助我们确定未来功能或公用事业的优先次序 更新现有 RFC 和功能请求,或 创建新的,在此 GitHub 仓库中.

连接

如何支持 AWS Lambda (TypeScript) 的 Powertools ?

成为参考客户

了解哪些公司正在使用这个图书馆对于帮助在内部确定项目的优先次序很重要。 如果您的公司正在使用 Powertools 为 AWS Lambda (TypeScript) , 您可以要求您在 README 文件中添加您的姓名和标志 AWS Lambda( TypeScript) 的辅助电源工具(成为参考) 问题.

除其他外,下列公司使用Powertools:

分享你的工作

分享您为 AWS Lambda (TypeScript) 所做的 Powertools 。 看看社区有什么 已经共享 关于AWS Lambda的Powertools (TypeScript).

使用 Lambda 层

这帮助我们了解谁用Powertools为AWS Lambda(英语:TypeScript (TypeScript))以非侵入性的方式使用Powertools,并帮助我们获得未来对其他AWS Lambda语言的Powertool的投资. 何时 使用图层,您可以添加Powertools作为dev的依赖性,以不影响开发过程.

许可证

这个图书馆根据MIT-0许可证获得许可. 见LICENSE文件.

版本与发布记录

@aws-lambda-powertools/data-masking 共发布 4 个版本,首次发布于 2026/07/08;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.36.0latest2026/10/061 个月前
2.35.02026/08/182 个月前
2.34.02026/07/103 个月前
0.0.0pre2026/07/084 个月前

关于 @aws-lambda-powertools/data-masking 的常见问题

@aws-lambda-powertools/data-masking 是什么?

AWS Lambda 函数中用于掩盖和加密敏感数据的工具

如何安装 @aws-lambda-powertools/data-masking?

在项目目录运行 npm install @aws-lambda-powertools/data-masking,或使用 pnpm add / yarn add / bun add。

@aws-lambda-powertools/data-masking 支持 TypeScript 吗?

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

@aws-lambda-powertools/data-masking 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@aws-lambda-powertools/data-masking 可以商用吗?

@aws-lambda-powertools/data-masking 使用 MIT-0 许可。声明的许可为 MIT-0,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@aws-lambda-powertools/data-masking 的下载量有多少?

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

@aws-lambda-powertools/data-masking 还在维护吗?

最新版本 2.36.0 发布于 2026/10/06(1 个月前);至今共发布 4 个版本,其中过去 12 个月发布了 4 个;首次发布于 2026/07/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。