HTTP セッション (httpSession)
HTTP セッション管理の構成。
| 属性名 | データ型 | デフォルト値 | 説明 |
|---|---|---|---|
| allowOverflow | boolean | true | メモリー内のセッション数が「メモリー内の最大セッション・カウント」プロパティーの値を超えることを許可します。 |
| alwaysEncodeUrl | boolean | false | サーブレット 2.5 仕様では、response.encodeURL 呼び出しで URL をエンコードする必要がない場合は、エンコードしないようにということが規定されています。 URL のエンコーディングを使用可能にした場合の後方互換性をサポートするには、このプロパティーを true に設定して encodeURL メソッドを呼び出します。ブラウザーで Cookie をサポートする場合でも、URL は常にエンコードされます。 |
| cloneId | string | クラスター・メンバーのクローン ID。 クラスター内では、セッションのアフィニティーを維持するために、この ID は固有でなければなりません。このプロパティーを設定すると、サーバーが生成するデフォルト名がこの名前で上書きされます。 | |
| cloneSeparator | string | : | セッション Cookie でクローン ID からセッション ID を分離するために使用する単一文字。通常、デフォルト値を使用してください。一部の Wireless Application Protocol (WAP) デバイスでは、コロン (:) を使用できないため、正符号 (+) を代わりに使用してください。別の値はほとんど使用しません。このプロパティーを使用してクローンの分離文字を変更する前に、ご使用のシステムで稼働している他の製品のクローンの文字に関する要件を理解しておく必要があります。このプロパティーの値には任意の文字を指定できますが、このことは、指定した文字が正しく動作するという意味ではありません。また、代替文字の使用により生じる可能性のあるすべての問題を修正する責任が IBM にあるということを意味しているわけでもありません。 |
| cookieDomain | string | セッション・トラッキング Cookie のドメイン・フィールド。 | |
| cookieHttpOnly | boolean | true | セッション Cookie に HttpOnly フィールドを組み込むように指定します。HttpOnly フィールドをサポートするブラウザーでは、クライアント・サイドのスクリプトが Cookie にアクセスできなくなります。HttpOnly フィールドを使用すると、クロスサイト・スクリプティング・アタックからの防御に役立ちます。 |
| cookieMaxAge | 期間 (精度: 秒) | -1 | Cookie がクライアント・ブラウザーに存在可能な最大時間。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。 |
| cookieName | string | JSESSIONID | セッション管理 Cookie の固有名。 |
| cookiePath | string | / | このパスに指定されている URL に Cookie が送信されます。 |
| cookieSecure | boolean | false | セッション Cookie にセキュア・フィールドを組み込むように指定します。 |
| cookiesEnabled | boolean | true | セッション・トラッキングでセッション ID を運ぶために Cookie を使用するように指定します。 |
| debugCrossover | boolean | false | このオプションを使用可能にすると、要求に関連付けされたセッションのみがアクセスまたは参照されたことを確認する追加検査を実行し、反する状況が検出された場合はメッセージをログに記録します。このオプションを使用不可にすると、この追加検査をスキップします。 |
| forceInvalidationMultiple | int | 3 | 要求が通常、応答時間制限によって制約されていない場合、0 を指定すると、要求が完了してからセッションの無効化が試行されるまで、セッション・マネージャーが無制限に待機することを指示します。それ以外の場合は、アクティブ・セッションの無効化を遅延するための正整数をこのプロパティーに指定します。タイムアウトになったアクティブ・セッションは、最初の無効化間隔の経過では無効化されず、この値に基づく間隔の経過で無効化されます。例えば、値が 2 の場合、セッション・タイムアウトが発生してから、2 回目の無効化間隔が経過するとアクティブ・セッションが無効化されます。 |
| idLength | int | 23 | セッション ID の長さ。 |
| idReuse | boolean | false | セッション・パーシスタンス用に構成されていないマルチ JVM 環境で、このプロパティーを「true」に設定すると、ユーザーのすべての要求を処理する Web アプリケーションが別の JVM によって管理されている場合でも、セッション・マネージャーは、それらの要求に対して同じセッション情報を使用することができます。このプロパティーのデフォルト値は false です。セッション・マネージャーが、ブラウザーから送信されたセッション ID を使用して、セッション・パーシスタンス用に構成されていない環境で稼働中の Web アプリケーション全体のセッション・データを保存できるようにする場合は、このプロパティーを true に設定します。 |
| invalidateOnUnauthorizedSessionRequestException | boolean | false | 無許可要求に対して、セッション・マネージャーが UnauthorizedSessionRequestException を発行する代わりにセッションを無効化するようにしたい場合は、このプロパティーを true に設定します。 セッションが無効化されると、要求側は新しいセッションを作成できますが、既に保存されたどのセッション・データにもアクセスすることはできません。これにより、ある単一のユーザーが、セッション・データをまだ保護し続けている間にログアウトを行った後も、他のアプリケーションへの要求の処理を続けることができます。 |
| invalidationTimeout | 期間 (精度: 秒) | 30m | セッションが使用されなくなってから無効になるまでの時間。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。 |
| maxInMemorySessionCount | int | 1000 | 各 Web モジュールのメモリー内で保持されるセッションの最大数。 |
| noAdditionalInfo | boolean | false | セッション ID で必要でない情報を強制的に削除します。 |
| protocolSwitchRewritingEnabled | boolean | false | URL で HTTP から HTTPS へ、あるいは HTTPS から HTTP への切り替えが必要となる場合に、セッション ID を URL に追加します。 |
| reaperPollInterval | 期間 (精度: 秒) | -1 | 無効なセッションを除去するプロセスのウェイクアップの間隔 (秒)。最小値は 30 秒です。最小値より小さい値を入力すると、適切な値が自動的に判別されて使用されます。この値は、デフォルトのインストール値をオーバーライドします。デフォルトのインストール値は、セッション・タイムアウト値に応じて 30 秒から 360 秒の間になります。デフォルトのセッション・タイムアウトは 30 分であるため、リーパー間隔は通常、2 分から 3 分の間です。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。 |
| rewriteId | string | jsessionid | このプロパティーを使用して、URL の書き換えで使用するキーを変更します。 |
| securityIntegrationEnabled | boolean | true | セキュリティー統合を使用可能にします。これにより、セッション管理機能がユーザーの ID を HTTP セッションに関連付けます。 |
| securityUserIgnoreCase | boolean | false | セッション・セキュリティー ID とクライアント・セキュリティー ID が、大/小文字が異なっていても一致とみなされるように指示します。例えば、このプロパティーを true に設定した場合、セッション・セキュリティー ID の USER1 は、クライアント・セキュリティー ID の User1 や user1 と一致します。 |
| sslTrackingEnabled | boolean | false | セッション・トラッキングが Secure Sockets Layer (SSL) 情報をセッション ID として使用することを指定します。 |
| urlRewritingEnabled | boolean | false | セッション管理機能が、セッション ID を運ぶために再書き込み URL を使用するように指定します。 |
| useContextRootAsCookiePath | boolean | false | Cookie パスが、/ ではなく Web モジュールのコンテキスト・ルートと同じであることを指定します |
参照トピック