プロキシとCookieの変更に関するセルフホストアプリのセッション問題トラブルシューティングガイド

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

安全な方法は、直接リクエストとプロキシ経由のリクエスト、レスポンスCookie、ブラウザストレージ、バックエンドのセッション状態を層ごとに比較し、単一のコマンドではなく、観測可能なゲートの連続として扱うことです。

リバースプロキシの背後にあるセルフホスト型Webアプリケーションでは、プロキシやCookieの変更後にユーザーがログアウトされる、リダイレクトループに陥る、またはセッションを確立できなくなることが実際のリスクです。現在のIDと復旧ポイントを記録し、最も影響の少ない判別方法から始め、別の変数を変更する前に成功・失敗の結果を解釈してください。ストレージが不安定になった場合、または復旧可能なコピーを公開するしかなくなった場合は作業を中止します。以下の手順は、元のワークロードが正常に動作するか、証跡がエスカレーションの境界に達した場合にのみ終了します。

1つのセッション経路を再現し、証跡を保存する

ユーザー、ブラウザプロファイル、ホスト名、ログイン経路を1つずつ選びます。最初に失敗したリクエスト、ステータスの推移、リダイレクト先、値を伏せたレスポンスのSet-Cookieヘッダー、リクエストのCookie、プロキシログ、アプリケーションログ、および失敗の直前に行った正確な設定変更を記録します。

まずすべてのCookieを削除したり、アプリケーションのシークレットをローテーションしたりしないでください。クリーンな対照条件としてプライベートブラウザプロファイルを使い、問題が発生しているプロファイルは比較用に残します。バックエンドへの直接アクセスで動作するか確認してください。これにより、アプリケーションの認証と、プロキシ由来のURLやCookieの挙動を切り分けられます。

アプリケーションがログにトークンを出力している場合、プロキシが信頼されていないクライアントからの偽装転送ヘッダーを受け入れる場合、またはログイン時にTLSが迂回される場合は、作業を中止してください。認証情報を保護し、機能面のトラブルシューティングを続ける前にセキュリティ境界を正してください。

スキーム、ホスト、転送ヘッダーの信頼設定を確認する

外部URLとアプリケーションが認識している値を比較します。スキーム、ホスト、ポート、ベースパス、クライアントIPを確認してください。Host、X-Forwarded-Protoまたは標準化された転送ヘッダー、およびアプリケーションの信頼済みプロキシ一覧を調べます。HTTPSリクエストをHTTPだと認識しているバックエンドは、Secure Cookieを拒否したり、HTTPSへのリダイレクトを繰り返したりすることがあります。

信頼できるプロキシを1台だけ使って転送ヘッダーを設定または置き換え、アプリケーションが信頼する転送ホップもその1台だけに設定します。クライアントが送信した値を検証せずに追加してはいけません。変更するたびにログインと絶対URLへのリダイレクトを1回ずつテストし、プロキシヘッダーとアプリケーションのベースURLを同時に変更しないでください。

ZimaSpaceの直接接続とプロキシ経由のログイン診断ガイドでは、プロキシ再起動後に同じ直接接続とプロキシ経由の比較を行っています。Immichの例は対象がより限定的ですが、検証手順は応用できます。まずバックエンドのセッションが機能することを確認し、その後、転送ヘッダー、ルーティング、ブラウザーの状態を調べてください。

Cookieのスコープとブラウザーの判断を調べる

Cookie名、Domain、Path、Secure、HttpOnly、SameSite、有効期限、および異なるパスやドメインに同名のCookieが重複して存在するかどうかを確認します。ブラウザーの開発者ツールでは、Cookieが保存されたか、拒否されたか、次のリクエストから省かれたかを確認できます。サーバーログだけでは、その判断は分かりません。

OWASPのSameSite Cookieの動作に関する解説では、SameSiteの値がクロスサイトでのCookie送信をどのように制御するか説明しています。認証でサイトをまたぐ場合や埋め込みフローを使用する場合、SameSite=NoneにはSecureも必要です。単純な同一サイトのアプリケーションでは、Cookieの範囲を不必要に広げると設計の安全性が低下します。

記録を取ってから、制御用プロファイルで影響を受けたCookieだけを削除し、ログインを再試行します。新しいCookieでは機能するのに、保持したプロファイルでは失敗する場合は、スコープと有効期限を比較します。両方とも失敗する場合は、状態を繰り返し消去するのではなく、レスポンスヘッダーまたはバックエンドのセッションストレージを再確認します。

共有セッションの状態を確認し、修正を検証する

複数のコンテナやレプリカで構成されたアプリケーションでは、必要に応じて、すべてのインスタンスで同じセッション署名シークレット、時刻ソース、共有セッションバックエンドが使われていることを確認します。プロキシが複数のインスタンスを交互に選択し、そのうちの1つが別のインスタンスのCookieを検証できないと、ランダムにログアウトするように見えることがあります。

PortSwiggerによるSameSiteのセキュリティ境界に関する解説はセキュリティに重点を置いていますが、SameSiteは汎用的なログイン修復スイッチではなく、ブラウザーの境界であることを明確にしています。アプリケーションの実際のオリジンとリダイレクトフローに合わせながら、CSRF対策を維持してください。

ログイン、ログアウト、アイドル時の有効期限切れ、ブラウザーの再起動、パスワード変更、および想定される内部・リモートのホスト名経由でのアクセスを検証します。古いCookieが安全に無効となり、新しいセッションが通常のルーティングで維持され、文書化された必要性を超えて転送設定やCookie属性が緩和されていない場合にのみ、問題をクローズしてください。

サポートとヒント

続きを読む

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.