SslStream.AuthenticateAsServerAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Chamada pelos servidores para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor como uma operação assíncrona.
Sobrecargas
| Name | Description |
|---|---|
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Chamada pelos servidores para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor usando os certificados, requisitos e protocolo de segurança especificados como uma operação assíncrona. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Chamada pelos servidores para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor usando os certificados, requisitos e protocolo de segurança especificados como uma operação assíncrona. |
| AuthenticateAsServerAsync(X509Certificate) |
Chamada pelos servidores para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor usando o certificado especificado como uma operação assíncrona. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Autentica o servidor e, opcionalmente, o cliente numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza as informações especificadas no saco |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
Chamada pelos servidores para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor usando os certificados, requisitos e protocolo de segurança especificados como uma operação assí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 que especifica Boolean se o cliente é solicitado a um certificado para autenticação. Note que isto é apenas um pedido — se não for fornecido um certificado, o servidor ainda aceita o pedido de ligação.
- enabledSslProtocols
- SslProtocols
O SslProtocols valor que representa protocolos usados para autenticação.
- checkCertificateRevocation
- Boolean
Um Boolean valor que especifica se a lista de revogação de certificados está verificada durante a autenticação.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
serverCertificate é null.
A autenticação falhou e deixou este objeto num estado inutilizável.
A autenticação já ocorreu.
-ou-
A autenticação do cliente usando isto SslStream já foi tentada anteriormente.
-ou-
A autenticação já está em curso.
Este objeto foi encerrado.
Observações
A partir do .NET Framework 4.7, este método autentica usando None, que permite ao sistema operativo escolher o melhor protocolo a usar e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .NET Framework 4.5 com os últimos patches de segurança instalados), as versões permitidas dos protocolos TLS/SSL são 1.2, 1.1 e 1.0 (a menos que desative a criptografia forte editando o Registo do Windows).
Se a autenticação falhar, recebe um AuthenticationException, e este SslStream deixa de ser utilizável. Deves fechar este objeto e remover todas as referências a ele para que possa ser recolhido pelo coletor de lixo.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).
Aplica-se a
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
Chamada pelos servidores para autenticar o servidor e, opcionalmente, o cliente numa ligação cliente-servidor usando os certificados, requisitos e protocolo de segurança especificados como uma operação assí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 que especifica Boolean se o cliente é solicitado a um certificado para autenticação. Note que isto é apenas um pedido — se não for fornecido um certificado, o servidor ainda aceita o pedido de ligação.
- checkCertificateRevocation
- Boolean
Um Boolean valor que especifica se a lista de revogação de certificados está verificada durante a autenticação.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
serverCertificate é null.
A autenticação falhou e deixou este objeto num estado inutilizável.
A autenticação já ocorreu.
-ou-
A autenticação do cliente usando isto SslStream já foi tentada anteriormente.
-ou-
A autenticação já está em curso.
Este objeto foi encerrado.
Observações
A partir do .NET Framework 4.7, este método autentica usando None, que permite ao sistema operativo escolher o melhor protocolo a usar e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .NET Framework 4.5 com os últimos patches de segurança instalados), as versões permitidas dos protocolos TLS/SSL são 1.2, 1.1 e 1.0 (a menos que desative a criptografia forte editando o Registo do Windows).
Se a autenticação falhar, recebe um AuthenticationException, e este SslStream deixa de ser utilizável. Deves fechar este objeto e remover todas as referências a ele para que possa ser recolhido pelo coletor de lixo.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsServer(X509Certificate, Boolean, Boolean).
Aplica-se a
AuthenticateAsServerAsync(X509Certificate)
Chamada pelos servidores para autenticar o servidor e, opcionalmente, o cliente numa ligaçã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.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
serverCertificate é null.
A autenticação falhou e deixou este objeto num estado inutilizável.
A autenticação já ocorreu.
-ou-
A autenticação do cliente usando isto SslStream já foi tentada anteriormente.
-ou-
A autenticação já está em curso.
Este objeto foi encerrado.
O método AuthenticateAsServerAsync não é suportado em Windows 95, Windows 98 ou Windows Millennium.
Observações
A partir do .NET Framework 4.7, este método autentica usando None, que permite ao sistema operativo escolher o melhor protocolo a usar e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .NET Framework 4.5 com os últimos patches de segurança instalados), as versões permitidas dos protocolos TLS/SSL são 1.2, 1.1 e 1.0 (a menos que desative a criptografia forte editando o Registo do Windows).
Este método autentica usando Default. A lista de revogação de certificados não é verificada durante a autenticação. O cliente não é obrigado a fornecer um certificado para autenticação.
Se a autenticação falhar, recebe um AuthenticationException, e este SslStream deixa de ser utilizável. Deves fechar este objeto e remover todas as referências a ele para que possa ser recolhido pelo coletor de lixo.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsServer(X509Certificate).
Aplica-se a
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
Autentica o servidor e, opcionalmente, o cliente numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza as informações especificadas no saco sslServerAuthenticationOptions de propriedades.
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);member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As TaskParâmetros
- sslServerAuthenticationOptions
- SslServerAuthenticationOptions
O saco de propriedade para a ligação SSL.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
Ou ServerCertificateSelectionCallback ou ServerCertificateContextServerCertificate é null e LocalCertificateSelectionCallback não está definido no SslStream construtor.
sslServerAuthenticationOptions é null.
A autenticação falhou e deixou este objeto num estado inutilizável.
A autenticação já ocorreu.
-ou-
A autenticação do cliente usando isto SslStream já foi tentada anteriormente.
-ou-
A autenticação já está em curso.
Este objeto foi encerrado.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Se a autenticação falhar, recebe um AuthenticationException, e este SslStream deixa de ser utilizável. Deves fechar este objeto e remover todas as referências a ele para que possa ser recolhido pelo coletor de lixo.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsServer(SslServerAuthenticationOptions).