HttpWebClientProtocol.ClientCertificates 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 a coleção de certificados do cliente.
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 da propriedade
Um X509CertificateCollection que representa os certificados do cliente.
- Atributos
Exemplos
O exemplo de código a seguir demonstra como carregar em um certificado do cliente de um arquivo e, em seguida, adicioná-lo à ClientCertificates propriedade para chamar um método de serviço Web XML que usa 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)
Comentários
Essa 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 de serviço Web XML tiver sido configurado para usar certificados de cliente, um certificado do cliente poderá ser usado como um mecanismo para autenticar um cliente. Para obter detalhes sobre como configurar certificados de cliente, consulte a documentação dos Serviços de Informações da Internet (IIS).
