SslStream.AuthenticateAsServer 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.
Sobrecargas
| Nome | Description |
|---|---|
| AuthenticateAsServer(X509Certificate) |
Chamado por servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando o certificado especificado. |
| AuthenticateAsServer(X509Certificate, Boolean, Boolean) |
Chamado por servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando os certificados e requisitos especificados e usando o protocolo de segurança padrão do sistema. |
| AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean) |
Chamado por servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando os certificados, requisitos e protocolo de segurança especificados. |
AuthenticateAsServer(X509Certificate)
Chamado por servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando o certificado especificado.
public:
virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);public virtual void AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unitPublic Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate)Parâmetros
- serverCertificate
- X509Certificate
O certificado usado para autenticar o servidor.
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 do cliente usando isso SslStream foi tentada anteriormente.
-ou-
A autenticação já está em andamento.
Este objeto foi fechado.
O método AuthenticateAsServer não tem suporte no Windows 95, Windows 98 ou Windows Millennium.
Comentários
A partir do .NET Framework 4.7, esse método é autenticado usando None, o que permite ao sistema operacional escolher o melhor protocolo a ser usado e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .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 que você desabilite criptografia forte editando 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.
Esse método é bloqueado até que a operação seja concluída. Para evitar o bloqueio até que a operação seja concluída, use uma das sobrecargas do BeginAuthenticateAsServer método.
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
AuthenticateAsServer(X509Certificate, Boolean, Boolean)
Chamado por servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando os certificados e requisitos especificados e usando o protocolo de segurança padrão do sistema.
public:
virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);public virtual void AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unitPublic Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean)Parâmetros
- serverCertificate
- X509Certificate
O X509Certificate usado para autenticar o servidor.
- clientCertificateRequired
- Boolean
Um Boolean valor que especifica se o cliente é solicitado a obter um certificado para autenticação. Observe que essa é apenas uma solicitação : se nenhum certificado for fornecido, o servidor ainda aceitará a solicitação de conexão.
- checkCertificateRevocation
- Boolean
Um Boolean valor que especifica se a lista de revogação de certificados é verificada durante a autenticação.
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 do cliente usando isso SslStream foi tentada anteriormente.
-ou-
A autenticação já está em andamento.
Este objeto foi fechado.
O método AuthenticateAsServer não tem suporte no Windows 95, Windows 98 ou Windows Millennium.
Comentários
A partir do .NET Framework 4.7, esse método é autenticado usando None, o que permite ao sistema operacional escolher o melhor protocolo a ser usado e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .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 que você desabilite criptografia forte editando o Registro do Windows).
Esse método é bloqueado até que a operação seja concluída. Para evitar o bloqueio até que a operação seja concluída, use uma das sobrecargas do BeginAuthenticateAsServer método.
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
AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)
Chamado por servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando os certificados, requisitos e protocolo de segurança especificados.
public:
virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);public virtual void AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unitPublic Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)Parâmetros
- serverCertificate
- X509Certificate
O X509Certificate usado para autenticar o servidor.
- clientCertificateRequired
- Boolean
Um Boolean valor que especifica se o cliente é solicitado a obter um certificado para autenticação. Observe que essa é apenas uma solicitação : se nenhum certificado for fornecido, o servidor ainda aceitará a solicitação de conexão.
- enabledSslProtocols
- SslProtocols
O SslProtocols valor que representa os protocolos usados para autenticação.
- checkCertificateRevocation
- Boolean
Um Boolean valor que especifica se a lista de revogação de certificados é verificada durante a autenticação.
Exceções
serverCertificate é null.
enabledSslProtocols não é um valor válido SslProtocols .
A autenticação falhou e deixou esse objeto em um estado inutilizável.
A autenticação já ocorreu.
-ou-
A autenticação do cliente usando isso SslStream foi tentada anteriormente.
-ou-
A autenticação já está em andamento.
Este objeto foi fechado.
O método AuthenticateAsServer não tem suporte no Windows 95, Windows 98 ou Windows Millennium.
Comentários
A partir do .NET Framework 4.7, esse método é autenticado usando None, o que permite ao sistema operacional escolher o melhor protocolo a ser usado e bloquear protocolos que não são seguros. No .NET Framework 4.6 (e no .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 que você desabilite criptografia forte editando o Registro do Windows).
Esse método é bloqueado até que a operação seja concluída. Para evitar o bloqueio até que a operação seja concluída, use uma das sobrecargas do BeginAuthenticateAsServer método.
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.