Partilhar via


SecurityBindingElement Classe

Definição

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
SecurityBindingElement
Derivado

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

AllowInsecureTransport

Obtém ou define um valor que indica se as mensagens seguras de modo misto podem ser enviadas por um transporte não seguro, como HTTP.

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.

LocalServiceSettings

Obtém as propriedades de associação específicas para as configurações de segurança locais usadas pelo serviço.

MessageSecurityVersion

Obtém ou define a versão de segurança da mensagem.

OperationSupportingTokenParameters

Obtém a coleção de parâmetros de token de suporte da operação.

OptionalEndpointSupportingTokenParameters

Obtém os parâmetros de token de suporte opcionais para o ponto de extremidade de serviço.

OptionalOperationSupportingTokenParameters

Obtém a coleção de parâmetros de token de suporte da operação opcionais.

ProtectTokens

Obtém ou define se o elemento de associação de segurança protege tokens.

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)

Cria um ouvinte de canais com base nas configurações SecurityBindingElement e no contexto de associação transmitido.

BuildChannelListener<TChannel>(BindingContext)

Inicializa um ouvinte de canais para aceitar canais de um tipo especificado do contexto de associação.

(Herdado de BindingElement)
BuildChannelListenerCore<TChannel>(BindingContext)

Quando implementado, cria um ouvinte de canais de um tipo especificado.

CanBuildChannelFactory<TChannel>(BindingContext)

Determina se uma fábrica de canais do tipo especificado pode ser criada.

CanBuildChannelListener<TChannel>(BindingContext)

Determina se um ouvinte de canais do tipo especificado pode ser criado.

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)
CreateAnonymousForCertificateBindingElement()

Cria um elemento de associação de segurança simétrica configurado para autenticação do cliente anônima e autenticação de servidor baseada em certificado.

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.

CreateCertificateSignatureBindingElement()

Cria um elemento de associação usando um certificado para assinar mensagens. Este elemento de associação pode ser usado apenas para trocas de mensagens unidirecionais e só é capaz de autenticar a mensagem.

CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters)

Cria um elemento de associação de segurança simétrica configurado para exigir autenticação do cliente usando um token emitido com base na chave simétrica.

CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters)

Cria um elemento de associação de segurança simétrica configurado para exigir a autenticação do cliente baseada em um token emitido e na autenticação de servidor baseada no certificado do servidor.

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters)

Cria um elemento de associação de segurança simétrica configurado para exigir a autenticação do cliente baseada em um token emitido e na autenticação de servidor baseada no certificado do servidor.

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean)

Cria um elemento de associação de segurança simétrica configurado para exigir a autenticação do cliente baseada em um token emitido e na autenticação de servidor baseada no certificado do servidor.

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).

CreateKerberosBindingElement()

Cria um elemento de associação de segurança simétrica configurado para exigir autenticação do cliente com base no token Kerberos do cliente.

CreateKerberosOverTransportBindingElement()

Cria um elemento de associação de segurança configurado para exigir autenticação do cliente com base em segurança SOAP usando o token Kerberos do cliente. O elemento de associação requer que o transporte forneça autenticação do servidor e proteção da mensagem (por exemplo, HTTPS).

CreateMutualCertificateBindingElement()

Cria um elemento de associação de segurança assimétrica configurado para exigir a autenticação de cliente baseada em certificado e a autenticação do servidor baseada em certificado.

CreateMutualCertificateBindingElement(MessageSecurityVersion)

Cria um elemento de associação de segurança assimétrica configurado para exigir a autenticação de cliente baseada em certificado e a autenticação do servidor baseada em certificado.

CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

Cria um elemento de associação de segurança assimétrica configurado para exigir a autenticação de cliente baseada em certificado e a autenticação do servidor baseada em certificado.

CreateMutualCertificateDuplexBindingElement()

Cria um elemento de associação de segurança assimétrica configurado para exigir a autenticação de cliente baseada em certificado e a autenticação do servidor baseada em certificado. Esse modo de autenticação pode ser usado para proteger os padrões de troca de mensagens duplex e requer que o serviço seja configurado com o certificado do cliente fora de banda.

CreateMutualCertificateDuplexBindingElement(MessageSecurityVersion)

Cria um elemento de associação de segurança assimétrica configurado para exigir a autenticação de cliente baseada em certificado e a autenticação do servidor baseada em certificado. Este modo de autenticação pode ser usado para proteger padrões de troca de mensagem duplex e exige que o serviço seja configurado com o certificado do cliente fora de banda.

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.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

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.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

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.

CreateSslNegotiationBindingElement(Boolean)

Cria um elemento de associação de segurança simétrica configurado para fazer a negociação SSL no nível do SOAP entre o cliente e o servidor, indicando se um certificado do cliente é necessário.

CreateSslNegotiationBindingElement(Boolean, Boolean)

Cria um elemento de associação de segurança simétrica que faz a negociação SSL SOAP, indicando se um certificado do cliente e o cancelamento são necessários.

CreateSspiNegotiationBindingElement()

Cria um elemento de associação de segurança simétrica que faz a negociação SSPI SOAP com base no pacote de autenticação Negotiate.

CreateSspiNegotiationBindingElement(Boolean)

Cria um elemento de associação de segurança simétrica que faz a negociação SSPI SOAP com base no pacote de autenticação Negotiate.

CreateSspiNegotiationOverTransportBindingElement()

Cria um elemento de associação de segurança configurado para autenticação de cliente com base na negociação SSPI SOAP usando o pacote de negociação Negotiate. O elemento de associação requer o transporte para fornecer a autenticação do servidor e a proteção de mensagem (por exemplo, HTTPS).

CreateSspiNegotiationOverTransportBindingElement(Boolean)

Cria um elemento de associação de segurança configurado para autenticação de cliente com base na negociação SSPI SOAP usando o pacote de negociação Negotiate. O elemento de associação requer o transporte para fornecer a autenticação do servidor e a proteção de mensagem (por exemplo, HTTPS).

CreateUserNameForCertificateBindingElement()

Cria um elemento de associação de segurança simétrico configurado para exigir a autenticação de cliente baseada em nome e em senha do usuário e a autenticação de servidor baseada em certificado. O elemento de associação criado exige que o cliente seja configurado com um certificado de serviço fora de banda antes de abrir um canal de comunicação com um serviço.

CreateUserNameForSslBindingElement()

Cria um elemento de associação de segurança simétrico configurado para exigir a autenticação de cliente baseada em nome e em senha do usuário e a autenticação de servidor baseada em certificado. O cliente autentica o servidor usando o protocolo SSL no nível do SOAP.

CreateUserNameForSslBindingElement(Boolean)

Cria um elemento de associação de segurança simétrico configurado para exigir a autenticação de cliente baseada em nome e em senha do usuário e a autenticação de servidor baseada em certificado. O cliente autentica o servidor usando o protocolo SSL no nível do SOAP.

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)
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)

Definirá a chave para a propriedade de requisito de token cujo valor será o BindingContext usado para se comunicar com a parte emissora se o requisito for um token emitido.

SetKeyDerivation(Boolean)

Define um valor que indica se as chaves derivadas são necessárias.

ToString()

Retorna uma descrição desta classe.

Aplica-se a

Confira também