SslStream.BeginAuthenticateAsServer 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.
Inicia-se uma operação assíncrona para tratar do lado servidor da autenticação de uma ligação cliente-servidor.
Sobrecargas
| Name | Description |
|---|---|
| BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object) |
Chamado pelos servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor numa ligação cliente-servidor. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object) |
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do servidor e, opcionalmente, do cliente, usando os certificados e requisitos especificados, bem como o protocolo de segurança predefinido do sistema. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object) |
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do servidor e, opcionalmente, do cliente, usando os certificados, requisitos e protocolo de segurança especificados. |
Observações
As sobrecargas deste método não bloqueiam enquanto a autenticação está em curso. Para bloquear enquanto espera que a autenticação seja concluída, use um dos AuthenticateAsServer métodos.
BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
Chamado pelos servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor numa ligaçã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 -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParâmetros
- serverCertificate
- X509Certificate
O X509Certificate usado para autenticar o servidor.
- asyncCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a invocar quando a autenticação estiver concluída.
- asyncState
- Object
Um objeto definido pelo utilizador que contém informação sobre a operação. Este objeto é passado para o asyncCallback delegado quando a operação termina.
Devoluções
Um objeto que IAsyncResult indica o estado da 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 BeginAuthenticateAsServer 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). 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.
A operação de autenticação assíncrona deve ser realizada chamando o EndAuthenticateAsClient método. Normalmente, o método é invocado pelo asyncCallback delegado.
Este método não bloqueia enquanto a operação está concluída. Para bloquear até a operação terminar, use uma das AuthenticateAsClient sobrecargas de métodos.
Para informações detalhadas sobre a utilização do modelo de programação assíncrona, veja Chamar Métodos Síncronos Assíncronos
Se receber um AuthenticationException, isto 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.
Aplica-se a
BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do servidor e, opcionalmente, do cliente, usando os certificados e requisitos especificados, bem como o protocolo de segurança predefinido do sistema.
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 -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParâ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.
- asyncCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a invocar quando a autenticação estiver concluída.
- asyncState
- Object
Um objeto definido pelo utilizador que contém informação sobre a operação. Este objeto é passado para o asyncCallback delegado quando a operação termina.
Devoluções
Um IAsyncResult objeto que indica o estado da 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 servidor usando isto SslStream foi tentada anteriormente.
-ou-
A autenticação já está em curso.
Este objeto foi encerrado.
O método BeginAuthenticateAsServer 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).
A operação de autenticação assíncrona deve ser realizada chamando o EndAuthenticateAsServer método. Normalmente, o método é invocado pelo asyncCallback delegado.
Este método não bloqueia enquanto a operação está concluída. Para bloquear até a operação terminar, use uma das AuthenticateAsServer sobrecargas de métodos.
Para informações detalhadas sobre a utilização do modelo de programação assíncrona, veja Chamar Métodos Síncronos Assíncronos
Se receber um AuthenticationException, isto 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.
Aplica-se a
BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
- Origem:
- SslStream.cs
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do servidor e, opcionalmente, do 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 -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParâ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.
- asyncCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a invocar quando a autenticação estiver concluída.
- asyncState
- Object
Um objeto definido pelo utilizador que contém informação sobre a operação. Este objeto é passado para o asyncCallback delegado quando a operação termina.
Devoluções
Um IAsyncResult objeto que indica o estado da operação assíncrona.
Exceções
serverCertificate é null.
enabledSslProtocols não é um valor válido SslProtocols .
A autenticação falhou e deixou este objeto num estado inutilizável.
A autenticação já ocorreu.
-ou-
A autenticação do servidor usando isto SslStream foi tentada anteriormente.
-ou-
A autenticação já está em curso.
Este objeto foi encerrado.
O método BeginAuthenticateAsServer 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).
A operação de autenticação assíncrona deve ser realizada chamando o EndAuthenticateAsServer método. Normalmente, o método é invocado pelo asyncCallback delegado.
Este método não bloqueia enquanto a operação está concluída. Para bloquear até a operação terminar, use uma das AuthenticateAsServer sobrecargas de métodos.
Para informações detalhadas sobre a utilização do modelo de programação assíncrona, veja Chamar Métodos Síncronos Assíncronos
Se receber um AuthenticationException, isto 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.
