Partilhar via


HttpWebClientProtocol.ClientCertificates Propriedade

Definição

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.X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection

Valor 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).

Aplica-se a

Confira também