Partilhar via


SslStream.AuthenticateAsClientAsync Método

Definição

Autenticação do lado do cliente de uma conexão de cliente-servidor como uma operação assíncrona.

Sobrecargas

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Chamado por clientes para autenticar o servidor e, como opção, o cliente em uma conexão de cliente-servidor como uma operação assíncrona. O processo de autenticação usa o protocolo SSL e coleção de certificado especificados.

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Chamado por clientes para autenticar o servidor e, como opção, o cliente em uma conexão de cliente-servidor como uma operação assíncrona. O processo de autenticação usa o protocolo SSL padrão do sistema e a coleção de certificado especificados.

AuthenticateAsClientAsync(String)

Chamado por clientes para autenticar o servidor e, como opção, o cliente em uma conexão de cliente-servidor como uma operação assíncrona.

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Chamado por clientes para autenticar o servidor e, como opção, o cliente em uma conexão de cliente-servidor como uma operação assíncrona. O processo de autenticação usa as informações especificadas no recipiente de propriedades sslClientAuthenticationOptions.

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Origem:
SslStream.cs
Origem:
SslStream.cs
Origem:
SslStream.cs

Chamado por clientes para autenticar o servidor e, como opção, o cliente em uma conexão de cliente-servidor como uma operação assíncrona. O processo de autenticação usa o protocolo SSL e coleção de certificado especificados.

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);
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.Task
Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Parâmetros

targetHost
String

O nome do servidor que compartilha esse SslStream.

clientCertificates
X509CertificateCollection

O X509CertificateCollection que contém os certificados de cliente.

enabledSslProtocols
SslProtocols

O valor SslProtocols que representa os protocolos usados para autenticação.

checkCertificateRevocation
Boolean

Um valor Boolean que especifica se a lista de certificados revogados é verificada durante a autenticação.

Retornos

O objeto de tarefa que representa a operação assíncrona.

Exceções

A autenticação falhou e deixou esse objeto em um estado inutilizável.

A autenticação já ocorreu.

- ou -

Houve uma tentativa anterior de autenticação do servidor usando este SslStream.

- ou -

A autenticação já está em andamento.

Este objeto foi fechado.

Comentários

A partir do .NET Framework 4.7, esse método autentica usando o None, o que permite que o sistema operacional escolha o melhor protocolo a ser usado e bloqueie protocolos que não são seguros. No .NET Framework 4.6 (e .NET Framework 4.5 com os patches de segurança mais recentes instalados), as versões de protocolos TLS/SSL permitidas são 1.2, 1.1 e 1.0 (a menos você desabilite a criptografia forte ao editar o Registro do Windows).

Quando a autenticação for bem-sucedida, você deverá marcar as IsEncrypted propriedades e IsSigned para determinar quais serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se a autenticação mútua ocorreu.

Se a autenticação falhar, você receberá um AuthenticationExceptione isso SslStream não será mais utilizável. Você deve fechar esse objeto e remover todas as referências a ele para que ele possa ser coletado pelo coletor de lixo.

Observação

Não há suporte para certificados de cliente no protocolo SSL versão 2.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean).

Aplica-se a

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Origem:
SslStream.cs
Origem:
SslStream.cs
Origem:
SslStream.cs

Chamado por clientes para autenticar o servidor e, como opção, o cliente em uma conexão de cliente-servidor como uma operação assíncrona. O processo de autenticação usa o protocolo SSL padrão do sistema e a coleção de certificado especificados.

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);
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.Task
Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As Task

Parâmetros

targetHost
String

O nome do servidor que compartilha esse SslStream.

clientCertificates
X509CertificateCollection

O X509CertificateCollection que contém os certificados de cliente.

checkCertificateRevocation
Boolean

Um valor Boolean que especifica se a lista de certificados revogados é verificada durante a autenticação.

Retornos

O objeto de tarefa que representa a operação assíncrona.

Exceções

A autenticação falhou e deixou esse objeto em um estado inutilizável.

A autenticação já ocorreu.

- ou -

Houve uma tentativa anterior de autenticação do servidor usando este SslStream.

- ou -

A autenticação já está em andamento.

Este objeto foi fechado.

Comentários

A partir do .NET Framework 4.7, esse método autentica usando o None, o que permite que o sistema operacional escolha o melhor protocolo a ser usado e bloqueie protocolos que não são seguros. No .NET Framework 4.6 (e .NET Framework 4.5 com os patches de segurança mais recentes instalados), as versões de protocolos TLS/SSL permitidas são 1.2, 1.1 e 1.0 (a menos você desabilite a criptografia forte ao editar o Registro do Windows).

Quando a autenticação for bem-sucedida, você deverá marcar as IsEncrypted propriedades e IsSigned para determinar quais serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se a autenticação mútua ocorreu.

Se a autenticação falhar, você receberá um AuthenticationExceptione isso SslStream não será mais utilizável. Você deve fechar esse objeto e remover todas as referências a ele para que ele possa ser coletado pelo coletor de lixo.

Observação

Não há suporte para certificados de cliente no protocolo SSL versão 2.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por AuthenticateAsClient(String, X509CertificateCollection, Boolean).

Aplica-se a

AuthenticateAsClientAsync(String)

Origem:
SslStream.cs
Origem:
SslStream.cs
Origem:
SslStream.cs

Chamado por clientes para autenticar o servidor e, como opção, o cliente em uma conexão de 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.Task
Public Overridable Function AuthenticateAsClientAsync (targetHost As String) As Task

Parâmetros

targetHost
String

O nome do servidor que compartilha esse SslStream.

Retornos

O objeto de tarefa que representa a operação assíncrona.

Exceções

targetHost é null.

A autenticação falhou e deixou esse objeto em um estado inutilizável.

A autenticação já ocorreu.

- ou -

Houve uma tentativa anterior de autenticação do servidor usando este SslStream.

- ou -

A autenticação já está em andamento.

Este objeto foi fechado.

Comentários

A partir do .NET Framework 4.7, esse método autentica usando o None, o que permite que o sistema operacional escolha o melhor protocolo a ser usado e bloqueie protocolos que não são seguros. No .NET Framework 4.6 (e .NET Framework 4.5 com os patches de segurança mais recentes instalados), as versões de protocolos TLS/SSL permitidas são 1.2, 1.1 e 1.0 (a menos você desabilite a criptografia forte ao editar o Registro do Windows). Nenhum certificado de cliente é usado 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, você deverá marcar as IsEncrypted propriedades e IsSigned para determinar quais serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se a autenticação mútua ocorreu.

Se a autenticação falhar, você receberá um AuthenticationExceptione isso SslStream não será mais utilizável. Você deve fechar esse objeto e remover todas as referências a ele para que ele possa ser coletado pelo coletor de lixo.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por AuthenticateAsClient(String).

Aplica-se a

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Origem:
SslStream.cs
Origem:
SslStream.cs
Origem:
SslStream.cs

Chamado por clientes para autenticar o servidor e, como opção, o cliente em uma conexão de cliente-servidor como uma operação assíncrona. O processo de autenticação usa as informações especificadas no recipiente de propriedades sslClientAuthenticationOptions.

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 = default);
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.Task
Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, cancellationToken As CancellationToken) As Task

Parâmetros

sslClientAuthenticationOptions
SslClientAuthenticationOptions

O recipiente de propriedades para a conexão SSL.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento.

Retornos

O objeto de tarefa que representa a operação assíncrona.

Exceções

sslClientAuthenticationOptions é null.

A autenticação falhou e deixou esse objeto em um estado inutilizável.

A autenticação já ocorreu.

- ou -

Houve uma tentativa anterior de autenticação do servidor usando este SslStream.

- ou -

A autenticação já está em andamento.

Este objeto foi fechado.

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Quando a autenticação for bem-sucedida, você deverá marcar as IsEncrypted propriedades e IsSigned para determinar quais serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se a autenticação mútua ocorreu.

Se a autenticação falhar, você receberá um AuthenticationExceptione isso SslStream não será mais utilizável. Você deve fechar esse objeto e remover todas as referências a ele para que ele possa ser coletado pelo coletor de lixo.

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por AuthenticateAsClient(SslClientAuthenticationOptions).

Aplica-se a