シークレット

Kazzle には、API キー、データベース認証情報、トークン、およびアプリが必要とするその他の機密値を保存するための組み込み暗号化ボルトがあります。シークレットは AES-256-GCM で保存時に暗号化され、KMS でラップされたデータ暗号化キーを使用します。平文値がデータベースに到達することはありません。

概念

コレクション は関連するシークレットをグループ化します（例：stripe-keys、database-credentials）。すべてのコレクションには スラッグ（小文字、ハイフン区切り）があり、これを設定ファイルと CLI コマンドで参照します。環境はコレクション内のオプションのスコープです（例：production、staging）。シークレットは特定の環境にスコープするか、コレクションレベルのデフォルトとして保持できます。 解決順序： 指定されたコレクション + 環境のシークレットを解決する場合、環境固有のシークレットは同じ名前のコレクションレベルのシークレットをオーバーライドします。これにより、ほとんどのシークレットを環境全体で共有しながら、環境ごとに特定の値をオーバーライドできます。

シークレットの管理

アプリ内

設定 > ボルト を開いて、UI を通じてコレクション、環境、シークレットを作成します。

AI を使用

AI はコレクション、環境、シークレットを作成し、スコープ間で移動し、削除できます。 AI はシークレット名とメタデータを確認できますが、暗号化された値は確認できません。

CLI を使用

# シークレットを環境変数として注入してコマンドを実行
kazzle run --collection=stripe-keys --env=production -- bun run server.ts

# シークレットを KEY=value 行としてエクスポート
kazzle secrets.export --collection=stripe-keys --env=production

アプリからシークレットを参照

kazzle.config.ts でコンポーネントの env をシークレットコレクションと環境にポイントします。そのスコープ内のすべてのシークレットは、シークレット名と一致する名前のプロセス環境変数として注入されます。

import { defineConfig } from './kazzle.types';

export default defineConfig({
  components: [
    {
      name: 'API Server',
      type: 'process',
      path: './server',
      env: {
        collection: 'stripe-keys',
        environment: 'production'
      }
    }
  ]
});

env.collection と env.environment は スラッグ であり、表示名ではありません。env.include を使用して、コレクションのシークレットのサブセットのみを注入します。

env: {
  collection: 'stripe-keys',
  environment: 'production',
  include: ['STRIPE_SECRET_KEY']
}