Partilhar via


SslStream.BeginAuthenticateAsServer Método

Definição

Inicia uma operação assíncrona para lidar com o lado do servidor de autenticação de uma conexão cliente-servidor.

Sobrecargas

BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)

Chamado por servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor em uma conexão cliente-servidor.

BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)

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

BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)

Chamado por servidores para iniciar uma operação assíncrona para autenticar o servidor e, opcionalmente, o cliente usando os certificados, requisitos e protocolo de segurança 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 AuthenticateAsServer métodos.

BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)

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

Chamado por servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor em uma conexão cliente-servidor.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parâmetros

serverCertificate
X509Certificate

O X509Certificate usado para autenticar o servidor.

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

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

Exceções

serverCertificate é null.

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

A autenticação já ocorreu.

- ou -

A autenticação de cliente usando esse SslStream foi tentada anteriormente.

- ou -

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

Este objeto foi fechado.

Não há suporte para o método BeginAuthenticateAsServer no Windows 95, Windows 98 ou Windows Millennium.

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). A lista de revogação de certificados não é verificada durante a autenticação. O cliente não é necessário para fornecer um certificado para autenticação.

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.

Aplica-se a

BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)

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

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

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parâmetros

serverCertificate
X509Certificate

O X509Certificate usado para autenticar o servidor.

clientCertificateRequired
Boolean

Um valor Boolean que especifica se um certificado é solicitado ao cliente para que ele realize a autenticação. Observe que isso é apenas uma solicitação. Se nenhum certificado for fornecido, o servidor ainda aceitará a solicitação de conexã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

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

Exceções

serverCertificate é 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.

Não há suporte para o método BeginAuthenticateAsServer no Windows 95, Windows 98 ou Windows Millennium.

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

A operação de autenticação assíncrona deve ser concluída chamando o EndAuthenticateAsServer 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 AuthenticateAsServer 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

BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)

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

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

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parâmetros

serverCertificate
X509Certificate

O X509Certificate usado para autenticar o servidor.

clientCertificateRequired
Boolean

Um valor Boolean que especifica se um certificado é solicitado ao cliente para que ele realize a autenticação. Observe que isso é apenas uma solicitação. Se nenhum certificado for fornecido, o servidor ainda aceitará a solicitação de conexão.

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

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

Exceções

serverCertificate é null.

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

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.

Não há suporte para o método BeginAuthenticateAsServer no Windows 95, Windows 98 ou Windows Millennium.

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

A operação de autenticação assíncrona deve ser concluída chamando o EndAuthenticateAsServer 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 AuthenticateAsServer 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