SslStream.AuthenticateAsServerAsync 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.
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 |
| 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 |
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.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParâ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.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As TaskParâ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.TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As TaskParâ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
ServerCertificateSelectionCallback ou ServerCertificate ou ServerCertificateContext é null, e LocalCertificateSelectionCallback não está definido no construtor SslStream.
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.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As TaskParâ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.TaskPublic Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As TaskParâ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
ServerCertificateSelectionCallback ou ServerCertificate ou ServerCertificateContext é null, e LocalCertificateSelectionCallback não está definido no construtor SslStream.
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.
