NetTcpSecurity Classe

Definição

public ref class NetTcpSecurity sealed

public sealed class NetTcpSecurity

type NetTcpSecurity = class

Public NotInheritable Class NetTcpSecurity

Herança

Object

NetTcpSecurity

Exemplos

O código seguinte mostra como recuperar o NetTcpSecurity objeto de um NetTcpBinding e imprime as várias definições que contém:

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

Observações

Cada uma das ligações padrão fornece parâmetros para controlar os requisitos de segurança da transferência. Estes parâmetros incluem tipicamente o modo de segurança que especifica se a segurança ao nível da mensagem ou ao nível de transporte é usada e a escolha do tipo de credencial do cliente. Com base na escolha das opções apresentadas por estes parâmetros, é construída uma pilha de canais com a segurança adequada.

Os bindings fornecidos pelo sistema fornecidos pela Windows Communication Foundation (WCF) são um conjunto concebido para satisfazer alguns dos requisitos de cenários mais comuns. Cada uma destas ligações permite a especificação de requisitos de segurança para alguns cenários específicos.

NetTcpSecurity fornece as especificações de segurança para NetTcpBinding. Esta é uma ligação segura, fiável e otimizada, adequada para comunicação entre máquinas. Por defeito, gera uma pilha de comunicação em tempo de execução que suporta TCP para entrega de mensagens e Segurança do Windows para segurança e autenticação de mensagens, WS-ReliableMessaging para fiabilidade e codificação binária de mensagens.

Esta classe é instanciada pelo NetTcpBinding, e pode ser acedida por uma propriedade de apenas leitura chamada Security. Como esta propriedade é apenas de leitura, não pode fazer alterações ao objeto devolvido. Se quiser controlar a criação do NetTcpSecurity objeto, pode derivar uma classe a partir de NetTcpBinding.