NetTcpSecurity Klasse

Definition

public ref class NetTcpSecurity sealed

public sealed class NetTcpSecurity

type NetTcpSecurity = class

Public NotInheritable Class NetTcpSecurity

Vererbung

Object

NetTcpSecurity

Beispiele

Der folgende Code zeigt, wie Sie das NetTcpSecurity Objekt aus einem NetTcpBinding Objekt abrufen und die verschiedenen darin enthaltenen Einstellungen drucken:

using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))
{
    serviceHost.Open();
    ServiceEndpointCollection endpoints = serviceHost.Description.Endpoints;
    ServiceEndpoint endpoint = endpoints.Find(typeof(ICalculator));

    NetTcpBinding binding = (NetTcpBinding) endpoint.Binding;

    NetTcpSecurity security = binding.Security;
    MessageSecurityOverTcp msTcp = security.Message;

    Console.WriteLine("Dumping NetTcpSecurity object:");
    Console.WriteLine("\tMessageSecurityOverTcp:");
    Console.WriteLine("\t\tAlgorithm Suite: {0}", msTcp.AlgorithmSuite);
    Console.WriteLine("\t\tClient Credential Type: {0}", msTcp.ClientCredentialType);

    Console.WriteLine("\tSecurity Mode: {0}", security.Mode);

    TcpTransportSecurity tsTcp = security.Transport;
    Console.WriteLine("\tTcpTransportSecurity:");
    Console.WriteLine("\t\tClient Credential Type: {0}", tsTcp.ClientCredentialType);
    Console.WriteLine("\t\tProtectionLevel: {0}", tsTcp.ProtectionLevel);

    // The service can now be accessed.
    Console.WriteLine("The service is ready.");
    Console.WriteLine("Press <ENTER> to terminate service.");
    Console.WriteLine();
    Console.ReadLine();
}

Hinweise

Jede der Standardbindungen stellt Parameter für die Steuerung der Übertragungssicherheitsanforderungen bereit. Diese Parameter enthalten in der Regel den Sicherheitsmodus, der angibt, ob die Sicherheit auf Nachrichtenebene oder Transportebene verwendet wird, und die Auswahl des Clientanmeldeinformationstyps. Basierend auf der Auswahl der Optionen, die diese Parameter darstellen, wird ein Kanalstapel mit entsprechender Sicherheit konstruiert.

Die vom System bereitgestellten Bindungen von Windows Communication Foundation (WCF) sind ein Satz, der auf einige der am häufigsten verwendeten Szenarioanforderungen ausgelegt ist. Jede dieser Bindungen ermöglicht die Spezifikation der Sicherheitsanforderungen für bestimmte gezielte Szenarien.

NetTcpSecurity stellt die Sicherheitsspezifikationen für NetTcpBinding. Dies ist eine sichere, zuverlässige, optimierte Bindung, die für die maschinenübergreifende Kommunikation geeignet ist. Standardmäßig wird ein Laufzeitkommunikationsstapel generiert, der TCP für die Nachrichtenübermittlung und Windows-Sicherheit für Nachrichtensicherheit und -Authentifizierung, WS-ReliableMessaging für Zuverlässigkeit und binäre Nachrichtencodierung unterstützt.

Diese Klasse wird von der NetTcpBindingInstanziierung und kann von einer schreibgeschützten Eigenschaft aufgerufen Securitywerden. Da diese Eigenschaft schreibgeschützt ist, können Sie keine Änderungen am zurückgegebenen Objekt vornehmen. Wenn Sie die Erstellung des NetTcpSecurity Objekts steuern möchten, können Sie eine Klasse von NetTcpBinding.