アプリ、データベース、バックアップ向けホームサーバーのシークレットローテーションチェックリスト

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

安全な方法は、棚卸しに基づくローテーションを、重複期間のある認証情報、利用者の検証、失効、復旧用情報の更新を伴う一連の観測可能なチェックポイントとして扱うことです。単一のコマンドとして扱ってはいけません。

セルフホスト型アプリ、データベース、バックアップジョブ、自動化を備えたホームサーバーでは、認証情報を1つローテーションするだけで、把握されていない利用者、スケジュール済みバックアップ、アプリケーションの依存関係が壊れるおそれがあります。現在のIDと復旧ポイントを記録し、影響が最も小さい判別方法から始めます。別の変数を変更する前に成功・失敗の結果を解釈し、ストレージが不安定になった場合や、復旧可能な唯一のコピーが危険にさらされる場合は中止してください。以下の手順は、元のワークロードが正常に動作するか、証拠がエスカレーションの境界に達した時点でのみ完了します。

各シークレットとその影響範囲を一覧にする

データベースのパスワード、APIトークン、バックアップリポジトリのキー、暗号化キー、Webhookシークレット、プロキシ認証情報、サービスアカウントキーを一覧にします。それぞれについて、値そのものは記録せず、発行元、権限、保管場所、利用者、再読み込み方法、バックアップへの依存関係、復旧担当者、最終使用の証拠を記録します。

GitGuardianの認証情報ローテーションの影響範囲では、影響範囲と所有者を基準にローテーションを捉えています。認証情報は、作成した担当者やサービスより長く存続する場合があり、有効かどうかだけでは、すべての利用者を特定できません。失効を予定する前に、設定、シークレットストア、スケジュール済みジョブ、CI変数を検索してください。

緊急時のローテーションと計画的なローテーションを分けて扱います。侵害が疑われる場合は、稼働時間より封じ込めと迅速な失効を優先することがあります。それ以外の場合は、データベースやバックアップで使用するシークレットを変更する前に、復旧ポイントを確保し、ロールバック手順をテストしてください。

有効期間を重ねて、まず発行元を更新する

対応している場合は、古い認証情報が有効な間に、同じ最小権限を持つ2つ目の認証情報を作成します。データベースでは2つ目のロールまたはデュアルパスワード機能を使い、APIサービスでは2つ目のトークンを発行します。暗号化キーでは、キー ファイルを場当たり的に置き換えるのではなく、製品の再ラップまたはキー スロットの手順に従います。

ダウンタイムなしでデータベースの認証情報をローテーションするガイドでは、元のユーザーを失効させる前に、利用側を2つ目のユーザーに移行する2ユーザー認証情報ローテーションのパターンを紹介しています。各利用側を個別に検証できるため、この方法は共有パスワードをその場で1つだけ変更するより安全です。

認証情報を併用できない場合は、メンテナンス時間を設定し、依存する書き込み処理とバックアップジョブを停止して、正確なロールバックコマンドを文書化してください。別のリカバリテストで新しいものの有効性が確認されるまで、唯一の正常なリポジトリパスワードや暗号化キーを上書きしないでください。

すべての利用側を更新し、新しい認証情報の使用を確認する

保護されたシークレットファイルまたはシークレットマネージャーを更新し、利用側を1つずつ再読み込みするか再作成してください。アプリケーションへのログイン、データベースの読み書き、バックグラウンドワーカー、監視、Webhook、リモートレプリケーション、定期バックアップと手動バックアップの両方をテストしてください。実行中のコンテナが、メモリ上に古い値を保持している場合があります。

認証情報をCompose YAMLに記載せずに保管するには、ZimaSpaceのDockerシークレットの保管ガイドを利用してください。レンダリング済みの設定、環境変数の確認結果、ログ、シェルの履歴、サポート用バンドルに、古い値も新しい値も表示されないようにしてください。

発行元の監査ログを確認するか、安全に隔離された経路から古い認証情報を一時的にテストして、各利用側が新しい認証情報を使っていることを確認してください。すべての依存先について担当者が決まり、テストに合格するまで、認証情報を失効させないでください。

失効、後処理、リカバリのテスト

古い認証情報を失効させ、稼働中のシークレット保管先と無効化済みのジョブから削除します。その後、少なくとも通常のスケジュールを1サイクル完了するまで、認証失敗とバックアップのアラートを監視してください。製品で必要な場合は、下流のセッショントークンやキャッシュされた接続もローテーションしてください。

暗号化されたリカバリ手順書と、保護されたオフラインの鍵のコピーを更新してください。古いシークレットを含むバックアップが、安全に暗号化され、保持期間が定められているか、それとも特別な取り扱いが必要かを判断してください。過去のバックアップを書き換えると復元可能性を損なうおそれがあり、通常、最初に取るべき対応ではありません。

古い認証情報が使えなくなり、すべての利用側が新しい認証情報で動作し、バックアップが完了し、復元またはリカバリ用ログインが成功した時点で、ローテーションは完了です。ロールバックは事前に文書化した方法だけで行ってください。原因不明の認証失敗が起きた場合は、管理対象の洗い出しが不完全だったことを意味します。広範囲に使える新しい認証情報を追加して、古い認証情報の失効を隠してはいけません。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.