避难所
对敏感 Aurabase 数据进行字段级加密。具有记录派生密钥 (HKDF-SHA256) 的 AES-256-GCM 或生产中的 HashiCorp Vault 传输后端 — 相同的原语可以保护您的 Edge Functions 机密和内部平台机密。
加密服务,而不是单独的产品#
“Vault”不是网关上的单独 HTTP 服务:它是一个字段级加密引擎,可在写入数据库之前自动保护您的敏感数据 — MFA 机密、OAuth 提供者令牌、项目连接字符串以及 Edge Functions的机密。
作为开发人员,您实际操作的是每个函数的秘密:通过 CLI 或 REST API 定义的键/值对,作为环境变量注入到执行函数的工作程序中。
“Vault”这个名称还指 HashiCorp Vault 基础设施产品,在生产中部署为该服务的可选 后端(管理根加密密钥、轮换、具有有限生命周期的 Postgres 凭证)。这两种含义并存:此处记录的应用程序原语以及可以支持它的基础设施工具。
两个后端,一种阅读格式#
写入时,服务选择后端:Vault 传输(如果已配置)(首选 - 根加密密钥永远不会离开 Vault),否则使用通过 HKDF-SHA256 注册派生的密钥作为后备 AES-256-GCM 本地。读取时,密文的格式表明是哪个后端生成的——无需强制迁移即可从一个后端切换到另一个后端。
vault:v1:AbCdEf... # 后端传输 — 通过 Vault 解密(KEK 从未暴露)
{"key_id":"v1", # 本地 AES-256-GCM 后端(后备/开发)
"nonce":"…","data":"…"}
sk_live_51J2x... # 未加密历史值(加密激活前)
派生上下文(函数侧)是 project_id:function_name — 对两个函数加密两次的相同秘密会产生两个不同的密文,并且删除/重命名该函数会使旧密文无法通过构造读取。
服务提供什么#
- AES-256-GCM。 通过 HKDF-SHA256 注册而派生的 32 字节密钥(上下文 = project_id:function_name)。每次写入 96 位随机数。
- 后端 Vault 传输。 在生产中,KEK 永远不会离开 Vault:加密/解密委托给传输/加密|解密,版本化密文Vault:vN:....
- 读取旧格式。 解密检测存储格式(保管库:→ 传输、{...}→ 本地 AES、纯文本→ 未加密历史记录):后端故障转移,无需强制重写。
- 按功能划分的范围。 此处记录的应用程序机密的范围仅限于一个函数(project_id + name),通过
Deno.env.get('KEY')注入到 Deno 工作线程中。 - 专用 CLI。
aura secrets list、set和unset采用--function <name>。list从不以纯文本形式显示值。 - 被平台重用。 相同的加密服务还在服务器端保护 MFA 机密、OAuth 令牌和连接字符串(db_url_encrypted、anon_key_encrypted)。
三种写作方式,一种阅读方式#
// 一旦写入(CLI 或 REST),秘密就会作为变量注入
// 执行该功能的工作人员的环境。
Deno.serve(async (req) => {
const cle = Deno.env.get('STRIPE_SECRET_KEY')
// ...
})
CLI (aura secrets) 和专用 REST 端点 (/env) 操作相同的数据(函数的秘密),但不一定通过相同的写入路径。请参阅下面的注意点。
加密取决于所采用的写入路径#
aura-functions 公开了两种修改函数环境变量的方法:专用 PUT /v1/functions/:projectId/:nom/env 端点(在写入之前通过 EncryptionService 进行系统加密),以及通用 PATCH /v1/functions/:projectId/:nom 端点,用于更新整个函数(包括代码、运行时、包括 env_vars),而无需经过此加密。
通过 /env 配置的环境变量在存储之前通过 AES-256-GCM 进行静态加密。在本地开发以及托管生产中,这种加密对于开发人员来说是透明执行的。