LocalClientSecuritySettings Klasse

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v6.2.0

Quelle:

LocalClientSecuritySettings.cs

Gibt lokale Clientsicherheitseinstellungen an.

public ref class LocalClientSecuritySettings sealed

public sealed class LocalClientSecuritySettings

type LocalClientSecuritySettings = class

Public NotInheritable Class LocalClientSecuritySettings

Vererbung

Object

LocalClientSecuritySettings

Beispiele

In diesem Beispiel wird die Verwendung der LocalClientSecuritySettings-Klasse veranschaulicht.

// 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 collection.
// Important: Cast to the SymmetricSecurityBindingElement when using the Find
// method.
SymmetricSecurityBindingElement sbe = (SymmetricSecurityBindingElement)
    bec.Find<SecurityBindingElement>();

// Get the LocalSecuritySettings from the binding element.
LocalClientSecuritySettings lc = sbe.LocalClientSettings;

// Print out values.
Console.WriteLine("Maximum cookie caching time: {0} days", lc.MaxCookieCachingTime.Days);
Console.WriteLine("Replay Cache Size: {0}", lc.ReplayCacheSize);
Console.WriteLine("ReplayWindow: {0} minutes", lc.ReplayWindow.Minutes);
Console.WriteLine("MaxClockSkew: {0} minutes", lc.MaxClockSkew.Minutes);
Console.ReadLine();

// Change the MaxClockSkew to 3 minutes.
lc.MaxClockSkew = new TimeSpan(0, 0, 3, 0);

// Print the new value.
Console.WriteLine("New MaxClockSkew: {0} minutes", lc.MaxClockSkew.Minutes);
Console.ReadLine();

// Create an EndpointAddress for the service.
EndpointAddress ea = new EndpointAddress("http://localhost/calculator");

// Create a client. The binding has the changed MaxClockSkew.
// CalculatorClient cc = new CalculatorClient(b, ea);
// Use the new client. (Not shown.)
// cc.Close();

' Create an instance of the binding to use.
Dim b As New WSHttpBinding()

' Get the binding element collection.
Dim bec As BindingElementCollection = b.CreateBindingElements()

' Find the SymmetricSecurityBindingElement in the collection.
' Important: Cast to the SymmetricSecurityBindingElement when using the Find
' method.
Dim sbe As SymmetricSecurityBindingElement = CType(bec.Find(Of SecurityBindingElement)(), SymmetricSecurityBindingElement)

' Get the LocalSecuritySettings from the binding element.
Dim lc As LocalClientSecuritySettings = sbe.LocalClientSettings

' Print out values.
Console.WriteLine("Maximum cookie caching time: {0} days", lc.MaxCookieCachingTime.Days)
Console.WriteLine("Replay Cache Size: {0}", lc.ReplayCacheSize)
Console.WriteLine("ReplayWindow: {0} minutes", lc.ReplayWindow.Minutes)
Console.WriteLine("MaxClockSkew: {0} minutes", lc.MaxClockSkew.Minutes)
Console.ReadLine()

' Change the MaxClockSkew to 3 minutes.
lc.MaxClockSkew = New TimeSpan(0, 0, 3, 0)

' Print the new value.
Console.WriteLine("New MaxClockSkew: {0} minutes", lc.MaxClockSkew.Minutes)
Console.ReadLine()

' Create an EndpointAddress for the service.
Dim ea As New EndpointAddress("http://localhost/calculator")

' Create a client. The binding has the changed MaxClockSkew.
' CalculatorClient cc = new CalculatorClient(b, ea);
' Use the new client. (Not shown.)
' cc.Close();

Hinweise

Diese Klasse enthält die vom SecurityBindingElement verwendeten Sicherheitseinstellungen (und davon abgeleitete Klassen) zur Erstellung des Sicherheitskanals. Diese Einstellungen befinden sich lokal auf dem Client und werden nicht von der Sicherheitsrichtlinie des Diensts bestimmt.

Konstruktoren

LocalClientSecuritySettings()

Initialisiert eine neue Instanz der LocalClientSecuritySettings-Klasse.

Eigenschaften

CacheCookies	Ruft einen Wert ab, der anzeigt, ob sichere Konversationscookies zwischengespeichert werden, oder richtet diesen Wert ein.
CookieRenewalThresholdPercentage	Ruft den Schwellenwert-Prozentwert für die Erneuerung sicherer Konversationscookies ab oder legt ihn fest.
DetectReplays	Ruft einen Wert ab, der angibt, ob die Wiedergabeerkennung von Nachrichten, die der Client vom Dienst erhält, aktiviert ist, oder richtet diesen Wert ein.
IdentityVerifier	Ruft die Identitätsprüfung ab oder legt sie fest.
MaxClockSkew	Ruft den maximal zulässigen Zeitunterschied zwischen den Systemuhren der beiden Kommunikationspartner ab, oder legt diesen fest.
MaxCookieCachingTime	Ruft die maximale Zwischenspeicherzeit für sichere Konversationscookies ab oder legt diese fest.
NonceCache	Ruft den Cache für die Sicherheitseinstellungen des lokalen Clients ab oder legt diesen fest.
ReconnectTransportOnFailure	Ruft einen Wert ab, der angibt, ob Sicherheitssitzungen versuchen, nach Transportfehlern erneut eine Verbindung herzustellen, oder legt diesen Wert fest.
ReplayCacheSize	Ruft die Anzahl an zwischengespeicherten Nonces für die Wiedergabeerkennung ab oder legt diese fest.
ReplayWindow	Ruft die maximale Zeit ab, die eine Nachrichtennonce gültig ist, oder legt diese fest.
SessionKeyRenewalInterval	Ruft die Dauer ab, nach der der Initiator den Schlüssel für die Sicherheitssitzung erneuert, oder legt diese fest.
SessionKeyRolloverInterval	Ruft das Zeitintervall ab, in dem der frühere Sitzungsschlüssel während einer Schlüsselerneuerung noch für eingehende Nachrichten gilt, oder legt dieses fest.
TimestampValidityDuration	Ruft die maximale Gültigkeitsdauer der Nachrichten ab, wenn sie vom Client gesendet wurden, oder legt diese fest. Wenn eine Nachricht vom Dienst nach dieser Dauer empfangen wird, sollte die Nachricht verworfen werden.

Methoden

Clone()	Erstellt eine neue Instanz dieser Klasse, die eine Kopie oder ein Klon der aktuellen Instanz ist.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Vorgehensweise: Festlegen einer maximalen Uhrschiefe