HttpWebClientProtocol.ClientCertificates Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe a coleção de certificados de clientes.
public:
property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); };[System.ComponentModel.Browsable(false)]
public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; }[<System.ComponentModel.Browsable(false)>]
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollectionPublic ReadOnly Property ClientCertificates As X509CertificateCollectionValor de Propriedade
Um X509CertificateCollection que representa os certificados do cliente.
- Atributos
Exemplos
O exemplo de código seguinte demonstra como carregar um certificado cliente a partir de um ficheiro e depois adicioná-lo à ClientCertificates propriedade para chamar um método de serviço Web XML que utiliza certificados de cliente para autenticação.
// Create a new instance of a proxy class for the Bank XML Web service.
BankSession bank = new BankSession();
// Load the client certificate from a file.
X509Certificate x509 = X509Certificate.CreateFromCertFile(@"c:\user.cer");
// Add the client certificate to the ClientCertificates property of the proxy class.
bank.ClientCertificates.Add(x509);
// Communicate with the Deposit XML Web service method,
// which requires authentication using client certificates.
bank.Deposit(500);
' Create a new instance of a proxy class for the Bank XML Web service.
Dim bank As BankSession = new BankSession()
' Load the client certificate from a file.
Dim x509 As X509Certificate = X509Certificate.CreateFromCertFile("c:\user.cer")
' Add the client certificate to the ClientCertificates property of the proxy class.
bank.ClientCertificates.Add(x509)
' Communicate with the Deposit XML Web service method,
' which requires authentication using client certificates.
bank.Deposit(500)
Observações
Esta propriedade permite que um cliente passe um ou mais certificados de cliente, também conhecidos como certificados Authenticode X.509 v.3, ao chamar um método de serviço Web XML. Se o método do serviço Web XML tiver sido configurado para usar certificados de cliente, um certificado de cliente pode ser usado como um dos mecanismos para autenticar um cliente. Para detalhes sobre a configuração de certificados de cliente, consulte a documentação do Serviços de Informação Internet (IIS).