本文へスキップ

シークレット管理アーキテクチャ: Vault、KMS、ワークロードアイデンティティ

長期有効な認証情報なしでシークレットをワークロードへ届ける方法を、図で解説します。

· 創業者・開発者

公開日:

プロジェクテッドトークン、Vault Agent サイドカー、アプリを含む Pod フレームの図。番号付きのエッジが Kubernetes API server、エージェント、Vault、PostgreSQL をつなぎます。ログイン、TokenReview、認証情報の読み取り、CREATE ROLE、接続、DROP ROLE です。右側に KMS と監査ログがあります。

注文データベースのパスワードは、最初は .env ファイルにありました。その後、マイグレーション用の CI 変数、サービス用の Kubernetes Secret、障害対応中の 2 台のノートパソコンへとコピーされました。2 年後には、すべてのコピーを把握している人はいません。そのため、誰もローテーションに踏み切れません。

GitGuardian は、2025 年に公開 GitHub コミットで新たにハードコードされたシークレットを 28.65 million 件確認しました。前年から 34% の増加です。2022 年に有効と確認されたシークレットの 64% 以上が、2026 年 1 月の時点でもまだ使えました (State of Secrets Sprawl 2026)。

この記事では、長期有効なデータベースパスワードを使わないシークレット管理アーキテクチャを組み立てます。ワークロードアイデンティティ、短命な動的認証情報、KMS エンベロープ暗号化、ローテーション、監査を、フローの図とともに扱います。

静的シークレットが問題になる場所

静的シークレットのコピーは、どれも漏えい元になりえます。

  • Git の履歴は、行を削除した後も値を保持します。
  • CI 変数は、それを受け取るジョブを変更できる人なら誰でも読めます。
  • 環境変数はコンテナ内のすべてのプロセスから見え、ログやクラッシュダンプに残ります。OWASP のシークレットに関するチートシートは、ほかに手段がない場合を除いて使わないよう勧めています。
  • Kubernetes Secret はデフォルトで etcd に暗号化されずに保存され、namespace で Pod を作成できる人なら誰でも、そこにあるすべての Secret を読めます。Kubernetes のドキュメントもこの点を警告しています。

シークレットマネージャーが解決するのは保管であり、ブートストラップではありません。アプリは認証情報を取得するために、やはり認証情報を必要とします。解決策は、プラットフォームが発行する身元情報を、自動的に失効する認証情報と交換することです。

構成要素

コンポーネント 役割 例
シークレットマネージャー シークレットを保管して発行し、ポリシーを適用し、リースを追跡する HashiCorp Vault、OpenBao、AWS Secrets Manager、Google Secret Manager、Azure Key Vault
KMS または HSM 外に出ない鍵暗号化鍵を保持する AWS KMS、Google Cloud KMS、Azure Key Vault Managed HSM
ワークロードアイデンティティ 短命なプラットフォームトークンで、呼び出しているワークロードを証明する Kubernetes サービスアカウントトークン、EKS Pod Identity、Workload Identity Federation for GKE、Microsoft Entra Workload ID
配信 シークレットをプロセスに渡す Vault Agent、Secrets Store CSI Driver、External Secrets Operator、SDK 呼び出し
監査 誰がいつ何を読んだかを記録する Vault 監査デバイス、AWS CloudTrail、SIEM

KMS によるエンベロープ暗号化

KMS は大量のデータ向けには作られていません。AWS KMS の Encrypt が受け付けるのは最大 4,096 バイトです。エンベロープ暗号化は、この処理を分担します。

  1. GenerateDataKey は、一意のデータキーを 2 つの形で返します。平文のものと、KMS キーである鍵暗号化鍵 (KEK) で暗号化されたものです。
  2. 平文のキーでデータをローカルで暗号化し、そのキーをメモリから消去します。
  3. 暗号化されたデータキーを暗号文の隣に保存します。読み取るときは、それを Decrypt に送り、ローカルで復号します。
aws kms generate-data-key --key-id alias/orders-data --key-spec AES_256

KEK が暗号化されない状態で KMS の外に出ることはありません。そのため、すべての利用が、認可しログに残せる API 呼び出しになります (AWS KMS cryptography details)。自動ローテーションは、有効にするとデフォルトで毎年実行され、新しい暗号化に使う鍵素材だけを変更します。古い暗号文もそのまま復号できます。

このパターンは、ここで 2 回登場します。Kubernetes の KMS プロバイダーは、etcd の Secret を暗号化するデータキーをラップします。KMS v2 を使ってください。v1 は Kubernetes 1.29 以降、デフォルトで無効です。Vault のキーリングはルートキーで暗号化され、auto-unseal では、Vault の起動時にクラウド KMS がそのルートキーを復号します。

Pod が身元を証明する方法

どの Pod にも、サービスアカウントという身元がすでにあります。サービスメッシュのワークロード ID も、このサービスアカウントに基づいています。Vault の Kubernetes 認証方式では、次のように進みます。

  1. kubelet が、TokenRequest API を通じて、audience が vault のプロジェクテッドサービスアカウントトークンを要求します。有効期間はデフォルトで 1 時間 (最短 10 分) で、TTL の 80% で更新されます。
  2. Vault Agent が、そのトークンと Vault ロールでログインします。
  3. Vault が Kubernetes の TokenReview API でトークンを検証します。バウンドトークンは、期限が切れるか Pod が削除されると無効になります。
  4. Vault が、サービスアカウント、namespace、audience をロールと照合し、ポリシー付きのトークンを返します。
vault write auth/kubernetes/role/payments \
    bound_service_account_names=payments-api \
    bound_service_account_namespaces=payments \
    audience=vault policies=payments-db token_ttl=1h

このトークンはベアラー認証情報であり、Vault の Kubernetes 認証ドキュメントは、ほかのサービスと共有しないよう警告しています。専用の audience を使えば、aud を確認するサービスはこのトークンを拒否します。

表のワークロードアイデンティティサービスは、プロジェクテッドサービスアカウントトークンを短命なクラウド認証情報と交換するため、クラウドキーを保存する必要がありません。GitHub Actions OIDC は、CI/CD パイプラインのデプロイジョブで同じことを行います。こうしたトークンの検証方法は、JWT authentication flowで説明しています。

動的データベース認証情報

動的シークレットは、リクエストに応じて作成され、リースが終わると破棄されます。Vault のデータベースシークレットエンジンでは、database/creds/payments を読むたびに新しい PostgreSQL ユーザーが作成されます。

vault write database/roles/payments db_name=orders \
    creation_statements="CREATE ROLE \"{{name}}\" WITH LOGIN PASSWORD '{{password}}' VALID UNTIL '{{expiration}}'; GRANT SELECT ON ALL TABLES IN SCHEMA public TO \"{{name}}\";" \
    default_ttl=1h max_ttl=24h

リースは max_ttl まで更新できます。Vault Agent は、更新可能なシークレットをリースの 3 分の 2 が経過した時点で更新し、更新できないリース付きシークレットは TTL の 90% の時点で再取得します。リースが期限切れになるか取り消されると、Vault は失効ステートメントを実行します。デフォルトは汎用のユーザー削除ステートメントです。TTL がない場合は、Vault のシステムデフォルトである 768 時間 (32 日) が適用されます。

得られるものは次のとおりです。

  • Pod ごとに 1 ユーザー。不審なクエリは、パスワードを共有するすべてのサービスではなく、1 つのリースを指します。
  • 漏えいしても失効します。リースを更新しない限り、発行から長くても 1 時間です。
  • 1 コマンドで対応できます。vault lease revoke -prefix database/creds/payments が、そのロールのすべての有効な認証情報を取り消します。

注意点が 1 つあります。VALID UNTIL はパスワードを失効させるもので、効くのはログイン時です。プール内の接続には、リースより短い最大有効期間を設定してください (HikariCP のデフォルトは 30 分です)。Vault Agent がファイルを書き換えたら、認証情報を再読み込みします。

配信方法とトレードオフ

配信方法 仕組み 新しい値 注意点
環境変数 コンテナの起動時に設定される 再起動後 すべてのプロセスから見える。ログやダンプに漏れる
同期された Kubernetes Secret External Secrets Operator (デフォルトは 1 時間ごとに更新) または Vault Secrets Operator が値を Secret にコピーする マウントされたボリュームは更新される。環境変数は更新されない etcd にコピーが残る。保存時の暗号化と厳格な RBAC を有効にする
エージェントサイドカー Vault Agent Injector がシークレットを /vault/secrets のメモリ上のボリュームに書き出す はい。アプリがファイルを再読み込みする場合 すべての Pod にサイドカーと init container が必要
CSI ボリューム Secrets Store CSI Driver が Pod の起動時にシークレットをマウントする alpha の自動ローテーションを使う場合のみ (デフォルトはオフ) Secret へのオプションの同期で、etcd のコピーが復活する
SDK 呼び出し アプリがシークレットマネージャーの API を呼ぶ はい。コード内で すべてのサービスで認証、キャッシュ、リトライが必要

動的認証情報には、エージェントが書き出すファイルが最も向いています。ログイン、更新、再書き出しをエージェントが担当するからです。Helm チャートが Secret を前提にしている場合や、GitOps リポジトリのシークレットを参照としてだけ置く場合は同期された Secret を、Kubernetes の外では SDK を使ってください。

ダウンタイムなしのローテーション

ローテーションのルールは 1 つです。古い認証情報が止まる前に、新しい認証情報が使えなければなりません。

  • 動的認証情報は、利用側が間に合うように再読み込みする限り、設計上ローテーションされます。
  • 静的データベースパスワードにはローテーションジョブが必要です。AWS Secrets Manager の単一ユーザー戦略は、開いている接続を維持しますが、呼び出しを短時間拒否することがあるため、クライアントにはリトライが必要です。交互ユーザー戦略は 2 つのユーザーを切り替えるため、ローテーション中にシークレットを取得したクライアントも有効な認証情報を持ち続けます。ローテーションは、最短で 4 時間ごとに実行できます。
  • API キーは、新しいキーをデプロイし、トラフィックが移ったことを確認してから、古いキーを取り消します。

監査ログと緊急アクセス

Vault は、すべてのリクエストとレスポンスについて、有効なすべての監査デバイスにエントリーを送り、どのデバイスも記録できないリクエストは拒否します。そのため HashiCorp は、少なくとも 2 つを有効にするよう推奨しています。ほとんどの文字列は HMAC-SHA256 ハッシュとして記録され、/sys/audit-hash は既知の値のハッシュを計算するので、それで検索できます。ログを SIEM に送り、ルートトークンの使用とポリシー変更をアラートの対象にしてください。

緊急アクセスは、地味で、テスト済みであるべきです。

  • 常設のルートトークンは持たない。 HashiCorp は、ルートトークンをセットアップや緊急時だけに使い、直後に取り消すよう推奨しています。vault operator generate-root には、unseal キーまたはリカバリーキーの保持者の定足数が必要です。
  • ハード依存を把握する。 auto-unseal では、リカバリーキーでルートキーを復号できないため、Vault は KMS キーなしでは unseal できません。AWS KMS は、キーを削除するまでに 7〜30 日待ちます。削除が予定されるたびにアラートを出してください。

シークレットフロー図

プロジェクテッドトークン、Vault Agent サイドカー、アプリを含む Pod フレームの図。番号付きのエッジが Kubernetes API server、エージェント、Vault、PostgreSQL をつなぎます。ログイン、TokenReview、認証情報の読み取り、CREATE ROLE、接続、DROP ROLE です。右側に KMS と監査ログがあります。

12 個のコンポーネント · 11 個の接続

Archboard で開く
ダイアグラムの内容
  • Kubernetes API server
  • Pod: payments-api
  • Projected SA token
  • Vault Agent (sidecar)
  • App container
  • Cloud KMS key
  • Vault: auth, policies, leases
  • Vault audit log to SIEM
  • orders DB (PostgreSQL)
  • 1 TokenRequest via kubelet
  • read JWT
  • 2 login: JWT + role payments
  • 3 TokenReview
  • 4 read database/creds/payments
  • 5 CREATE ROLE ... VALID UNTIL
  • 6 render /vault/secrets/db
  • 7 connect as the short-lived user (TLS)
  • 8 lease ends: DROP ROLE
  • at startup: decrypt root key
  • every request and response
Pod は保存されたパスワードなしでデータベース認証情報を受け取ります。サービスアカウントトークンが身元を証明し、Vault が 1 時間のリースで PostgreSQL ユーザーを作成し、リースが終わるとそのユーザーは削除されます。KMS は Vault のルートキーを守り、すべてのリクエストが監査されます。

図の読み方は次のとおりです。

  • 左: Kubernetes API server の下にある、プロジェクテッドトークン、Vault Agent サイドカー、アプリを含む Pod フレームです。
  • 紫のエッジ 1〜3、身元: TokenRequest (1)、ロール payments でのログイン (2)、TokenReview (3) です。
  • 青緑のエッジ 4〜7、認証情報: database/creds/payments の読み取り (4)、CREATE ROLE ... VALID UNTIL (5)、/vault/secrets/db の書き出し (6)、TLS での接続 (7) です。
  • 赤の破線のエッジ 8: リースが終わり、Vault がユーザーを削除します。
  • 右: KMS が起動時に Vault のルートキーを復号し、監査ログがすべてのリクエストとレスポンスを受け取ります。
  • Markdown ブロックに、すべての有効期間を載せています。

シークレット管理の図を分かりやすく描く

  • 手順に番号を振り、フェーズごとに色分けします。身元、配信、取り消しです。
  • 有効期間と audience を図に書きます。「aud vault, 1h」ならレビューしやすく、「短命」では議論になります。
  • 平文が存在する場所を示します。メモリ、メモリ上のボリューム、環境変数、etcd です。
  • 取り消しと監査の経路も描きます。うまくいく経路だけにしません。
  • 実際のキー、トークン、内部ホスト名は決して図に入れません。
  • Vault のストレージとクラスターの内部は、運用向けの図に任せます。

脅威モデリングのデータフロー図では信頼境界を追加でき、ゼロトラストモデルはより広いアクセスの全体像を示します。Kubernetes アーキテクチャ図では API server と kubelet を扱っています。

Archboard で作る

  1. Google または GitHub でサインインし、ダイアグラムを作成します。
  2. 基本パックのフレームを追加し、名前を Pod: payments-api にします。その中に、セキュリティパックのトークンと、Docker パックの 2 つのコンテナノード (Vault Agent (sidecar) と App container) を積み重ねます。
  3. フレームの上に、クラウドパックのKubernetesクラスターを追加し、ラベルを Kubernetes API server にします。
  4. 中央にセキュリティパックのボールトを追加します。右側には、KMS キー用にクラウドパックのクラウドリソース、監査ログ用に DevOps パックのログ、データパックの Postgres を追加します。
  5. エッジ 1〜8 をブロック矢印で描きます (身元は紫、認証情報は青緑、DROP ROLE は赤の破線)。あわせて、KMS キーへの起動時のエッジと、監査ログへの破線のエッジも描きます。
  6. 基本パックの Markdown ブロックに有効期間を書き、Vault ロールとデータベースユーザー用に、基本パックのテキスト注釈を 2 つ追加します。

Kubernetes YAML to diagram ツールを使うと、既存のマニフェストから最初の下書きを作れます。この例で使うダイアグラムノードは 10 個で、Free プランの範囲に収まります。

よくある質問

シークレットマネージャーと KMS の違いは何ですか? KMS は外に出ない鍵を保持し、データキーのような小さなデータを暗号化します。シークレットマネージャーは、パスワードや API キーなどのシークレット自体を保管して発行し、多くの場合 KMS で保護されます。

Kubernetes Secret は暗号化されていますか? デフォルトでは暗号化されていません。etcd の保存時の暗号化を有効にし、できれば KMS v2 プロバイダーを使って、RBAC を制限してください。namespace で Pod を作成できる人は誰でも、その Secret を読めます。

動的シークレットとは何ですか? リクエストに応じて作成され、リースが終わると削除される認証情報です。たとえば、Vault のデータベースシークレットエンジンがリクエストごとに作成する、1 時間有効なデータベースユーザーがあります。

シークレットを環境変数で渡すべきですか? できるだけ避けてください。コンテナ内のすべてのプロセスが読めて、ログやクラッシュダンプに漏れ、再起動しないと変わりません。エージェントが書き出すファイルのほうが、保護もローテーションも簡単です。

シークレットはどのくらいの頻度でローテーションすべきですか? 動的認証情報は数時間で失効するため、スケジュールは不要です。静的シークレットは、スケジュールに沿って、また漏えいの疑いや担当者の入れ替わりがあった後にローテーションし、まずステージングでローテーションをテストしてください。

無料で始める — 1 シート、クレジットカード不要。

関連記事

← ブログに戻る

1分でキャンバスを開く

Google または GitHub でサインイン。1シートは無料で、チームが加わったらアップグレード。