HTTP 階段作業 (httpSession)

HTTP 階段作業管理的配置。

名稱	類型	預設值	說明
allowOverflow	boolean	true	容許記憶體內的階段作業數目可以超出「記憶體內階段作業數目上限」內容的值。
maxInMemorySessionCount	int	1000	針對每個 Web 模組在記憶體內維護的階段作業數目上限。
Cookie
cookieDomain	string		階段作業追蹤 Cookie 的網域欄位。
cookieHttpOnly	boolean	true	指定階段作業 Cookie 是否包含 HttpOnly 欄位。支援 HttpOnly 欄位的瀏覽器不會讓用戶端 Script 可以存取 Cookie。使用 HttpOnly 欄位將有助於防止跨網站 Script 攻擊。
cookieMaxAge	精準度是秒鐘的時間量	-1	Cookie 可以位於用戶端瀏覽器上的時間量上限。. 指定正整數加上時間單位，時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如，指定 30 秒為 30s。您可以在單一項目中包括多個值。例如，1m30s 相等於 90 秒。
cookieName	string	JSESSIONID	階段作業管理 Cookie 的唯一名稱。
cookiePartitioned	defer false true	defer	指定階段作業 Cookie 包括「已分割」屬性。僅當 SameSite 屬性設為 none 且僅由支援 Cookie 分割的瀏覽器使用時，才會套用 Partitioned 屬性。預設值為「延遲」。 defer 容許 HTTP 傳輸設定判定是否已設定「分割區」。 false 請勿將分割區新增至階段作業 Cookie。 true 一律將 SameSite 設為 None 的「分割區」新增至階段作業 Cookie。
cookiePath	string	/	Cookie 會傳送至路徑中指定的 URL。
cookieSameSite	Disabled Lax None Strict	Disabled	指定要用於階段作業 Cookie 的 SameSite 屬性值。 Disabled 請勿在階段作業 Cookie 上設定 SameSite 屬性值 Lax 將階段作業 Cookie SameSite 屬性值設為 Lax None 將階段作業 Cookie SameSite 屬性值設為 None Strict 將階段作業 Cookie SameSite 屬性值設為 Strict
cookieSecure	boolean	false	指定階段作業 Cookie 是否包含安全欄位。
useContextRootAsCookiePath	boolean	false	指明 Cookie 路徑等於 Web 模組的環境定義根目錄，而不是 /
URL 重新編寫
alwaysEncodeUrl	boolean	false	Servlet 2.5 規格指定不將 response.encodeURL 呼叫上的 URL 編碼（如果非必要的話）。如果要在已啟用 URL 編碼時支援舊版相容性，請將這個內容設定為 true 以呼叫 encodeURL 方法。即使瀏覽器支援 Cookie，也一律會將 URL 編碼。
protocolSwitchRewritingEnabled	boolean	false	當 URL 需要從 HTTP 切換至 HTTPS 或從 HTTPS 切換至 HTTP 時，將階段作業 ID 新增至 URL 中。
rewriteId	string	jsessionid	請使用這個內容來變更與 URL 重新編寫一起使用的索引鍵。
失效
forceInvalidationMultiple	int	3	如果您的要求通常不受限於回應時間限制，請指定 0 來指出階段作業管理程式在試圖使階段作業失效之前，應無限期等待直到要求完成。否則，請將這個內容設定為正整數，以延遲讓作用中階段作業失效。作用中的逾時階段作業將不會因第一個失效間隔傳遞而失效，但是將會根據此值的間隔傳遞而失效。例如，值 2 會在階段作業逾時值過期之後，使第二個失效間隔傳遞上的作用中階段作業失效。
invalidationTimeout	精準度是秒鐘的時間量	30m	階段作業在失效之前可保持未使用的時間量，如果沒有指定時間單位，則以秒為單位。. 指定正整數加上時間單位，時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如，指定 30 秒為 30s。您可以在單一項目中包括多個值。例如，1m30s 相等於 90 秒。
reaperPollInterval	精準度是秒鐘的時間量	-1	移除無效階段作業之程序的起動間隔（以秒為單位）。下限值為 30 秒。如果輸入小於下限的值，會自動判定並使用適當的值。這個值會根據階段作業逾時值來置換預設安裝值，其介於 30 到 360 秒之間。由於預設階段作業逾時值是 30 分鐘，因此收割者間隔通常是介於 2 到 3 分鐘之間。. 指定正整數加上時間單位，時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如，指定 30 秒為 30s。您可以在單一項目中包括多個值。例如，1m30s 相等於 90 秒。
失效接手
cloneId	string		叢集成員的複本 ID。在叢集內，這個 ID 必須是唯一的，才能保持階段作業親緣性。當設定時，這個名稱會改寫伺服器所產生的預設名稱。
cloneSeparator	string	:	用來將階段作業 ID 與階段作業 Cookie 中的複本 ID 分隔的單一字元。通常應使用預設值。在某些「無線應用程式通訊協定 (WAP)」裝置上，並不容許冒號 (:)，因此應改為使用加號 (+)。請少用不同的值。在使用這個內容來變更複本分隔字元之前，您應先瞭解在您系統上執行的其他產品之複本字元需求。您可以將任何字元指定為這個內容的值，這並不默示您指定的字元都能夠正確運作。這項事實也不默示 IBM 要負責修正使用替代字元所可能引起的任何問題。
安全
invalidateOnUnauthorizedSessionRequestException	boolean	false	對於回應未獲授權的要求，如果您希望階段作業管理程式讓階段作業失效，請將此內容設為 true，而不是發出 UnauthorizedSessionRequestException。當階段作業失效時，要求端可以建立新的階段作業，但是不能存取任何先前儲存的階段作業資料。這可讓單一使用者在登出之後，可繼續處理對其他應用程式的要求，而且又能保護階段作業資料。
securityIntegrationEnabled	boolean	true	啟用安全整合，其會導致階段作業管理機能建立使用者身分與其 HTTP 階段作業的關聯性。
securityUserIgnoreCase	boolean	false	指出即使階段作業安全身分和用戶端安全身分的大小寫不同，它們也應視為相符。例如，當這個內容設定為 true 時，階段作業安全身分 USER1 符合用戶端安全身分 User1 和 user1。
進階
accessOnTimeout	boolean	true	此內容提供對階段作業的 Servlet 存取權，即使另一個 Servlet 仍鎖定該階段作業，也容許正常執行。將此內容設為 false，以在階段作業要求逾時時，停止 Servlet 執行。預設值為 true。
allowSerializedAccess	boolean	false	啟用此選項以容許對階段作業資料進行序列化存取。
debugCrossover	boolean	false	啟用這個選項可執行附加的檢查，以確認只有存取或參照與要求相關聯的階段作業，以及日誌訊息（如果偵測到任何不相符）。停用這個選項可跳過附加檢查。
idLength	int	23	階段作業 ID 的長度。
idReuse	boolean	false	在未配置階段作業持續存在的多重 JVM 環境中，將這個內容設定為 "true" 會讓階段作業管理程式能夠對所有使用者的要求使用相同的階段作業資訊，即使處理這些要求的 Web 應用程式是由不同的 JVM 所控管亦然。這個內容的預設值為 false。如果您要讓階段作業管理程式能夠使用瀏覽器傳送的階段作業 ID，以在未配置階段作業持續性的環境所執行的 Web 應用程式之間保留階段作業資料，請將這個內容設定為 true。
maxWaitTime	int	0	Servlet 繼續執行之前，在階段作業上等待的時間量（以秒為單位）。
modifyActiveCountOnInvalidatedSession	boolean	true	當多個應用程式存取階段作業時，Httpsession activeCount 度量可能變得不準確。請將該內容設為 "false"，以解決此問題。
noAdditionalInfo	boolean	false	強制移除在階段作業 ID 中不需要的資訊。
階段作業追蹤機制
cookiesEnabled	boolean	true	指定階段作業追蹤利用 Cookie 來傳送階段作業 ID。
sslTrackingEnabled	boolean	false	指定階段作業追蹤利用 Secure Sockets Layer (SSL) 資訊來作為階段作業 ID。
urlRewritingEnabled	boolean	false	指定階段作業管理機能利用重新編寫的 URL 來傳送階段作業 ID。

名稱

類型

預設值

說明

allowOverflow

boolean

true

容許記憶體內的階段作業數目可以超出「記憶體內階段作業數目上限」內容的值。

maxInMemorySessionCount

int

1000

針對每個 Web 模組在記憶體內維護的階段作業數目上限。

Cookie

cookieDomain

string

階段作業追蹤 Cookie 的網域欄位。

cookieHttpOnly

boolean

true

指定階段作業 Cookie 是否包含 HttpOnly 欄位。支援 HttpOnly 欄位的瀏覽器不會讓用戶端 Script 可以存取 Cookie。使用 HttpOnly 欄位將有助於防止跨網站 Script 攻擊。

cookieMaxAge

精準度是秒鐘的時間量

-1

Cookie 可以位於用戶端瀏覽器上的時間量上限。. 指定正整數加上時間單位，時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如，指定 30 秒為 30s。您可以在單一項目中包括多個值。例如，1m30s 相等於 90 秒。

cookieName

string

JSESSIONID

階段作業管理 Cookie 的唯一名稱。

cookiePartitioned

defer
false
true

defer

指定階段作業 Cookie 包括「已分割」屬性。僅當 SameSite 屬性設為 none 且僅由支援 Cookie 分割的瀏覽器使用時，才會套用 Partitioned 屬性。預設值為「延遲」。
defer
容許 HTTP 傳輸設定判定是否已設定「分割區」。
false
請勿將分割區新增至階段作業 Cookie。
true
一律將 SameSite 設為 None 的「分割區」新增至階段作業 Cookie。

cookiePath

string

Cookie 會傳送至路徑中指定的 URL。

cookieSameSite

Disabled
Lax
None
Strict

Disabled

指定要用於階段作業 Cookie 的 SameSite 屬性值。
Disabled
請勿在階段作業 Cookie 上設定 SameSite 屬性值
Lax
將階段作業 Cookie SameSite 屬性值設為 Lax
None
將階段作業 Cookie SameSite 屬性值設為 None
Strict
將階段作業 Cookie SameSite 屬性值設為 Strict

cookieSecure

boolean

false

指定階段作業 Cookie 是否包含安全欄位。

useContextRootAsCookiePath

boolean

false

指明 Cookie 路徑等於 Web 模組的環境定義根目錄，而不是 /

URL 重新編寫

alwaysEncodeUrl

boolean

false

Servlet 2.5 規格指定不將 response.encodeURL 呼叫上的 URL 編碼（如果非必要的話）。如果要在已啟用 URL 編碼時支援舊版相容性，請將這個內容設定為 true 以呼叫 encodeURL 方法。即使瀏覽器支援 Cookie，也一律會將 URL 編碼。

protocolSwitchRewritingEnabled

boolean

false

當 URL 需要從 HTTP 切換至 HTTPS 或從 HTTPS 切換至 HTTP 時，將階段作業 ID 新增至 URL 中。

rewriteId

string

jsessionid

請使用這個內容來變更與 URL 重新編寫一起使用的索引鍵。

失效

forceInvalidationMultiple

int

如果您的要求通常不受限於回應時間限制，請指定 0 來指出階段作業管理程式在試圖使階段作業失效之前，應無限期等待直到要求完成。否則，請將這個內容設定為正整數，以延遲讓作用中階段作業失效。作用中的逾時階段作業將不會因第一個失效間隔傳遞而失效，但是將會根據此值的間隔傳遞而失效。例如，值 2 會在階段作業逾時值過期之後，使第二個失效間隔傳遞上的作用中階段作業失效。

invalidationTimeout

精準度是秒鐘的時間量

30m

階段作業在失效之前可保持未使用的時間量，如果沒有指定時間單位，則以秒為單位。. 指定正整數加上時間單位，時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如，指定 30 秒為 30s。您可以在單一項目中包括多個值。例如，1m30s 相等於 90 秒。

reaperPollInterval

精準度是秒鐘的時間量

-1

移除無效階段作業之程序的起動間隔（以秒為單位）。下限值為 30 秒。如果輸入小於下限的值，會自動判定並使用適當的值。這個值會根據階段作業逾時值來置換預設安裝值，其介於 30 到 360 秒之間。由於預設階段作業逾時值是 30 分鐘，因此收割者間隔通常是介於 2 到 3 分鐘之間。. 指定正整數加上時間單位，時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如，指定 30 秒為 30s。您可以在單一項目中包括多個值。例如，1m30s 相等於 90 秒。

失效接手

cloneId

string

叢集成員的複本 ID。在叢集內，這個 ID 必須是唯一的，才能保持階段作業親緣性。當設定時，這個名稱會改寫伺服器所產生的預設名稱。

cloneSeparator

string

用來將階段作業 ID 與階段作業 Cookie 中的複本 ID 分隔的單一字元。通常應使用預設值。在某些「無線應用程式通訊協定 (WAP)」裝置上，並不容許冒號 (:)，因此應改為使用加號 (+)。請少用不同的值。在使用這個內容來變更複本分隔字元之前，您應先瞭解在您系統上執行的其他產品之複本字元需求。您可以將任何字元指定為這個內容的值，這並不默示您指定的字元都能夠正確運作。這項事實也不默示 IBM 要負責修正使用替代字元所可能引起的任何問題。

安全

invalidateOnUnauthorizedSessionRequestException

boolean

false

對於回應未獲授權的要求，如果您希望階段作業管理程式讓階段作業失效，請將此內容設為 true，而不是發出 UnauthorizedSessionRequestException。當階段作業失效時，要求端可以建立新的階段作業，但是不能存取任何先前儲存的階段作業資料。這可讓單一使用者在登出之後，可繼續處理對其他應用程式的要求，而且又能保護階段作業資料。

securityIntegrationEnabled

boolean

true

啟用安全整合，其會導致階段作業管理機能建立使用者身分與其 HTTP 階段作業的關聯性。

securityUserIgnoreCase

boolean

false

指出即使階段作業安全身分和用戶端安全身分的大小寫不同，它們也應視為相符。例如，當這個內容設定為 true 時，階段作業安全身分 USER1 符合用戶端安全身分 User1 和 user1。

進階

accessOnTimeout

boolean

true

此內容提供對階段作業的 Servlet 存取權，即使另一個 Servlet 仍鎖定該階段作業，也容許正常執行。將此內容設為 false，以在階段作業要求逾時時，停止 Servlet 執行。預設值為 true。

allowSerializedAccess

boolean

false

啟用此選項以容許對階段作業資料進行序列化存取。

debugCrossover

boolean

false

啟用這個選項可執行附加的檢查，以確認只有存取或參照與要求相關聯的階段作業，以及日誌訊息（如果偵測到任何不相符）。停用這個選項可跳過附加檢查。

idLength

int

階段作業 ID 的長度。

idReuse

boolean

false

在未配置階段作業持續存在的多重 JVM 環境中，將這個內容設定為 "true" 會讓階段作業管理程式能夠對所有使用者的要求使用相同的階段作業資訊，即使處理這些要求的 Web 應用程式是由不同的 JVM 所控管亦然。這個內容的預設值為 false。如果您要讓階段作業管理程式能夠使用瀏覽器傳送的階段作業 ID，以在未配置階段作業持續性的環境所執行的 Web 應用程式之間保留階段作業資料，請將這個內容設定為 true。

maxWaitTime

int

Servlet 繼續執行之前，在階段作業上等待的時間量（以秒為單位）。

modifyActiveCountOnInvalidatedSession

boolean

true

當多個應用程式存取階段作業時，Httpsession activeCount 度量可能變得不準確。請將該內容設為 "false"，以解決此問題。

noAdditionalInfo

boolean

false

強制移除在階段作業 ID 中不需要的資訊。

階段作業追蹤機制

cookiesEnabled

boolean

true

指定階段作業追蹤利用 Cookie 來傳送階段作業 ID。

sslTrackingEnabled

boolean

false

指定階段作業追蹤利用 Secure Sockets Layer (SSL) 資訊來作為階段作業 ID。

urlRewritingEnabled

boolean

false

指定階段作業管理機能利用重新編寫的 URL 來傳送階段作業 ID。