跳到内容
光环标志
光环基地

避难所

对敏感 Aurabase 数据进行字段级加密。具有记录派生密钥 (HKDF-SHA256) 的 AES-256-GCM 或生产中的 HashiCorp Vault 传输后端 — 相同的原语可以保护您的 Edge Functions 机密和内部平台机密。

说明6分钟 读取级别 中间修改于 2026年8月15日

该页面已自动翻译。英文版具有权威性。

加密服务,而不是单独的产品#

“Vault”不是网关上的单独 HTTP 服务:它是一个字段级加密引擎,可在写入数据库之前自动保护您的敏感数据 — MFA 机密、OAuth 提供者令牌、项目连接字符串以及 Edge Functions的机密。

作为开发人员,您实际操作的是每个函数的秘密:通过 CLI 或 REST API 定义的键/值对,作为环境变量注入到执行函数的工作程序中。

信息

“Vault”这个名称还指 HashiCorp Vault 基础设施产品,在生产中部署为该服务的可选 后端(管理根加密密钥、轮换、具有有限生命周期的 Postgres 凭证)。这两种含义并存:此处记录的应用程序原语以及可以支持它的基础设施工具。

两个后端,一种阅读格式#

写入时,服务选择后端:Vault 传输(如果已配置)(首选 - 根加密密钥永远不会离开 Vault),否则使用通过 HKDF-SHA256 注册派生的密钥作为后备 AES-256-GCM 本地。读取时,密文的格式表明是哪个后端生成的——无需强制迁移即可从一个后端切换到另一个后端。

密文格式text
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)。

三种写作方式,一种阅读方式#

functions/echo.tstypescript
// 一旦写入(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 进行静态加密。在本地开发以及托管生产中,这种加密对于开发人员来说是透明执行的。

为了走得更远#