Home AssistantのシークレットがComposeファイルやバックアップに漏れるのを防ぐ方法

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

共有可能なCompose定義に値を含めず、バックアップや診断用エクスポートは内容のスキャンに合格するまで機密情報として扱い、シークレットの漏えいを防ぎましょう。

Home Assistantは実行時に認証情報を必要とするため、ホストへの完全なアクセス権を持つ管理者からシークレットを隠せるローカル構成はありません。現実的な目標は、誤ったコミット、サポートへのアップロード、広範囲なバックアップコピー、不要なコンテナアクセスを防ぐことです。各値がスタックに入る経路を洗い出し、管理されたシークレットソースに置き換え、シークレット自体を出力せずにエクスポート済みファイルを検査してください。

シークレットが流出し得る場所をすべて把握する

APIトークン、データベースのパスワード、MQTT認証情報、Webhook URL、暗号化キー、秘密証明書、リカバリーキーを一覧にします。それぞれについて、実行時の使用先、保存場所、ファイル所有者、バックアップへの包含、リポジトリへの登録状況、ログへの露出、ローテーション方法を記録します。値そのものは一覧に記載しないでください。

シークレットファイルを使うと値を整理できますが、ホスト上で読み取り権限を持つアカウントには平文のままです。この平文へのアクセス境界があるため、分離によって主に減らせるのは誤開示であり、完全な権限を持つ攻撃者を阻止できるわけではありません。

ComposeのYAML、バージョン管理対象の環境変数ファイル、広く読み取り可能な設定ディレクトリ、または内容が不明なエクスポートにリテラル値が含まれていれば、問題ありと判断します。すべての露出経路に担当者が割り当てられ、修正されるまで、共有とリポジトリへのプッシュを停止してください。

実行時のシークレットとデプロイ定義を分離する

Compose内のリテラル値を、権限を必要最小限に絞ったファイルベースのシークレット、またはデプロイ環境でサポートされている別のシークレットソースに置き換えます。各サービスには、実際に使用する値だけを渡し、可能な場合は読み取り専用でマウントします。ホスト上のアクセス権は、実行時のユーザーと管理者に限定してください。

環境変数の値は、インスペクションやプロセスの情報、ログを通じて露出することがあります。一方、ファイルベースのシークレットマウントを使えば、認証情報を受け取るコンテナを限定できます。ローカルのシークレットファイルにも、引き続きアクセス権の管理が必要です。

まずプレースホルダーで検証し、レンダリングされたCompose設定に意図しないリテラル値がないか確認してから、サービスを1つ起動し、割り当てられたシークレットだけを読み取れることを確認します。変更によってアプリケーションが値を出力するようになった場合や、過度に広いディレクトリアクセスが必要になった場合は、ロールバックしてください。

バックアップとサポートバンドルに含める内容を管理する

対象範囲が明確に証明されていない限り、バックアップには認証情報が含まれるものとして扱ってください。信頼できるストレージの範囲外に持ち出すコピーは暗号化し、復旧キーは別の場所に保管し、保持期間とアクセスを制限してください。また、サポートの質問に編集済みログの抜粋で答えられる場合は、設定全体のアーカイブを添付しないでください。

設定保護のワークフローを使用して復旧可能な状態を維持しながら、安全に保管するものと共有可能なデプロイ資料を分離します。

リリース前に、ファイル名と抽出テキストを対象に、既知のキー名、トークンのプレフィックス、非公開URL、メールアドレス、証明書、管理されたテストマーカーの正確なハッシュをスキャンします。スキャンに問題がないことはリリースの必須条件ですが、未知の形式のシークレットが存在しない証明にはなりません。

露出したシークレットをローテーションし、予防策を検証する

使用可能な値がリポジトリ、チケット、チャット、公開リンク、または信頼できないバックアップに入った場合は、まず失効させるかローテーションしてください。表示されているコピーを削除しても、コピーや履歴が無効になるわけではありません。古い値を残さずに、影響を受けたサービスとローテーション時刻を記録してください。

無害なカナリアシークレットを作成し、新しい経路でデプロイして、通常のComposeレンダリング、バックアップ、診断バンドルを生成し、それらのアーティファクトを検索します。実行時にはカナリアが渡される一方、意図的に保護されたバックアップの範囲外では、共有可能なアーティファクトにカナリアが露出しないようにします。

実際のシークレットがデプロイ定義やリポジトリに存在せず、保護されたバックアップに独立した復旧経路があり、アーティファクトのスキャンに合格し、露出した認証情報がローテーションされたら、作業を終了します。サードパーティ連携がシークレットの値をログに記録する場合や、ホストへの広範なアクセスなしでは限定されたシークレットソースを利用できない場合は、エスカレーションしてください。

サポートとヒント

続きを読む

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.