SslStream.BeginAuthenticateAsClient Método
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.
Inicia uma operação para autenticar o lado do cliente de uma conexão cliente-servidor.
Sobrecargas
| Nome | Description |
|---|---|
| BeginAuthenticateAsClient(String, AsyncCallback, Object) |
Chamado pelos clientes para iniciar uma operação assíncrona para autenticar o servidor e, opcionalmente, o cliente. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object) |
Chamado pelos 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 padrão do sistema. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object) |
Chamado pelos 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. |
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
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
Chamado pelos 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);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParâmetros
- asyncCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a ser invocado quando a autenticação for concluída.
- asyncState
- Object
Um objeto definido pelo usuário que contém informações sobre a operação. Esse objeto é passado para o asyncCallback delegado quando a operação é concluída.
Retornos
Um IAsyncResult objeto que indica o status da 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 -
A autenticação do servidor usando isso SslStream foi tentada anteriormente.
- ou -
A autenticação já está em andamento.
Este objeto foi fechado.
Comentários
A partir do .NET Framework 4.7, esse método é autenticado usando None, o que permite ao sistema operacional escolher o melhor protocolo a ser usado e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .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 que você desabilite criptografia forte editando 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 deve targetHost 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 é bloqueado enquanto a operação é concluída. Para bloquear até que a operação seja concluída, use uma das sobrecargas do 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.
Aplica-se a
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
Chamado pelos 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 padrão do sistema.
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);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 -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParâmetros
- clientCertificates
- X509CertificateCollection
Os X509CertificateCollection certificados de cliente que contêm.
- checkCertificateRevocation
- Boolean
Um Boolean valor que especifica se a lista de revogação de certificados é verificada durante a autenticação.
- asyncCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a ser invocado quando a autenticação for concluída.
- asyncState
- Object
Um objeto definido pelo usuário que contém informações sobre a operação. Esse objeto é passado para o asyncCallback delegado quando a operação é concluída.
Retornos
Um IAsyncResult objeto que indica o status da 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 -
A autenticação do servidor usando isso SslStream foi tentada anteriormente.
- ou -
A autenticação já está em andamento.
Este objeto foi fechado.
Comentários
A partir do .NET Framework 4.7, esse método é autenticado usando None, o que permite ao sistema operacional escolher o melhor protocolo a ser usado e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .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 que você desabilite criptografia forte editando o Registro do Windows).
O valor especificado deve targetHost 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 é bloqueado enquanto a operação é concluída. Para bloquear até que a operação seja concluída, use uma das sobrecargas do 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.
Note
Não há suporte para certificados de cliente no protocolo SSL versão 2.
Aplica-se a
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
Chamado pelos 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.
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);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 -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParâmetros
- clientCertificates
- X509CertificateCollection
Os X509CertificateCollection certificados de cliente que contêm.
- enabledSslProtocols
- SslProtocols
O SslProtocols valor que representa os protocolos usados para autenticação.
- checkCertificateRevocation
- Boolean
Um Boolean valor que especifica se a lista de revogação de certificados é verificada durante a autenticação.
- asyncCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a ser invocado quando a autenticação for concluída.
- asyncState
- Object
Um objeto definido pelo usuário que contém informações sobre a operação. Esse objeto é passado para o asyncCallback delegado quando a operação é concluída.
Retornos
Um IAsyncResult objeto que indica o status da operação assíncrona.
Exceções
targetHost é null.
enabledSslProtocols não é um valor válido SslProtocols .
A autenticação falhou e deixou esse objeto em um estado inutilizável.
A autenticação já ocorreu.
- ou -
A autenticação do servidor usando isso SslStream foi tentada anteriormente.
- ou -
A autenticação já está em andamento.
Este objeto foi fechado.
Comentários
A partir do .NET Framework 4.7, esse método é autenticado usando None, o que permite ao sistema operacional escolher o melhor protocolo a ser usado e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .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 que você desabilite criptografia forte editando o Registro do Windows).
O valor especificado deve targetHost 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 é bloqueado enquanto a operação é concluída. Para bloquear até que a operação seja concluída, use uma das sobrecargas do 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.
Note
Não há suporte para certificados de cliente no protocolo SSL versão 2.
