コンテンツへスキップ
オーラベースのロゴ
オーラベース

保管庫

機密性の高い Aurabase データのフィールド レベルの暗号化。レコード派生キー (HKDF-SHA256) を使用した AES-256-GCM、または本番環境の HashiCorp Vault トランジット バックエンド - 同じプリミティブが Edge Functions シークレットと内部プラットフォーム シークレットを保護します。

解説6 分 読み取りレベル 中間2026/08/15 に改訂

このページは自動翻訳されました。英語版が正式です。

個別の製品ではなく暗号化サービス#

「Vault」は、ゲートウェイ上の個別の HTTP サービスではありません。これは、データベースに書き込む前に機密データ ( MFA シークレット、 OAuth プロバイダー トークン、プロジェクト接続文字列、および Edge Functionsのシークレット) を自動的に保護するフィールド レベルの暗号化エンジンです。

開発者として実際に操作するのは、関数ごとのシークレットです。つまり、CLI または REST API 経由で定義され、関数を実行するワーカーに環境変数として挿入されるキーと値のペアです。

情報

「Vault」という名前は、このサービスのオプションの バックエンド (ルート暗号化キー、ローテーション、有効期間が制限された Postgres 資格情報の管理) として運用環境にデプロイされる、HashiCorp Vault インフラストラクチャ製品も指します。ここで説明するアプリケーション プリミティブと、それをサポートできるインフラストラクチャ ツールという 2 つの意味が共存します。

2 つのバックエンド、1 つの読み取り形式#

書き込み時に、サービスはバックエンドを選択します: 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 です。2 つの関数に対して同じ秘密を 2 回暗号化すると、2 つの異なる暗号文が生成され、関数を削除または名前変更すると、古い暗号文は構造上判読できなくなります。

サービスが提供するもの#

  • AES-256-GCM。 HKDF-SHA256 による登録によって導出された 32 バイトのキー (context = 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) を保護します。

3 つの書き方、1 つの読み方#

functions/echo.tstypescript
// (CLI または REST) で記述されると、シークレットは変数として挿入されます。
// 関数を実行するワーカーの環境。
Deno.serve(async (req) => {
  const cle = Deno.env.get('STRIPE_SECRET_KEY')
  // ...
})
ヒント

CLI (aura secrets) と専用 REST エンドポイント (/env) は、同じデータ (関数の秘密) を操作しますが、必ずしも同じ書き込みパスを介しているわけではありません。以下の注意点を参照してください。

暗号化は使用される書き込みパスに依存します#

aura-functions は、関数の環境変数を変更する 2 つの方法を公開します。1 つは専用の PUT /v1/functions/:projectId/:nom/env エンドポイント (書き込み前に EncryptionService を介して体系的に暗号化されます)、もう 1 つはこの暗号化を経由せずに関数全体 (コード、ランタイム、env_vars を含む) を更新するために使用される汎用 PATCH /v1/functions/:projectId/:nom エンドポイントです。

環境変数の暗号化

/env を介して設定された環境変数は、保存前に AES-256-GCM を介して暗号化されます。ローカル開発でも管理された運用環境でも、この暗号化は開発者に対して透過的に実行されます。

さらに進むには#