LocalServiceSecuritySettings.SessionKeyRolloverInterval Property

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.dll

Gets or sets the time interval after key renewal for which the previous session key is valid on incoming messages during a key renewal.

public:
 property TimeSpan SessionKeyRolloverInterval { TimeSpan get(); void set(TimeSpan value); };

public TimeSpan SessionKeyRolloverInterval { get; set; }

member this.SessionKeyRolloverInterval : TimeSpan with get, set

Public Property SessionKeyRolloverInterval As TimeSpan

Property Value

TimeSpan

The time interval after key renewal for which the previous session key is valid on incoming messages after a key renewal. The default is 5 minutes.

Exceptions

ArgumentOutOfRangeException

The property is set to a value less than 0.

Examples

This example shows how get the SessionKeyRolloverInterval value.

TimeSpan rolloverInterval =
    settings.SessionKeyRolloverInterval;

Dim rolloverInterval As TimeSpan = settings.SessionKeyRolloverInterval

Remarks

After key renewal, the client and server should always send messages using the most current available key. Both parties can accept incoming messages secured with the previous session key until the rollover time expires.

Session settings such as this one are applicable under any of the following conditions:

• All client credential types for WSDualHttpBinding and NetTcpBinding.

• If <reliableSession> element is enabled.

• If <reliableSession> element is not enabled, on WSHttpBinding with UserName = true or ClientCredentials.Windows = true.

Session settings such as this one are not applicable under any of the following conditions:

• For BasicHttpBinding.

• For NetNamedPipeBinding.

• If <reliableSession> element is not enabled, on WSHttpBinding with ClientCertificate = true or with none of the ClientCredentials properties set to true.