SecurityBindingElement Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Uma classe abstrata que, quando implementada, representa um elemento de associação que dá suporte à segurança de mensagens SOAP do canal.
public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElementpublic abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElementtype SecurityBindingElement = class
inherit BindingElementPublic MustInherit Class SecurityBindingElement
Inherits BindingElement- Herança
- 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 desta classe abstrata: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElemente TransportSecurityBindingElement. Essas implementações modelam as associações definidas na especificação WS-Security Policy.
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:
Crie um BindingElementCollection.
Crie um elemento de associação personalizado acima desse elemento de associação na pilha de associação, como o opcional TransactionFlowBindingElement e ReliableSessionBindingElement.
Adicione esses elementos na ordem descrita anteriormente ao BindingElementCollection uso do InsertItem método.
Criar uma instância de um elemento de associação de segurança derivado de SecurityBindingElement, como AsymmetricSecurityBindingElement, SymmetricSecurityBindingElementou TransportSecurityBindingElement.
Adicione o elemento de associação de segurança derivado à coleção.
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 assim são KeyType e MessageSecurityVersion. Pode haver outras propriedades das quais isso também é verdade.
Propriedades
| Nome | Description |
|---|---|
| AllowInsecureTransport |
Obtém ou define um valor que indica se mensagens protegidas no modo misto podem ser enviadas por meio de 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 não seguras para solicitações protegidas. |
| EndpointSupportingTokenParameters |
Obtém o ponto de extremidade que dá suporte a parâmetros de token. |
| IncludeTimestamp |
Obtém ou define um valor que indica se os 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 às configurações de segurança locais usadas pelo cliente. |
| LocalServiceSettings |
Obtém as propriedades de associação específicas às 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 de 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 de operação opcional. |
| 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
| Nome | Description |
|---|---|
| BuildChannelFactory<TChannel>(BindingContext) |
Cria uma fábrica de canais com base nas SecurityBindingElement configurações e no contexto de associação passado. A fábrica de canais criada é uma fábrica de canais de segurança de mensagens SOAP, que internamente tem 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 canal com base nas SecurityBindingElement configurações e no contexto de associação passado. |
| BuildChannelListenerCore<TChannel>(BindingContext) |
Quando implementado, cria um ouvinte de canal 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 canal do tipo especificado pode ser criado. |
| Clone() |
Quando substituído em uma classe derivada, retorna uma cópia do objeto de elemento de associação. (Herdado de BindingElement) |
| CreateAnonymousForCertificateBindingElement() |
Cria um elemento de associação de segurança simétrica configurado para autenticação de cliente anônimo 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 autenticação baseada em certificado usando a segurança da mensagem SOAP. |
| CreateCertificateOverTransportBindingElement(MessageSecurityVersion) |
Cria um elemento de associação de segurança que espera que os clientes façam autenticação baseada em certificado usando a segurança da mensagem SOAP. |
| CreateCertificateSignatureBindingElement() |
Cria um elemento de associação usando um certificado para assinar mensagens. Esse elemento de associação pode ser usado apenas para trocas de mensagens unidirecionais e é capaz apenas de assinar a mensagem. |
| CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters) |
Cria um elemento de associação de segurança simétrica configurado para exigir a autenticação do cliente usando um token emitido com base em chave simétrica. |
| CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters) |
Cria um elemento de associação de segurança simétrica configurado para exigir autenticação de cliente com base em um token emitido e autenticação de servidor com base no certificado do servidor. |
| CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean) |
Cria um elemento de associação de segurança simétrica configurado para exigir autenticação de cliente com base em um token emitido e autenticação de servidor com base no certificado do servidor. |
| CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters) |
Cria um elemento de associação de segurança simétrica configurado para exigir autenticação de cliente com base em um token emitido e autenticação de servidor com base no certificado do servidor. |
| CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters) |
Cria um elemento de associação de segurança configurado para exigir a autenticação de cliente baseada em segurança SOAP usando um token emitido. Esse elemento de associação requer o transporte para fornecer autenticação de servidor e proteção de mensagem (por exemplo, HTTPS). |
| CreateKerberosBindingElement() |
Cria um elemento de associação de segurança simétrica configurado para exigir a autenticação do cliente com base no token Kerberos do cliente. |
| CreateKerberosOverTransportBindingElement() |
Cria um elemento de associação de segurança configurado para exigir a autenticação de cliente baseada em segurança SOAP usando o token Kerberos do cliente. Esse elemento de associação requer o transporte para fornecer autenticação de servidor e proteção de mensagem (por exemplo, HTTPS). |
| CreateMutualCertificateBindingElement() |
Cria um elemento de associação de segurança assimétrica configurado para exigir autenticação de cliente baseada em certificado, bem como autenticação de servidor baseada em certificado. |
| CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean) |
Cria um elemento de associação de segurança assimétrica configurado para exigir autenticação de cliente baseada em certificado, bem como autenticação de servidor baseada em certificado. |
| CreateMutualCertificateBindingElement(MessageSecurityVersion) |
Cria um elemento de associação de segurança assimétrica configurado para exigir autenticação de cliente baseada em certificado, bem como autenticação de servidor baseada em certificado. |
| CreateMutualCertificateDuplexBindingElement() |
Cria um elemento de associação de segurança assimétrica configurado para exigir autenticação de cliente baseada em certificado, bem como autenticação de servidor baseada em certificado. Esse modo de autenticação pode ser usado para proteger padrões duplex de troca de mensagens 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 autenticação de cliente baseada em certificado, bem como autenticação de servidor baseada em certificado. Esse modo de autenticação pode ser usado para proteger padrões de troca de mensagens duplex e exige que o serviço seja configurado com o certificado do cliente fora de banda. |
| 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 de contexto de segurança emitido no final do handshake de conversa segura é usado para proteger as mensagens. O elemento de associação de segurança 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 de contexto de segurança emitido no final do handshake de conversa segura é usado para proteger as mensagens. |
| 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 de contexto de segurança emitido no final do handshake de conversa segura é usado para proteger as mensagens. O elemento de associação de segurança bootstrap especifica como as mensagens de handshake de conversa segura são protegidas. |
| CreateSslNegotiationBindingElement(Boolean, Boolean) |
Cria um elemento de associação de segurança simétrica que faz a negociação soap SSL, observando se um certificado e cancelamento de cliente são necessários. |
| CreateSslNegotiationBindingElement(Boolean) |
Cria um elemento de associação de segurança simétrica configurado para fazer a negociação SSL no nível SOAP entre o cliente e o servidor, observando se um certificado de cliente é necessário. |
| CreateSspiNegotiationBindingElement() |
Cria um elemento de associação de segurança simétrica que faz a negociação de 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 de 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 de SSPI SOAP usando o pacote de autenticação Negotiate. O elemento de associação requer o transporte para fornecer autenticação de servidor e 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 de SSPI SOAP usando o pacote de autenticação Negotiate. O elemento de associação requer o transporte para fornecer autenticação de servidor e proteção de mensagem (por exemplo, HTTPS). |
| CreateUserNameForCertificateBindingElement() |
Cria um elemento de associação de segurança simétrica configurado para exigir autenticação de cliente baseada em nome de usuário e senha e autenticação de servidor baseada em certificado. O elemento de associação criado requer 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étrica configurado para exigir autenticação de cliente baseada em nome de usuário e senha e autenticação de servidor baseada em certificado. O cliente autentica o servidor usando o protocolo SSL no nível SOAP. |
| CreateUserNameForSslBindingElement(Boolean) |
Cria um elemento de associação de segurança simétrica configurado para exigir autenticação de cliente baseada em nome de usuário e senha e autenticação de servidor baseada em certificado. O cliente autentica o servidor usando o protocolo SSL no nível SOAP. |
| CreateUserNameOverTransportBindingElement() |
Cria um elemento de associação de segurança configurado para autenticação de 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 autenticação de servidor e 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 especificado BindingContext. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext) |
Define a chave para a propriedade de requisito de token cujo valor é BindingContext usado para falar com a parte emissora se o requisito for para um token emitido. |
| SetKeyDerivation(Boolean) |
Define um valor que indica se as chaves derivadas são necessárias. |
| ToString() |
Retorna uma descrição dessa classe. |
Aplica-se a
Confira também
- Modos de autenticação do SecurityBindingElement
- Como criar uma associação personalizada usando o SecurityBindingElement
