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 de 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 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:
Criará 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 ReliableSessionBindingElemento .
Adicione esses elementos na ordem descrita anteriormente ao BindingElementCollection usando o InsertItem método .
Crie 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 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. |
