運用シークレット

どのようなものか

運用シークレットとは、ソフトウェアやその運用者がシステムに対して操作
するための値であり、それを読んだ他の人にも同じ権限を与えるものです。
データベースの接続パスワード、APIトークン、SSH鍵ペアの秘密鍵、バック
アップを暗号化するパスフレーズは、いずれも運用シークレットです。普段
は単にシークレットと呼び、その生成、保存、更新、破棄を行うことをシー
クレット管理といいます。

周囲のコードと異なる点は二つあります。一つは、誰が読むかです。利用者
のパスワードは人が覚えていて入力を求められたときに打ち込みますが、運
用シークレットはプログラム、デプロイスクリプト、定期実行ジョブが読み
取り、人が覚えておく必要はありません。そのため、OWASP
Secrets Management Cheat
Sheetは、シークレットに独自のライフサイクルを設けています。必要最小
限の権限で生成し、定期的に更新し、漏えいした可能性があれば失効させ、
プラットフォームが対応する場合は有効期限を設定します。有効期間は数分
から数年までさまざまです。利用者のパスワードは、この定期更新の対象外
です。もう一つは、シークレットと、その所在を示す設定との境界です。ホ
スト名やバックアップリポジトリのパスは、何かがある場所を示します。
シークレットは、保持者のアクセスを可能にする値であり、その複製の数を
把握する必要があります。

シークレットには入れ子の関係もあります。保存先のストアにも独自のシー
クレットが必要です。このチートシートは、クラウド事業者のルート認証情
報など、その最上位のシークレットは、通常、別の場所に保管しなければな
らないと指摘しています。

なぜ重要なのか

シークレットは、それを提示した人に対して機能します。トークン自体に
は、本来誰が持つべきものだったかという記録がないため、複製が増えるた
びに、それを使える人やプログラムの範囲が広がります。ソースリポジトリ
は、その値が入り込む場所として最も不適切です。クローンには全履歴が含
まれるため、一度コミットされた値は、それを取得するすべてのノートパソ
コン、ビルドランナー、ミラーへ渡り、該当行を削除しても履歴に残りま
す。

標準は、これを要件として定めています。OWASP Application Security
Verification
Standardは、バックエンドのシークレットを生成、保存し、アクセスを制御
し、破棄するために、キーストアなどのシークレット管理ソリューションを
求めています。また、アプリケーションのソースコードやビルド成果物に
シークレットを含めてはならないとしています。アクセスには最小権限を求
め、最も高い検証レベルでは、有効期限と更新も要求しています。NIST
SP
800-53には、管理策の拡張要件IA-5(7)があり、暗号化されていない固定の
認証子を、アプリケーションやその他の静的な保存領域に埋め込んではなら
ないとしています。その指針は抜け道も塞いでいます。保存されている値を
そのまま認証に使うのであれば、どのファイルに入っていても、暗号化され
ていないものと見なされます。

トレードオフもあります。集中管理ストアを置けば、最も必要なときに稼働
していなければならないシステムが一つ増えます。チートシートも、インシ
デント時には新しい認証情報がすぐに求められると指摘しています。複数の
サービスで一つのシークレットを共有すれば手間は減りますが、漏えい時に
どの保持者から流出したか分からなくなります。手作業の負担はシークレッ
トが増えるたびに大きくなるため、チートシートは更新の自動化を推奨して
います。また、アプリケーションを再起動しても、盗まれた認証情報は有効
なままだと注意しています。使えなくするには、失効させる必要がありま
す。

実際の活用例

このサイトは、安全な業務の進め方を説明するページに、シークレットをリ
ポジトリに入れないという原則を掲げています。認証情報はシークレットス
トアやデプロイ層に置き、ソースにもビルドの生成物にも含めません。コ
ミットのたびに自動スキャンを実行し、検出があればコミットを停止しま
す。

リポジトリの技術ノートには、その方法が記されています。スキャナーは
gitleaksで、コミットのたびに作業ツリーを調べ、完全な品質検査でも再度
実行します。検出は必ず処理を止めるものであり、許可リストに加えて回避
することは認められていません。依存関係のフォルダーや生成出力のツリー
は、毎回作り直される複製なので除外します。ノートには、より気付きにく
い失敗も記されています。スキャンの途中でファイルが消えると、gitleaks
はエラー行を出力しながら、正常終了します。そのため、実行タスクはエ
ラー行が一つでもあれば失敗とします。サイト自体は静的で、アプリケー
ションのシークレットを持たず、所有者が保管する鍵を使ってSSH経由でデ
プロイします。

シークレットをリポジトリの外に置くと、その検査からも見えなくなりま
す。シークレット用の事前検証プレイは、この隙間に対処するものです。
シークレットをホスト別に分けた直後、コードは正しかったものの、運用者
のマシン上にあり、品質ゲートからは見えない暗号化Vaultには、以前の単
一ホスト用の値が残っていました。最初の収束処理は稼働中のホストに接続
し、8タスクを実行した後、9番目で処理を拒否しました。その時点で、本番
のスワップ設定はすでに書き換わっていました。対策として、どのホストに
も接続せず、factsも収集せず、本番の収束処理と同じ二つのタスクファイ
ルをVaultに対して実行するプレイを作りました。約1秒で終わり、プロビ
ジョニングが他の作業を始める前に実行します。ルールを別に書き直すので
はなくコードを再利用することで、検査と収束処理が食い違うのを防ぎま
す。現在、シークレットに不備があれば、ノートパソコンでは2秒で処理が
拒否されます。

その分割とは、すべての運用シークレットをホストごとの値にした変更で
す。プラットフォームは1ホスト構成から2ホスト構成に移るところで、バッ
クアップリポジトリ、パスフレーズ、アラートのスイッチなど、いくつかの
シークレットが単一の値として書かれていました。それぞれをインベント
リーのホスト名をキーとするマップに変更し、その理由を二つ、設定のそば
に記録しました。2ホストでデッドマンズスイッチを共有すると、どちらか
が生存通知を送り続ける限り正常表示のままなので、2台目のホストが1台目
の停止を隠してしまいます。別々のresticリポジトリは、同じパスフレーズ
を使っていても、異なるマスター鍵を持つことができます。しかし、そのパ
スフレーズを入手し、両方のリポジトリの暗号化データと鍵ファイルを読み
取れる人は、両方を復号できます。そのため、パスフレーズを共有すると、
ホストごとの分離にはならず、両方がまとめて解読され得る状態になりま
す。既存のホストは四つのマップすべてに記載されていますが、リポジトリ
と二つのスイッチは空欄のままです。これは、仕組みは用意できていても、
値の設定はまだ運用者が行う必要があることを示しています。

問題が起きるところ

シークレットがコミットに入り込みます。
コミット時に設定ファイルやテスト用データに値が入っていたため、スキャ
ナーが差分で検出したり、プッシュされたファイル内のトークンに誰かが気
付いたりします。OWASPのチートシートは、対処の順序を示しています。ま
ず漏えいした値を失効させ、次に新しい値へ更新し、その後で初めてコード
やログから取り除きます。コミットを除くために履歴を書き換えると、それ
以降のすべてのコミットが変わり、それらへのリンクも切れるため、計画が
必要です。検出はコミット前に、pre-commitフックやエディターで行いま
す。その段階なら、検出による手戻りはありません。

スキャンが、読んでいないファイルを合格扱いにします。
途中でファイルが消えた、除外範囲が広すぎた、シークレットに判別できる
形式がなかったなどの理由で、ツリーの一部を調べていないのに実行が成功
します。パターンルールは固定形式のトークンを検出できますが、人が考え
たパスワードは見逃します。そのため、チートシートは複数のツールの使用
を勧めています。スキャナーのエラーはすべて失敗として扱い、除外するの
はビルドで作り直される複製に限ります。

一つのシークレットを多くの保持者が使います。
2ホスト、2サービス、あるいはチーム全体が同じ値を使います。漏えいして
も、ログではどの複製から流出したか分からず、交換するには、すべての保
持者に対して同時に新しい値を反映しなければなりません。SP
800-53は、グループやロールのアカウントの認証子を、メンバーが変わるた
びに変更するよう求めています。保持者ごとにシークレットを分ければ、一
斉の調整ではなく、一つの値の交換で済みます。

シークレットがビルドとともに配布されたり、ログに出たりします。
コンテナーイメージ、バンドルされたスクリプト、デバッグ出力によって、
値が本来置かれるべき場所の外へ運ばれます。ASVSは、ソースコードと並ん
でビルド成果物も対象として明記しています。チートシートは、シークレッ
トをログに出さず、どうしてもログ行で参照する必要がある場合はマスクす
るよう求めています。リポジトリだけでなく、ビルドの生成物もスキャンし
ます。

参考資料

  * OWASP Secrets Management Cheat Sheet —
シークレットのライフサイクル、コミット前の検出、漏えい後の対処順序を
説明しています。

  * OWASP Application Security Verification Standard —
グループ13.3にあるシークレット管理の要件です。Vault、最小権限、更新
を扱っています。

  * NIST SP 800-53 Rev. 5 —
IA-5の認証子管理と、埋め込まれた固定の認証子を禁じるIA-5(7)を説明し
ています。

  * Gitleaks — このサイトがコミットのたびに作業ツリーを調べるために
使うスキャナーです。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/secret/	engineer.company	70
