スティッキCookieを使用したセッション永続性の有効化
アプリケーション・ゲートウェイでCookieを使用して永続セッションを有効にします。スティッキCookieは、同じバックエンド・サーバーに転送されます。
スティッキ・サポートを使用する必要があるのは、複数のオリジンがある場合のみです。これを行うには、NGINX upstreamブロックを作成します。
スティッキ・パラメータ
upstream {
sticky;
server 127.0.0.1:9001;
server 127.0.0.1:9002;
}
sticky [hash=index|md5|sha1] [no_fallback]
[name=route] [domain=.example.com] [path=/] [expires=1h] [secure] [httponly];
or
sticky [hmac=md5|sha1 hmac_key=<foobar_key>] [no_fallback]
[name=route] [domain=.example.com] [path=/] [expires=1h] [secure] [httponly];
or
sticky [text=raw] [no_fallback]
[name=route] [domain=.example.com] [path=/] [expires=1h] [secure] [httponly];
サーバー選択アルゴリズム
アルゴリズム | 説明 |
---|---|
hash
|
アップストリーム・サーバーのエンコードに使用されるハッシュ・メカニズム。これは、 デフォルトは |
hmac
|
アップストリーム・サーバーのエンコードに使用されるHMACハッシュ・メカニズム。ハッシュ・メカニズムと同様ですが、ハッシュの保護にhmac_key が使用されます。これは、hash またはtext とともに使用できません。 |
hmac_key
|
hmac で使用する暗号化キー。hmac を使用する場合は、hmac_key を設定します。 |
no_fallback
|
このフラグを設定すると、リクエストにCookieが含まれ、対応するバックエンドが使用できない場合、502 (不正なゲートウェイまたはプロキシ・エラー)が返されます。upstreamブロックにこれを設定することも、serverまたはlocationブロックにsticky_no_fallback を設定することもできます。 |
Cookie設定
設定 | 説明 |
---|---|
name
|
永続アップストリーム・サーバーのトラッキングに使用されるCookieの名前。デフォルトはroute です。 |
domain
|
Cookieが有効なドメイン。ブラウザでドメインを処理する場合、デフォルトはnone です。 |
path
|
Cookieが有効なパス。デフォルトは/ です。 |
expires
|
Cookieの有効期間。デフォルトは 指定した時間の経過後にCookieを期限切れにするための値を入力します。この値はクライアントを基準として設定され、1秒より長い期間である必要があります。 |
secure
|
HTTPSのみを使用して転送されるセキュアなCookieを有効にします。 |
httponly
|
サーバーのみがCookieにアクセスできることをブラウザに指示します。 |