OneNym.id導入について相談する
日本語

THE HARDENED STACK / 第10章

秘密情報と鍵の管理

アプリやパイプラインは必ず何らかの認証情報で他のシステムに接続しています。その保管、ローテーション、廃止の仕方が、事故を小さく抑えられるかどうかを左右します。本章では、ファイルにパスワードを書く運用から抜け出す方法を説明します。

このページは本書の要約です。全文は本書でお読みください。

コードや設定に秘密情報を置く危険

章の冒頭で、Meridian 社の担当者は11か月前にコミットされたデータベースのパスワードを見つけ、全リポジトリをスキャンしてさらに9件の秘密情報を発見します。悪用の形跡はありませんでしたが、本書はそれを運が良かっただけだとしています。秘密情報とは、パスワード、API キー、トークン、接続文字列、秘密鍵、証明書など、知っているだけで使える値のことです。

危険は三つ重なります。一つ目は拡散で、コードは複製、フォーク、CI のキャッシュ、バックアップに広がり、後でファイルを消しても履歴に残ります。二つ目は長寿命で、コード内の認証情報は変更が面倒なため何年も放置されます。三つ目は可視性で、リポジトリにアクセスできる人なら誰でも読め、誰が読んだかの記録も残りません。CI/CD の変数、タスクスケジューラー、SaaS の管理画面、サービスアカウントのパスワードを並べた共有スプレッドシートにも同じ問題があります。

シークレットマネージャーと実行時の取得

Azure Key Vault、AWS Secrets Manager、Google Secret Manager、HashiCorp Vault などのシークレットマネージャーは、秘密情報を暗号化して保管し、許可された ID にだけ渡し、すべてのアクセスを記録します。アプリケーションが持つのは秘密情報ではなく ID で、必要なときに値を取りに行きます。取得は実行時に行い、値はプロセスのメモリ内だけに置きます。ビルド時に取り出してイメージや永続的な環境変数に焼き込むと、元の問題が再現してしまいます。

上級者向けの節では、スロットリングを避けるための短時間のキャッシュ、Vault に到達できない場合の動作、Vault をデータベース並みの可用性で運用すること、シークレット単位の権限や信頼境界ごとの Vault 分離で被害範囲を抑えることが取り上げられています。

メンテナンス時間の要らないローテーション

変更されない秘密情報は、過去の漏えいがいつまでも有効なままです。ローテーションは定期的かつ可能な限り自動で行い、担当者の退職、端末の紛失、スキャンでの検出、不審なアクセスがあれば即座に行います。鍵になるのは二つの認証情報を併用する方式で、新しい認証情報を作って最新版として保存し、利用側の更新を待って動作を確認し、古いものを無効化し、猶予期間の後に削除します。Meridian 社では、土曜日に作業時間を確保していた四半期ごとのパスワード変更が、マネージド ID 経由で Key Vault を参照するようにしたことで、平日の何事もない作業になりました。

短期の認証情報、ワークロード ID、OIDC

根本的な解決は、長期間有効な秘密情報そのものをなくすことです。マネージド ID(ワークロード ID)を使えば、VM やコンテナ上のアプリはプラットフォームから短期のトークンを受け取るため、保存すべきキーがありません。OIDC フェデレーションは同じ考え方を CI/CD に適用するもので、パイプラインが自身を示す署名付きトークンを提示し、クラウドは発行元とサブジェクトが事前の設定と一致した場合だけ短期のセッションを発行します。サブジェクト条件をリポジトリとブランチまで厳密に絞ることが重要です。短期のトークンも有効期間内は盗まれ得るため、最小権限の原則は引き続き必要です。

暗号鍵、証明書、漏れた秘密情報の後始末

エンベロープ暗号化では、データごとにデータ鍵で暗号化し、そのデータ鍵を KMS や HSM 内の鍵暗号化鍵(KEK)で包みます。KEK は外に出ず、ローテーションしてもデータの再暗号化は不要で、アクセスを取り消せばデータは読めなくなり、利用は記録されます。顧客管理キーは監査と取り消しを可能にしますが、稼働中のサービスから平文を隠すことはできません。鍵を失えばデータも失うため、論理削除と消去保護を有効にします。

証明書は期限切れで目立つ障害を起こします。台帳を作り、ACME やマネージド証明書で更新を自動化し、更新処理とは独立した期限監視(例えば21日前の警告)を置きます。最後に、gitleaks などで全リポジトリの履歴をスキャンし、見つかった秘密情報はまずローテーションし、次に Vault 参照に置き換え、可能なら履歴から削除し、pre-commit フックと CI チェックで再発を防ぎます。

KEY POINTS

要点

  • 全リポジトリの履歴をスキャンし、見つかった秘密情報はまずローテーションする。
  • pre-commit のシークレットスキャンを導入し、同じスキャンを CI の必須チェックにする。
  • ハードコードされた本番の秘密情報を今週1つ Vault へ移し、ワークロード ID で実行時に読み込む。
  • CI が使う長期のクラウドキーを1つ、リポジトリとブランチに限定した OIDC フェデレーションに置き換える。
  • 重要な秘密情報の少なくとも1つで、二つの認証情報を使う自動ローテーションを有効にする。
  • TLS 証明書の台帳を作り、公開エンドポイントごとに更新処理とは独立した21日前の期限アラートを設定する。

QUESTIONS

よくある質問

アプリの秘密情報は設定ファイルではなくどこに保管すべきですか
Azure Key Vault、AWS Secrets Manager、HashiCorp Vault などのシークレットマネージャーに保管します。秘密情報は暗号化され、許可された ID にだけ渡され、アクセスはすべて記録されます。アプリは自身のワークロード ID で認証し、実行時に値を取得してメモリ内だけで扱います。ビルド時にイメージや環境変数へ焼き込むと、ファイルに書くのと同じ問題が生じます。
データベースのパスワードを停止せずにローテーションするにはどうすればよいですか
『The Hardened Stack』が紹介する、二つの認証情報を併用する方式を使います。新しい認証情報を作って Vault に最新版として保存し、利用側のキャッシュが更新されるのを待ち、動作を確認します。その後古い認証情報を無効化し、問題がないことを確かめてから猶予期間後に削除します。対象のシステムが二つの有効な認証情報を同時に持てることが前提です。
OIDC を使うと CI/CD にクラウドのキーを保存しなくて済むのはなぜですか
OIDC フェデレーションでは、パイプラインが自分のリポジトリやブランチを示す署名付きトークンを要求し、クラウドがそれを短期のロールセッションに交換します。CI システムに長期のクラウドキーを保存する必要はありません。信頼ポリシーでは、トークンのサブジェクトをデプロイ元のリポジトリとブランチに厳密に限定しないと、他のリポジトリにロールを使われるおそれがあります。
エンベロープ暗号化とは何ですか
データごとに専用のデータ鍵で暗号化し、そのデータ鍵を AWS KMS や Azure Key Vault Managed HSM などの鍵管理サービスにある中央の鍵暗号化鍵で暗号化する方式です。中央の鍵はサービスの外に出ず、データを再暗号化せずにローテーションでき、利用はすべて記録されます。この鍵へのアクセスを取り消せば、保護されたデータは読めなくなります。
リポジトリで秘密情報が見つかったら最初に何をすべきですか
既に複製やバックアップが存在するため漏えいしたものとみなし、まずローテーションします。次にその利用箇所をシークレットマネージャーからの取得に置き換え、可能であれば履歴から削除し、pre-commit フックと CI のチェックを追加して再発を防ぎます。履歴の書き換えを先に行っても、漏えいの事実は消えません。