SslStream.AuthenticateAsServer Método

Definição

Namespace:

System.Net.Security

Assembly:

System.Net.Security.dll

Chamado por servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor.

Sobrecargas

AuthenticateAsServer(SslServerAuthenticationOptions)	Chamada pelos servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando o certificado especificado.
AuthenticateAsServer(X509Certificate)	Chamada pelos servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando o certificado especificado.
AuthenticateAsServer(X509Certificate, Boolean, Boolean)	Chamado pelos servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando os certificados e requisitos especificados e o protocolo de segurança padrão.
AuthenticateAsServer(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.

AuthenticateAsServer(SslServerAuthenticationOptions)

Origem:

SslStream.cs

Chamada pelos servidores para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor usando o certificado especificado.

public:
 void AuthenticateAsServer(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions);

public void AuthenticateAsServer (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions);

member this.AuthenticateAsServer : System.Net.Security.SslServerAuthenticationOptions -> unit

Public Sub AuthenticateAsServer (sslServerAuthenticationOptions As SslServerAuthenticationOptions)

Parâmetros

sslServerAuthenticationOptions

SslServerAuthenticationOptions

O recipiente de propriedades para a conexão SSL.

Exceções

ArgumentNullException

serverCertificate é null.

AuthenticationException

A autenticação falhou e deixou esse objeto em um estado inutilizável.

InvalidOperationException

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.

ObjectDisposedException

Este objeto foi fechado.

PlatformNotSupportedException

Não há suporte para o método AuthenticateAsServer 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). 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 bloqueia 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.

AuthenticateAsServer(X509Certificate)

Origem:

SslStream.cs

Chamada pelos 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 -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate)

Parâmetros

serverCertificate

X509Certificate

O certificado usado para autenticar o servidor.

Exceções

ArgumentNullException

serverCertificate é null.

AuthenticationException

A autenticação falhou e deixou esse objeto em um estado inutilizável.

InvalidOperationException

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.

ObjectDisposedException

Este objeto foi fechado.

PlatformNotSupportedException

Não há suporte para o método AuthenticateAsServer 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). 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 bloqueia 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.

AuthenticateAsServer(X509Certificate, Boolean, Boolean)

Origem:

SslStream.cs

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

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 -> unit

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

Exceções

ArgumentNullException

serverCertificate é null.

AuthenticationException

A autenticação falhou e deixou esse objeto em um estado inutilizável.

InvalidOperationException

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.

ObjectDisposedException

Este objeto foi fechado.

PlatformNotSupportedException

Não há suporte para o método AuthenticateAsServer 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 bloqueia 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.

AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)

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.

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 -> unit

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

Exceções

ArgumentNullException

serverCertificate é null.

ArgumentException

enabledSslProtocols não é um valor SslProtocols válido.

AuthenticationException

A autenticação falhou e deixou esse objeto em um estado inutilizável.

InvalidOperationException

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.

ObjectDisposedException

Este objeto foi fechado.

PlatformNotSupportedException

Não há suporte para o método AuthenticateAsServer 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 bloqueia 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.