Compartilhar via


SslStream.AuthenticateAsServerAsync Método

Definição

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

Sobrecargas

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

Chamado pelos servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando os certificados especificados, requisitos e o protocolo de segurança como uma operação síncrona.

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

Chamado pelos servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando os certificados especificados, requisitos e o protocolo de segurança como uma operação síncrona.

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

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

AuthenticateAsServerAsync(X509Certificate)

Chamado pelos servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando o certificado especificado como uma operação assíncrona.

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

Chamado por servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor como uma operação assíncrona. O processo de autenticação usa informações retornadas por optionsCallback.

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

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

Chamado pelos servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando os certificados especificados, requisitos e o protocolo de segurança como uma operação síncrona.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

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.

Retornos

O objeto de tarefa que representa a 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.

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

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 AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).

Aplica-se a

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

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

Chamado pelos servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando os certificados especificados, requisitos e o protocolo de segurança como uma operação síncrona.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);
abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As Task

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.

Retornos

O objeto de tarefa que representa a 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.

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

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 AuthenticateAsServer(X509Certificate, Boolean, Boolean).

Aplica-se a

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

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

Chamado por servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão 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 ^ AuthenticateAsServerAsync(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);
public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken);
member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As Task

Parâmetros

sslServerAuthenticationOptions
SslServerAuthenticationOptions

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

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

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

Comentários

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 AuthenticateAsServer(SslServerAuthenticationOptions).

Aplica-se a

AuthenticateAsServerAsync(X509Certificate)

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

Chamado pelos servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando o certificado especificado como uma operação assíncrona.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);
abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As Task

Parâmetros

serverCertificate
X509Certificate

O certificado usado para autenticar o servidor.

Retornos

O objeto de tarefa que representa a 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 AuthenticateAsServerAsync 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).

Esse método é autenticado usando Default. 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.

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 AuthenticateAsServer(X509Certificate).

Aplica-se a

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

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

Chamado por servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor como uma operação assíncrona. O processo de autenticação usa informações retornadas por optionsCallback.

public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.ServerOptionsSelectionCallback optionsCallback, object? state, System.Threading.CancellationToken cancellationToken = default);
member this.AuthenticateAsServerAsync : System.Net.Security.ServerOptionsSelectionCallback * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As Task

Parâmetros

optionsCallback
ServerOptionsSelectionCallback

O delegado de retorno de chamada.

state
Object

O objeto de estado a ser passado para optionsCallback quando o retorno de chamada é invocado.

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

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.

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

Comentários

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.

Aplica-se a