ClientCredentials.ServiceCertificate Propriedade
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.
Obtém um objeto usado para especificar o certificado X.509 de um serviço.
public:
property System::ServiceModel::Security::X509CertificateRecipientClientCredential ^ ServiceCertificate { System::ServiceModel::Security::X509CertificateRecipientClientCredential ^ get(); };public System.ServiceModel.Security.X509CertificateRecipientClientCredential ServiceCertificate { get; }member this.ServiceCertificate : System.ServiceModel.Security.X509CertificateRecipientClientCredentialPublic ReadOnly Property ServiceCertificate As X509CertificateRecipientClientCredentialValor da propriedade
Um X509CertificateRecipientClientCredential que representa o certificado a ser usado para um serviço específico.
Exemplos
Esse código mostra como usar essa propriedade para obter o certificado do serviço e definir suas propriedades.
X509CertificateRecipientClientCredential rcc =
client.ClientCredentials.ServiceCertificate;
X509Certificate2 cert = new X509Certificate2();
rcc.ScopedCertificates.Add(new Uri("http://fabrikam.com/sts"), cert);
Comentários
Você pode usar o objeto retornado por essa propriedade para configurar as propriedades do certificado chamando seus membros.
Você pode especificar um único certificado padrão, bem como um certificado diferente a ser usado ao se comunicar com um URI específico.
Por meio dessa classe, você também controla as configurações de autenticação para certificados de serviço negociados por meio da negociação SSL/TLS executada no nível da mensagem.
Essa propriedade nem sempre precisa ser especificada. Se é necessário depende do modo de autenticação e das opções de negociação definidas na associação usada para se comunicar com o serviço. Algumas classes relevantes que controlam esse comportamento são MessageSecurityOverHttp e MessageSecurityOverTcp.
Você também pode definir esse valor usando o <elemento de certificado> em um arquivo de configuração de aplicativo cliente.