<localServiceSettings> 項目
指定此繫結之本機服務的安全性設定。
結構描述階層
<system.serviceModel>
<bindings>
<customBinding>
<binding>
<customBinding> 的 <security>
語法
<security>
<localServiceSettings detectReplays="Boolean"
inactivityTimeout="TimeSpan"
issuedCookieLifeTime="TimeSpan"
maxCachedCookies="Integer"
maxClockSkew="TimeSpan"
maxPendingSessions="Integer"
maxStatefulNegotiations="Integer"
negotiationTimeout="TimeSpan"
reconnectTransportOnFailure="Boolean"
replayCacheSize="Integer"
replayWindow="TimeSpan"
sessionKeyRenewalInterval="TimeSpan"
sessionKeyRolloverInterval="TimeSpan"
timestampValidityDuration="TimeSpan" />
</security>
屬性和元素
下列各節說明屬性、子項目和父項目。
屬性
屬性 | 描述 |
---|---|
detectReplays |
布林值,這個值會指定是否會偵測及自動處理對通道所發出的重新執行攻擊。預設為 false。 |
inactivityTimeout |
正的 TimeSpan,指定通道在無活動的狀態下要等候多長的時間才會逾時。預設為 "01:00:00"。 |
issuedCookieLifeTime |
TimeSpan,指定發出給所有新的安全性 Cookie 的存留期。超過存留期的 Cookie 會回收,而且必須再次交涉。預設值為 "10:00:00"。 |
maxCachedCookies |
正整數,這個值會指定可以快取的 Cookie 數目上限。預設為 1000。 |
maxClockSkew |
TimeSpan,指定通訊雙方之系統時鐘之間的最大時間差異。預設值為 "00:05:00"。 當這個值設定為預設值時,接收者接受之訊息的傳送時間時間戳記會比收到訊息的時間早或晚 5 分鐘。沒有通過傳送時間測試的訊息會遭到拒絕。這個設定會配合 replayWindow 屬性使用。 |
maxPendingSessions |
正整數,這個值會指定服務支援之擱置中安全性工作階段數目上限。當達到這個限制時,所有新的用戶端都會收到 SOAP 錯誤。預設值為 1000。 |
maxStatefulNegotiations |
正整數,這個值會指定可以同時為作用中的安全性交涉數目。超過限制的交涉工作階段會排入佇列,而且只有在低於限制的空間可供使用時才能完成。預設值為 1024。 |
negotiationTimeout |
TimeSpan,指定通道所使用之安全性原則的存留期。超過此時間時,通道會與用戶端重新交涉新安全性原則。預設值為 "00:02:00"。 |
reconnectTransportOnFailure |
布林值,指定使用 WS-Reliable 訊息的連線是否會在傳輸失敗之後嘗試重新連線。預設為 true,表示無限次嘗試重新連線。無活動逾時會打破這個循環,而這樣會使得通道在無法重新連線時擲回例外狀況。 |
replayCacheSize |
正整數,指定用於偵測重新執行攻擊之已快取 Nonce 數目。如果超過這個限制,便會移除最舊的 Nonce,然後為新訊息建立新的 Nonce。預設值為 500000。 |
replayWindow |
TimeSpan,指定個別訊息 Nonce 有效的持續期間。 過了這段時間後,將不會接受與先前所傳送之訊息擁有相同 Nonce 的訊息。這個屬性是配合 maxClockSkew 屬性使用,以防止重新執行攻擊。攻擊者可以在重新執行視窗逾期之後重新執行訊息。然而,這個訊息無法通過 maxClockSkew 測試,因為它會拒絕傳送時間之時間戳記比收到訊息的時間早或晚的訊息。 |
sessionKeyRenewalInterval |
指定持續期間的 TimeSpan,啟動器將在這段期間過後更新安全性工作階段的金鑰。預設為 "10:00:00"。 |
sessionKeyRolloverInterval |
TimeSpan,指定前一個工作階段金鑰在金鑰更新期間對傳入訊息屬有效的時間間隔。預設為 "00:05:00"。 在金鑰更新之後,用戶端和伺服器都必須使用最新的可用金鑰來傳送訊息。雙方都會接受由前一個工作階段金鑰保護的傳入訊息,直到變換時間逾期。 |
timestampValidityDuration |
正的 TimeSpan,指定時間戳記有效的持續期間。預設為 "00:15:00"。 |
項目子系
無。
父項目
項目 | 描述 |
---|---|
指定自訂繫結的安全性選項。 |
|
指定用於初始化安全對話服務的預設值。 |
備註
這些是本機設定,因為它們並未發行成為服務之安全性原則的一部分,因此不會影響用戶端的繫結。
localServiceSecuritySettings 項目的下列屬性有助於降低阻絕服務 (DOS) 安全性攻擊:
maxCachedCookies:控制在執行 SPNEGO 或 SSL 交涉之後,伺服器所快取有時間界限之 SecurityContextToken 的上限。
issuedCookieLifetime:控制在 SPNEGO 或 SSL 交涉之後,伺服器所發出的 SecurityContextToken 的存留期 (Lifetime)。伺服器會在這段時間內快取 SecurityContextToken。
maxPendingSessions:控制在伺服器中建立的安全對話上限,但是不會針對這些對話處理應用程式訊息。這個配額會防止用戶端在服務中建立安全對話,由此服務會針對每個用戶端保留對話狀態,但不會使用這些對話。
inactivityTimeout:控制服務讓安全對話保持運作,而不會從中接收應用程式訊息的時間上限。這個配額會防止用戶端在服務中建立安全對話,由此服務會針對每個用戶端保留對話狀態,但不會使用這些對話。
在安全對話工作階段中,請注意繫結上的 inactivityTimeout 和 receiveTimeout 屬性都會影響工作階段逾時。其中時間較短的屬性值會決定逾時發生的時間。
另請參閱
參考
<customBinding>
LocalServiceSecuritySettingsElement
LocalServiceSettings
LocalServiceSettings
LocalServiceSecuritySettings
CustomBinding
其他資源
Windows Communication Foundation Bindings
Extending Bindings
Custom Bindings
How To: Create a Custom Binding Using the SecurityBindingElement
Custom Binding Security