NetTcpSecurity Classe

Definizione

Spazio dei nomi:

System.ServiceModel

Assembly:

System.ServiceModel.NetTcp.dll

Assembly:

System.ServiceModel.dll

Consente di specificare i tipi di sicurezza a livello di trasporto e di messaggio utilizzati da un endpoint configurato con un'associazione NetTcpBinding.

public ref class NetTcpSecurity sealed

public sealed class NetTcpSecurity

type NetTcpSecurity = class

Public NotInheritable Class NetTcpSecurity

Ereditarietà

Object

NetTcpSecurity

Esempio

Il codice seguente illustra come recuperare l'oggetto NetTcpSecurity da un NetTcpBinding oggetto e stampa le varie impostazioni contenute:

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();
}

Commenti

Ognuna delle associazioni standard fornisce parametri per controllare i requisiti di sicurezza di trasferimento. Alcuni esempi tipici di elementi controllati da questi parametri sono la modalità di sicurezza che determina se la sicurezza è a livello di messaggio o a livello di trasporto e la scelta del tipo di credenziale client. L'infrastruttura crea uno stack di canali con il tipo di sicurezza appropriato a partire dal gruppo di opzioni impostate tramite questi parametri.

Le associazioni fornite da Windows Communication Foundation (WCF) formano un insieme progettato per soddisfare alcuni dei requisiti di scenario più comuni. Ognuna di queste associazioni consente la definizione mirata dei requisiti di sicurezza relativi ad alcuni scenari specifici.

NetTcpSecurity fornisce le specifiche di sicurezza per NetTcpBinding. Si tratta di un'associazione protetta, affidabile, ottimizzata e adatta per le comunicazioni fra computer. Tale associazione crea per impostazione predefinita uno stack di comunicazione di runtime che, oltre a implementare la codifica binaria dei messaggi, utilizza il protocollo TCP per il recapito dei messaggi, Windows Security per proteggere e autenticare i messaggi e WS-ReliableMessaging per garantire l'affidabilità delle comunicazioni.

Questa classe viene creata un'istanza NetTcpBindingdi e può essere accessibile da una proprietà di sola lettura denominata Security. Poiché questa proprietà è di sola lettura, non è possibile apportare modifiche all'oggetto restituito. Se si vuole controllare la creazione dell'oggetto NetTcpSecurity , è possibile derivare una classe da NetTcpBinding.

Costruttori

NetTcpSecurity()

Inizializza una nuova istanza della classe NetTcpSecurity.

Proprietà

Message	Consente di ottenere il tipo di requisiti di sicurezza a livello di messaggio di un servizio configurato con un'associazione NetTcpBinding.
Mode	Ottiene o imposta un valore che indica se un endpoint configurato con un'associazione NetTcpBinding utilizza meccanismi di sicurezza a livello di messaggio o di trasporto.
Transport	Ottiene il tipo di requisiti di sicurezza a livello di messaggio di un endpoint configurato con un binding NetTcpBinding.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)