SslStream.AuthenticateAsClientAsync Método
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.
Autenticar o lado cliente de uma ligação cliente-servidor como uma operação assíncrona.
Sobrecargas
| Name | Description |
|---|---|
| AuthenticateAsClientAsync(String) |
Chamada pelos clientes para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor como uma operação assíncrona. |
| AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken) |
Chamada pelos clientes para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza as informações especificadas no saco |
| AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean) |
Chamada pelos clientes para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza a coleção de certificados especificada e o protocolo SSL predefinido do sistema. |
| AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean) |
Chamada pelos clientes para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza a coleção de certificados especificada e o protocolo SSL. |
AuthenticateAsClientAsync(String)
Chamada pelos clientes para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor como uma operação assíncrona.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost);abstract member AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String) As TaskParâmetros
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
targetHost é null.
A autenticação falhou e deixou este objeto num estado inutilizável.
A autenticação já ocorreu.
-ou-
A autenticação do servidor usando isto SslStream foi tentada anteriormente.
-ou-
A autenticação já está em curso.
Este objeto foi encerrado.
Observações
A partir do .NET Framework 4.7, este método autentica usando None, que permite ao sistema operativo escolher o melhor protocolo a usar e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .NET Framework 4.5 com os últimos patches de segurança instalados), as versões permitidas dos protocolos TLS/SSL são 1.2, 1.1 e 1.0 (a menos que desative a criptografia forte editando o Registo do Windows). Não são utilizados certificados de cliente na autenticação. A lista de revogação de certificados não é verificada durante a autenticação. O valor especificado para targetHost deve corresponder ao nome no certificado do servidor.
Quando a autenticação for bem-sucedida, deve verificar as IsEncrypted propriedades e IsSigned para determinar que serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se ocorreu autenticação mútua.
Se a autenticação falhar, recebe um AuthenticationException, e este SslStream deixa de ser utilizável. Deves fechar este objeto e remover todas as referências a ele para que possa ser recolhido pelo coletor de lixo.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsClient(String).
Aplica-se a
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)
Chamada pelos clientes para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza as informações especificadas no saco sslClientAuthenticationOptions de propriedades.
public:
System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task AuthenticateAsClientAsync(System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken);member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, cancellationToken As CancellationToken) As TaskParâmetros
- sslClientAuthenticationOptions
- SslClientAuthenticationOptions
O saco de propriedade para a ligação SSL.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
sslClientAuthenticationOptions é null.
A autenticação falhou e deixou este objeto num estado inutilizável.
A autenticação já ocorreu.
-ou-
A autenticação do servidor usando isto SslStream foi tentada anteriormente.
-ou-
A autenticação já está em curso.
Este objeto foi encerrado.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Quando a autenticação for bem-sucedida, deve verificar as IsEncrypted propriedades e IsSigned para determinar que serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se ocorreu autenticação mútua.
Se a autenticação falhar, recebe um AuthenticationException, e este SslStream deixa de ser utilizável. Deves fechar este objeto e remover todas as referências a ele para que possa ser recolhido pelo coletor de lixo.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsClient(SslClientAuthenticationOptions).
Aplica-se a
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)
Chamada pelos clientes para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza a coleção de certificados especificada e o protocolo SSL predefinido do sistema.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation);abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As TaskParâmetros
- clientCertificates
- X509CertificateCollection
O X509CertificateCollection que contém certificados de clientes.
- checkCertificateRevocation
- Boolean
Um Boolean valor que especifica se a lista de revogação de certificados está verificada durante a autenticação.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
A autenticação falhou e deixou este objeto num estado inutilizável.
A autenticação já ocorreu.
-ou-
A autenticação do servidor usando isto SslStream foi tentada anteriormente.
-ou-
A autenticação já está em curso.
Este objeto foi encerrado.
Observações
A partir do .NET Framework 4.7, este método autentica usando None, que permite ao sistema operativo escolher o melhor protocolo a usar e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .NET Framework 4.5 com os últimos patches de segurança instalados), as versões permitidas dos protocolos TLS/SSL são 1.2, 1.1 e 1.0 (a menos que desative a criptografia forte editando o Registo do Windows).
Quando a autenticação for bem-sucedida, deve verificar as IsEncrypted propriedades e IsSigned para determinar que serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se ocorreu autenticação mútua.
Se a autenticação falhar, recebe um AuthenticationException, e este SslStream deixa de ser utilizável. Deves fechar este objeto e remover todas as referências a ele para que possa ser recolhido pelo coletor de lixo.
Note
Os certificados de cliente não são suportados no protocolo SSL versão 2.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsClient(String, X509CertificateCollection, Boolean).
Aplica-se a
AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)
Chamada pelos clientes para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza a coleção de certificados especificada e o protocolo SSL.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParâmetros
- clientCertificates
- X509CertificateCollection
O X509CertificateCollection que contém certificados de clientes.
- enabledSslProtocols
- SslProtocols
O SslProtocols valor que representa protocolos usados para autenticação.
- checkCertificateRevocation
- Boolean
Um Boolean valor que especifica se a lista de revogação de certificados está verificada durante a autenticação.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
A autenticação falhou e deixou este objeto num estado inutilizável.
A autenticação já ocorreu.
-ou-
A autenticação do servidor usando isto SslStream foi tentada anteriormente.
-ou-
A autenticação já está em curso.
Este objeto foi encerrado.
Observações
A partir do .NET Framework 4.7, este método autentica usando None, que permite ao sistema operativo escolher o melhor protocolo a usar e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .NET Framework 4.5 com os últimos patches de segurança instalados), as versões permitidas dos protocolos TLS/SSL são 1.2, 1.1 e 1.0 (a menos que desative a criptografia forte editando o Registo do Windows).
Quando a autenticação for bem-sucedida, deve verificar as IsEncrypted propriedades e IsSigned para determinar que serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se ocorreu autenticação mútua.
Se a autenticação falhar, recebe um AuthenticationException, e este SslStream deixa de ser utilizável. Deves fechar este objeto e remover todas as referências a ele para que possa ser recolhido pelo coletor de lixo.
Note
Os certificados de cliente não são suportados no protocolo SSL versão 2.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean).