LocalClientSecuritySettings Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt lokale Clientsicherheitseinstellungen an.
public ref class LocalClientSecuritySettings sealedpublic sealed class LocalClientSecuritySettingstype LocalClientSecuritySettings = classPublic NotInheritable Class LocalClientSecuritySettings- Vererbung
-
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) |
