ClientCredentials.ServiceCertificate Propriedade

Definição

Namespace:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

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

Public ReadOnly Property ServiceCertificate As X509CertificateRecipientClientCredential

Valor da propriedade

X509CertificateRecipientClientCredential

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.