SecurityBindingElement Classe

Definição

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacote:

System.ServiceModel.Primitives v8.0.0

Origem:

SecurityBindingElement.cs

Uma classe abstrata que, quando implementada, representa um elemento de associação que dá suporte à segurança de mensagens SOAP de canal.

public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElement

public abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElement

type SecurityBindingElement = class
    inherit BindingElement

Public MustInherit Class SecurityBindingElement
Inherits BindingElement

Herança

Object

BindingElement

SecurityBindingElement

Derivado

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

Comentários

Essa classe é a classe base para os elementos de associação de segurança de mensagem SOAP no WCF. Há três implementações dessa classe abstrata: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElemente TransportSecurityBindingElement. Essas implementações modelam as associações definidas na especificação de política de WS-Security.

Uma associação personalizada contém uma coleção de elementos de associação organizados em uma ordem específica: o elemento que representa a parte superior da pilha de associação é adicionado primeiro, o próximo elemento na pilha de associação é adicionado em segundo e assim por diante.

Para adicionar essa classe a uma associação, faça o seguinte:

1. Criará um BindingElementCollection.

2. Crie um elemento de associação personalizado acima desse elemento de associação na pilha de associação, como o opcional TransactionFlowBindingElement e ReliableSessionBindingElemento .

3. Adicione esses elementos na ordem descrita anteriormente ao BindingElementCollection usando o InsertItem método .

4. Crie uma instância de um elemento de associação de segurança derivado de SecurityBindingElement, como AsymmetricSecurityBindingElement, SymmetricSecurityBindingElementou TransportSecurityBindingElement.

5. Adicione o elemento de associação de segurança derivado à coleção.

6. Adicione elementos de associação personalizados adicionais à coleção, como TcpTransportBindingElement.

Para obter mais informações sobre como usar um SecurityBindingElement, consulte Modos de autenticação SecurityBindingElement e Como criar uma associação personalizada usando o SecurityBindingElement.

Observação

Depois que um SecurityBindingElement objeto é criado, você deve tratar suas propriedades como imutáveis. Chamar set algumas propriedades pode ter efeitos imprevisíveis: a associação pode se comportar como se a propriedade tivesse mantido seu valor antigo, com uma falha de runtime sendo a única indicação de um problema. Duas propriedades conhecidas por se comportarem dessa maneira são KeyType e MessageSecurityVersion. Pode haver outras propriedades das quais isso também é verdadeiro.

Propriedades

DefaultAlgorithmSuite	Obtém ou define a criptografia de mensagem e os algoritmos de encapsulamento de chave.
EnableUnsecuredResponse	Obtém ou define um valor que indica se o WCF pode enviar e receber respostas desprotegidas a solicitações protegidas.
EndpointSupportingTokenParameters	Obtém o ponto de extremidade compatível com os parâmetros de token.
IncludeTimestamp	Obtém ou define um valor que indica se carimbos de data/hora são incluídos em cada mensagem.
KeyEntropyMode	Obtém ou define a origem da entropia usada para criar chaves.
LocalClientSettings	Obtém as propriedades de associação específicas para as configurações de segurança locais usadas pelo cliente.
MessageSecurityVersion	Obtém ou define a versão de segurança da mensagem.
SecurityHeaderLayout	Obtém ou define a ordenação dos elementos no cabeçalho de segurança dessa associação.

Métodos

BuildChannelFactory<TChannel>(BindingContext)	Cria uma fábrica de canais com base nas configurações SecurityBindingElement e no contexto de associação transmitido. A fábrica de canais criada é uma fabrica de canais de segurança da mensagem SOAP, que tem internamente uma referência à fábrica de canais que corresponde ao contexto de associação, (que inclui a fábrica de canais de transporte).
BuildChannelFactoryCore<TChannel>(BindingContext)	Quando implementado, cria uma fábrica de canais de um tipo especificado.
BuildChannelListener<TChannel>(BindingContext)	Inicializa um ouvinte de canais para aceitar canais de um tipo especificado do contexto de associação. (Herdado de BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Determina se uma fábrica de canais do tipo especificado pode ser criada.
CanBuildChannelListener<TChannel>(BindingContext)	Retorna um valor que indica se o elemento de associação pode criar um ouvinte para um tipo de canal específico. (Herdado de BindingElement)
Clone()	Quando substituído em uma classe derivada, retorna uma cópia do objeto do elemento de associação. (Herdado de BindingElement)
CreateCertificateOverTransportBindingElement()	Cria um elemento de associação de segurança que espera que os clientes façam a autenticação baseada em certificado usando a segurança de mensagem SOAP.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Cria um elemento de associação de segurança que espera que os clientes façam a autenticação baseada em certificado usando a segurança de mensagem SOAP.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Cria um elemento de associação de segurança configurado para exigir autenticação do cliente com base na segurança SOAP usando um token emitido. O elemento de associação requer que o transporte forneça autenticação do servidor e proteção da mensagem (por exemplo, HTTPS).
CreateSecureConversationBindingElement(SecurityBindingElement)	Cria um elemento de associação de segurança simétrica configurado para estabelecer uma conversa segura entre o cliente e o serviço. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens. O elemento de associação de segurança de bootstrap especifica como as mensagens de handshake de conversa segura são protegidas.
CreateUserNameOverTransportBindingElement()	Cria um elemento de associação de segurança que é configurado para a autenticação do cliente com base em um nome de usuário e senha enviados como parte da mensagem SOAP. O elemento de associação requer o transporte para fornecer a autenticação do servidor e a proteção de mensagem (por exemplo, HTTPS).
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetProperty<T>(BindingContext)	Obtém um objeto especificado usando o BindingContext especificado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma descrição desta classe.

Confira também

• SecurityBindingElement Authentication Modes
• Como criar uma associação personalizada usando SecurityBindingElement