SslStream.BeginAuthenticateAsClient Método

Definição

Namespace:

System.Net.Security

Assembly:

System.Net.Security.dll

Inicia uma operação para autenticar o lado do cliente de uma conexão de cliente-servidor.

Sobrecargas

BeginAuthenticateAsClient(String, AsyncCallback, Object)	Chamado por clientes para iniciar uma operação assíncrona para autenticar o servidor e, opcionalmente, o cliente.
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)	Chamado por clientes para iniciar uma operação assíncrona para autenticar o servidor e, opcionalmente, o cliente usando os certificados especificados e o protocolo de segurança do sistema padrão.
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)	Chamado por clientes para iniciar uma operação assíncrona para autenticar o servidor e, opcionalmente, o cliente usando o protocolo de segurança e certificados especificados.

Comentários

As sobrecargas desse método não bloqueiam enquanto a autenticação está em andamento. Para bloquear enquanto aguarda a conclusão da autenticação, use um dos AuthenticateAsClient métodos .

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Origem:

SslStream.cs

Chamado por clientes para iniciar uma operação assíncrona para autenticar o servidor e, opcionalmente, o cliente.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, AsyncCallback? asyncCallback, object? asyncState);

abstract member BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parâmetros

targetHost

String

O nome do servidor que compartilha esse SslStream.

asyncCallback

AsyncCallback

Um representante AsyncCallback que faz referência ao método a ser invocado quando a autenticação é concluída.

asyncState

Object

Um objeto definido pelo usuário que contém informações sobre a operação. Esse objeto é passado para o representante asyncCallback quando a operação é concluída.

Retornos

IAsyncResult

Um objeto IAsyncResult que indica o status da operação assíncrona.

Exceções

ArgumentNullException

targetHost é null.

AuthenticationException

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

InvalidOperationException

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.

ObjectDisposedException

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.

A operação de autenticação assíncrona deve ser concluída chamando o EndAuthenticateAsClient método . Normalmente, o método é invocado pelo asyncCallback delegado.

Esse método não bloqueia enquanto a operação é concluída. Para bloquear até que a operação seja concluída, use uma das sobrecargas de AuthenticateAsClient método.

Para obter informações detalhadas sobre como usar o modelo de programação assíncrona, consulte Chamando métodos síncronos de forma assíncrona

Se você receber um AuthenticationException, 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.

BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)

Origem:

SslStream.cs

Chamado por clientes para iniciar uma operação assíncrona para autenticar o servidor e, opcionalmente, o cliente usando os certificados especificados e o protocolo de segurança do sistema padrão.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);

abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

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.

asyncCallback

AsyncCallback

Um representante AsyncCallback que faz referência ao método a ser invocado quando a autenticação é concluída.

asyncState

Object

Um objeto definido pelo usuário que contém informações sobre a operação. Esse objeto é passado para o representante asyncCallback quando a operação é concluída.

Retornos

IAsyncResult

Um objeto IAsyncResult que indica o status da operação assíncrona.

Exceções

ArgumentNullException

targetHost é null.

AuthenticationException

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

InvalidOperationException

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.

ObjectDisposedException

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

O valor especificado para targetHost deve corresponder ao nome no certificado do servidor.

A operação de autenticação assíncrona deve ser concluída chamando o EndAuthenticateAsClient método . Normalmente, o método é invocado pelo asyncCallback delegado.

Esse método não bloqueia enquanto a operação é concluída. Para bloquear até que a operação seja concluída, use uma das sobrecargas de AuthenticateAsClient método.

Para obter informações detalhadas sobre como usar o modelo de programação assíncrona, consulte Chamando métodos síncronos de forma assíncrona

Se você receber um AuthenticationException, 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.

BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)

Origem:

SslStream.cs

Chamado por clientes para iniciar uma operação assíncrona para autenticar o servidor e, opcionalmente, o cliente usando o protocolo de segurança e certificados especificados.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);

abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

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.

asyncCallback

AsyncCallback

Um representante AsyncCallback que faz referência ao método a ser invocado quando a autenticação é concluída.

asyncState

Object

Um objeto definido pelo usuário que contém informações sobre a operação. Esse objeto é passado para o representante asyncCallback quando a operação é concluída.

Retornos

IAsyncResult

Um objeto IAsyncResult que indica o status da operação assíncrona.

Exceções

ArgumentNullException

targetHost é null.

ArgumentException

enabledSslProtocols não é um valor SslProtocols válido.

AuthenticationException

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

InvalidOperationException

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.

ObjectDisposedException

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

O valor especificado para targetHost deve corresponder ao nome no certificado do servidor.

A operação de autenticação assíncrona deve ser concluída chamando o EndAuthenticateAsClient método . Normalmente, o método é invocado pelo asyncCallback delegado.

Esse método não bloqueia enquanto a operação é concluída. Para bloquear até que a operação seja concluída, use uma das sobrecargas de AuthenticateAsClient método.

Para obter informações detalhadas sobre como usar o modelo de programação assíncrona, consulte Chamando métodos síncronos de forma assíncrona

Se você receber um AuthenticationException, 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.