プライベートクラウドへのログインが自宅のネットワーク外でのみループするのはなぜですか?

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

外部からのログイン時だけループする場合、通常はリモートのプロキシ経路によって、アプリが認識するスキーム、ホスト名、Cookie、コールバック、またはセッション情報が変わっています。

自宅内では、ブラウザーがローカルアドレスを使ってプライベートクラウドサービスに直接接続する一方、リモートユーザーはパブリックDNS、TLS終端、リバースプロキシ、フォワード認証レイヤー、トンネル、またはIDプロバイダーを経由してアクセスすることがあります。認証情報が正しく受け入れられても、セッションCookieが保存または返送されない、バックエンドがHTTPSをHTTPだと認識する、コールバックURLが登録値と異なる、あるいはアプリケーションが内部ホスト名へのリダイレクトを生成すると、次のリクエストでログインページに戻ることがあります。

ブラウザーでリダイレクトループを正確に記録する

自宅の外からログインする前に、ブラウザーのネットワークパネルを開いてください。リクエストログを保存し、各ステータスコード、Locationヘッダー、Set-Cookieヘッダー、リクエストのホスト名、次のリクエストでセッションCookieが送信されているかを記録してください。

Keycloakのトラブルシューティングガイドでは、転送ヘッダーの欠落、Cookieのスコープ、コールバックが、パスワード認証に成功していても無限ログインリダイレクトを引き起こす可能性があるため、リダイレクトの全経路を確認することを推奨しています。

Cookieが発行されない場合は、アプリケーションとプロキシの応答を調べてください。Cookieが発行されても返送されない場合は、domain、path、Secure、SameSiteの各属性を確認してください。Cookieが返送されてもアプリがリダイレクトを続ける場合は、プロキシの信頼設定とセッションストレージを確認してください。

ローカルとパブリックのホスト名とスキームを比較する

httpまたはhttps、ホスト名、ポート、サブパスを含め、ローカルURLとパブリックURLを正確に記録してください。アプリケーションに正規または外部のベースURLが設定されているか確認してください。

リバースプロキシ環境のWordPressに関する分析では、バックエンドがリクエストをHTTPだと判断すると、プロキシがTLSを終端し続けているにもかかわらず、HTTPSへのリダイレクトが繰り返されることがあると説明されています。このループの原因はユーザーのパスワードではなく、プロキシ背後でのHTTPS検出の誤りです。

リモートログイン、コールバック、Cookieには、同じパブリックホスト名を一貫して使用してください。アプリケーションが複数の信頼済みオリジンを明示的にサポートしている場合を除き、1つの認証フロー内でパブリックドメイン、プライベートIP、内部ホスト名、別のポートを混在させないでください。

転送されるHostヘッダーとProtocolヘッダーを確認する

リバースプロキシの設定とバックエンドのログで、X-Forwarded-Proto、X-Forwarded-Host、X-Forwarded-Port、および元のクライアントアドレスを確認してください。アプリケーションが既知のプロキシのみを信頼し、ブラウザーが使用したものと同じパブリックURLを再構成していることを確認してください。

qBittorrentのリバースプロキシ事例では、ログインページが読み込まれ、認証情報を受け付けても、HostまたはHTTPSヘッダーの不一致によって認証済みセッションが認識されないことがあると説明されています。

プロキシが正しいパブリック値を送信しているのにアプリが無視する場合は、アプリケーションの信頼するプロキシと外部URLの設定を構成してください。プロキシが値を省略している場合は、クライアントが送信したすべてのヘッダーをそのまま転送するのではなく、必要最小限のヘッダーを追加してください。

CookieのDomain、Path、Secure、SameSiteを確認する

ローカルで作成されたセッションCookieと、パブリックドメイン経由で作成されたセッションCookieを比較してください。内部ホスト名、誤った親ドメイン、異なるサブパス、または非セキュアなコンテキストにスコープされたCookieは、リダイレクト後のパブリックリクエストに含まれないことがあります。

外部アクセスでは、別の認証ドメインやクロスサイトのコールバックが追加されることがよくあります。そのため、ローカルで直接ログインする場合は1つのオリジン内で完結していても、SameSiteの制限やSecureの要件がリモート接続のフローに影響することがあります。

影響を受けるプライベートクラウドのドメインに限ってCookieを削除し、ループを再現して、新しい属性を調べます。アプリケーションまたはプロキシの公開URLとCookieの設定を修正してください。ブラウザー全体のCookie制限を緩和する方法を、サーバー側の恒久的な対処として使わないでください。

OAuth、OIDC、Forward-Authのコールバック識別情報を確認する

プライベートクラウドでIDプロバイダーやForward-Authサービスを使用している場合は、アプリが生成するコールバックURL、プロバイダーに登録されているURL、ブラウザーからアクセスされるURLを照合してください。スキーム、ホスト名、ポート、パス、末尾のスラッシュはすべて完全に一致させる必要がある場合があります。

NGINXコミュニティの事例では、プロキシでTLSが終端される一方、バックエンド側ではHTTPとして認識されるため、アプリケーションが想定される安全な外部セッションを維持できず、リモートログインループが発生しています。

公開ドメイン経由でコールバックエンドポイントに直接アクセスし、正しいプロキシルートとバックエンドに到達することを確認します。認証には成功してもコールバックでログインが再開される場合は、state、nonce、Cookieの保持、時刻同期、正確なリダイレクトURIを調べてください。

プロキシを迂回せずにリモートセッション全体を検証する

原因を1つ修正したら、まず外部ネットワークからシークレットウィンドウを開きます。ログインしてダッシュボードを再読み込みし、ファイルを開き、短いセッション間隔を超えて待機した後、再接続して通常の操作中もセッションが維持されることを確認します。

ZimaSpaceガイドのNASへのリモートアクセスを制御する方法では、セキュリティ境界について詳しく説明しています。ループを解消するために、バックエンドを直接公開したり、認証を無効にしたりする必要はありません。

ローカルユーザーとリモートユーザーが意図したホスト名にアクセスでき、プロキシが公開リクエストの識別情報を保持し、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.