Export (0) Print
Expand All

LocalServiceSecuritySettings Class

Provides local service security properties that can be set.

System.Object
  System.ServiceModel.Channels.LocalServiceSecuritySettings

Namespace:  System.ServiceModel.Channels
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public sealed class LocalServiceSecuritySettings

The LocalServiceSecuritySettings type exposes the following members.

  NameDescription
Public methodLocalServiceSecuritySettingsInitializes a new instance of the LocalServiceSecuritySettings class.
Top

  NameDescription
Public propertyDetectReplaysGets or sets a value that indicates whether replay detection is enabled on the service.
Public propertyInactivityTimeoutGets or sets the duration to wait before the channel is closed due to inactivity.
Public propertyIssuedCookieLifetimeGets or sets the lifetime for the SecurityContextSecurityToken that the service issues for the client.
Public propertyMaxCachedCookiesGets or sets the maximum number of SecurityContextSecurityTokens that the service allows to cache at once.
Public propertyMaxClockSkewGets or sets the maximum allowable time difference between the system clocks of the two parties that are communicating.
Public propertyMaxPendingSessionsGets or sets the maximum number of concurrent security sessions that are established with the server for which it has issued a session token but for which no application messages are sent.
Public propertyMaxStatefulNegotiationsGets or sets the maximum number of concurrent security negotiations with clients that the service can participate in.
Public propertyNegotiationTimeoutGets or sets the maximum duration of the security negotiation phase between client and service.
Public propertyReconnectTransportOnFailureGets or sets a value that indicates whether security sessions attempt to reconnect after transport failures.
Public propertyReplayCacheSizeGets or sets the size of the nonce cache used for replay detection.
Public propertyReplayWindowGets or sets the maximum amount of time within which the service can accept a message.
Public propertySessionKeyRenewalIntervalGets or sets the lifetime of a key used in a security session. When this interval expires the key is automatically renewed.
Public propertySessionKeyRolloverIntervalGets or sets the time interval after key renewal for which the previous session key is valid on incoming messages during a key renewal.
Public propertyTimestampValidityDurationGets or sets the maximum duration of time that messages are valid when sent by the service. If the client receives the service's message after this duration, it discards the message.
Top

  NameDescription
Public methodCloneCreates a new instance of this class from the current instance.
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

This class contains the local security settings used by the SecurityBindingElement to build the security channel. These settings are local to the service and are not represented in the service's security policy.

This example shows how to use the LocalServiceSecuritySettings class to change the DetectReplays setting.


    // Create an instance of the binding to use.
    WSHttpBinding b = new WSHttpBinding();

    // Get the binding element collection.
    BindingElementCollection bec = b.CreateBindingElements();

    // Find the SymmetricSecurityBindingElement in the colllection.
    // Important: Cast to the SymmetricSecurityBindingElement when using the Find
    // method.
    SymmetricSecurityBindingElement sbe = (SymmetricSecurityBindingElement)
bec.Find<SecurityBindingElement>();

    // Get the LocalServiceSettings from the binding element.
    LocalServiceSecuritySettings lss = sbe.LocalServiceSettings;

    // Print out values.
    Console.WriteLine("DetectReplays: {0} days", lss.DetectReplays);
    Console.WriteLine("ReplayWindow: {0} minutes", lss.ReplayWindow.Minutes);
    Console.WriteLine("MaxClockSkew: {0} minutes", lss.MaxClockSkew.Minutes);

    Console.ReadLine();
    Console.WriteLine("Press Enter to Continue");
    // Change the MaxClockSkew to 3 minutes.
    lss.MaxClockSkew = new TimeSpan(0, 0, 3, 0);

    // Print the new value.
    Console.WriteLine("New MaxClockSkew: {0} minutes", lss.MaxClockSkew.Minutes);
    Console.WriteLine("Press Enter to End");
    Console.ReadLine();

    // Create a URI for the service.
    Uri httpUri = new Uri("http://localhost/calculator");

    // Create a ServiceHost. The binding has the changed MaxClockSkew.
    ServiceHost sh = new ServiceHost(typeof(Calculator), httpUri);
    sh.AddServiceEndpoint(typeof(ICalculator), b, "");
    // sh.Open();
    // Console.WriteLine("Listening");
    // Console.ReadLine();
    // sh.Close();


.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

ADD
Show:
© 2014 Microsoft