セッション状態サービスを再起動せずにリバースプロキシを再起動する方法

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

リバースプロキシを背後の認証サービスやセッション状態サービスとは独立してリロードまたは再起動できると、計画的なプロキシのメンテナンスがより安全になります。

通常、プロキシプロセスが転送先のログイン状態を管理する必要はありません。メンテナンスの前に、どのコンポーネントがCookieに署名し、サーバー側のセッションを保存し、認証を処理し、アクティブなHTTP接続を処理し終えるのかを把握してください。これらの状態を保持するコンポーネントは稼働させたままにし、設定だけを変更する場合はグレースフルなプロキシのリロードを優先してください。また、プロキシを完全に置き換える場合は、同じ認証ゲートウェイとセッションストアに、シークレットを変更せずに再接続できることを確認してください。

プロキシと認証サービスのライフサイクルを分離する

プロキシの再起動によって認証ゲートウェイ、アプリケーション、Redis、データベースが自動的に再作成されないよう、Composeの依存関係、再起動ポリシー、共有スクリプト、スタックマネージャーの操作を確認してください。

セッションアーキテクチャの例では、複数の認証インスタンスや再起動後も同じセッションバックエンドを共有できるよう、Redisをプロキシのライフサイクルの外部に配置しています。

すべてのエッジサービスを、一括再起動コマンドでまとめて扱わないでください。証明書またはルートの変更がプロキシにしか影響しない場合は、既存のログイン状態を検証するサービスをそのまま稼働させてください。

可能な場合は再起動せずに設定をリロードする

ルート、証明書、ヘッダーを変更する場合は、サービスを停止するのではなく、プロキシがサポートするグレースフルリロードの手順を使ってください。構文エラーによって予定していたメンテナンスがダウンタイムにならないよう、適用前に設定を検証してください。

API7のNGINXガイドでは、更新された設定のもとで新しいワーカーがリクエストを受け付ける間に、古いワーカーが接続を処理し終える仕組みを説明しています。

リロードではプロキシのプロセス群は維持されますが、デプロイスクリプトが別の認証サービスも再起動する場合、そのサービスは保護されません。この2つのライフサイクルは別々に考えてください。

プロキシの置き換え後も外部セッションストレージを維持する

認証ゲートウェイがCookie以外にセッションデータを保存する場合は、プロキシの操作中も、そのRedisまたはその他のセッションバックエンドを永続化し、変更しないでください。すべての認証インスタンスで使用されているバックエンドのアドレスとシークレットを記録してください。

OAuth2 Proxyは、インスタンス間でセッションを共有する必要がある場合に、共有セッションストレージとしてRedisをサポートしています。

破棄可能なキャッシュと、正規のログイン状態を混同しないでください。現在のユーザーの検証にセッションバックエンドが必要な場合は、テスト済みの独自のメンテナンス手順に従ってのみ、再起動またはフラッシュしてください。

Cookieと署名シークレットを安定させる

認証ゲートウェイで使用するCookie暗号化用または署名用の秘密情報を記録し、交換後のプロキシスタックが同じ秘密情報ソースをマウントすることを確認します。再デプロイ時に新しい値を生成すると、ブラウザーのCookieが正常でも無効になります。

リバースプロキシのセッションガイドでは、安定したセッションポリシーなら再起動後もセッションが維持されることを説明しています。単一のTCP接続の存続期間に依存するわけではありません。

署名用の秘密情報のローテーションは、ログアウトが発生することを明示するか、重複期間を設けるなど、通常の計画的なプロキシリロードとは別のセキュリティ変更として実施してください。セッションを無効にする意図がない限り、秘密情報のローテーションを通常の計画的なプロキシリロードと同時に行わないでください。

プロキシを完全再起動する際は接続をドレインする

プロキシのバイナリやコンテナを交換する必要がある場合は、利用可能であればグレースフルまたは無停止の再起動機能を使い、処理中のリクエストが応答の途中で切断されないようにします。長時間維持される接続には、メンテナンスタイムアウトを設定してください。

HAProxyのリロードに関するガイドでは、古いプロセスをすぐに終了させるのではなく、無停止リロードで接続を維持する方法を紹介しています。

接続の維持とログイン状態の維持は別のものです。WebSocketが再接続しても、交換後のプロキシが同じ認証サービスと状態管理サービスに接続できるため、セッションは有効なまま維持されるはずです。

計画的なメンテナンスの前後で1つのセッションをテストする

ログイン済みのブラウザーを1つと、新しいプライベートセッションを1つ用意します。メンテナンス前にセッションCookie、プロキシのルート、認証サービス、バックエンドを記録し、プロキシだけをリロードまたは交換してから、同じ保護対象リクエストを再実行します。

Caddyの運用ガイドでは、計画的な設定更新には完全再起動ではなくリロードを推奨しています。

既存のログイン状態が維持され、新しいログインも成功し、ステートフルな依存関係が意図せず再起動されていなければ、メンテナンス設計は機能しています。ユーザーがまだログアウトされている場合は、関連するZimaSpaceの記事「プロキシ再起動後のセッション喪失」が適切な復旧手順です。

よくある質問

プロキシをグレースフルリロードすれば、ユーザーがログイン状態を維持できることは保証されますか?

いいえ。プロキシ接続は保護されますが、認証サービス、セッションストア、Cookie署名用の秘密情報が同時に変更されると、ユーザーはログアウトされる可能性があります。

Redisは常にプロキシの再起動後も稼働し続ける必要がありますか?

Redisがセッション状態、または認証に必要な別の永続的な依存関係を保存している場合に限ります。キャッシュ専用のRedisインスタンスでは、復旧の対象範囲が異なります。

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.