SslStream.AuthenticateAsClient Método

Definição

Namespace:

System.Net.Security

Assemblies:

netstandard.dll, System.Net.Security.dll

Autenticar o lado do cliente de uma conexão cliente-servidor.

Sobrecargas

Nome	Description
AuthenticateAsClient(SslClientAuthenticationOptions)	Autentica o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor.
AuthenticateAsClient(String)	Chamado por clientes para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor.
AuthenticateAsClient(String, X509CertificateCollection, Boolean)	Chamado por clientes para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor. O processo de autenticação usa a coleção de certificados especificada e o protocolo SSL padrão do sistema.
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)	Chamado por clientes para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor. O processo de autenticação usa a coleção de certificados e o protocolo SSL especificados.

AuthenticateAsClient(SslClientAuthenticationOptions)

Origem:

SslStream.cs

Autentica o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor.

public:
 void AuthenticateAsClient(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions);

public void AuthenticateAsClient(System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions);

member this.AuthenticateAsClient : System.Net.Security.SslClientAuthenticationOptions -> unit

Public Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)

Parâmetros

sslClientAuthenticationOptions

SslClientAuthenticationOptions

O recipiente de propriedades para a conexão SSL.

Exceções

ArgumentNullException

sslClientAuthenticationOptions é 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 do servidor usando isso SslStream foi tentada anteriormente.

- ou -

A autenticação já está em andamento.

ObjectDisposedException

Este objeto foi fechado.

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). Nenhum certificado de cliente é usado na autenticação. A lista de revogação de certificados não é verificada durante a autenticação. O valor especificado deve targetHost corresponder ao nome no certificado do servidor.

Quando a autenticação for bem-sucedida, você deverá verificar as IsEncrypted propriedades e IsSigned as propriedades para determinar quais serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se a autenticação mútua ocorreu.

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.

AuthenticateAsClient(String)

Origem:

SslStream.cs

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

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost);

public virtual void AuthenticateAsClient(string targetHost);

abstract member AuthenticateAsClient : string -> unit
override this.AuthenticateAsClient : string -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String)

Parâmetros

targetHost

String

O nome do servidor que compartilha isso SslStream.

Exceções

ArgumentNullException

targetHost é 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 do servidor usando isso SslStream foi tentada anteriormente.

- ou -

A autenticação já está em andamento.

ObjectDisposedException

Este objeto foi fechado.

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). Nenhum certificado de cliente é usado na autenticação. A lista de revogação de certificados não é verificada durante a autenticação. O valor especificado deve targetHost corresponder ao nome no certificado do servidor.

Quando a autenticação for bem-sucedida, você deverá verificar as IsEncrypted propriedades e IsSigned as propriedades para determinar quais serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se a autenticação mútua ocorreu.

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.

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Origem:

SslStream.cs

Chamado por clientes para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor. O processo de autenticação usa a coleção de certificados especificada e o protocolo SSL padrão do sistema.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)

Parâmetros

targetHost

String

O nome do servidor que compartilhará isso SslStream.

clientCertificates

X509CertificateCollection

O X509CertificateCollection que contém certificados de cliente.

checkCertificateRevocation

Boolean

Um Boolean valor que especifica se a lista de revogação de certificados é verificada durante a autenticação.

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

Quando a autenticação for bem-sucedida, você deverá verificar as IsEncrypted propriedades e IsSigned as propriedades para determinar quais serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se a autenticação mútua ocorreu.

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.

Observação

Não há suporte para certificados de cliente no protocolo SSL versão 2.

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Origem:

SslStream.cs

Chamado por clientes para autenticar o servidor e, opcionalmente, o cliente em uma conexão cliente-servidor. O processo de autenticação usa a coleção de certificados e o protocolo SSL especificados.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

Parâmetros

targetHost

String

O nome do servidor que compartilhará isso SslStream.

clientCertificates

X509CertificateCollection

O X509CertificateCollection que contém certificados de cliente.

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.

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

Quando a autenticação for bem-sucedida, você deverá verificar as IsEncrypted propriedades e IsSigned as propriedades para determinar quais serviços de segurança são usados pelo SslStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se a autenticação mútua ocorreu.

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.

Observação

Não há suporte para certificados de cliente no protocolo SSL versão 2.