SslStream.AuthenticateAsClient Método

Definición

Espacio de nombres:

System.Net.Security

Ensamblado:

System.Net.Security.dll

Ensamblado:

System.dll

Ensamblado:

netstandard.dll

Autentique el cliente de una conexión cliente-servidor.

Sobrecargas

AuthenticateAsClient(SslClientAuthenticationOptions)	Lo llaman los clientes para autenticar el servidor y, de forma opcional, el cliente en una conexión cliente-servidor.
AuthenticateAsClient(String)	Lo llaman los clientes para autenticar el servidor y, de forma opcional, el cliente en una conexión cliente-servidor.
AuthenticateAsClient(String, X509CertificateCollection, Boolean)	Lo llaman los clientes para autenticar el servidor y, de forma opcional, el cliente en una conexión cliente-servidor. El proceso de autenticación usa la colección de certificados especificada y el protocolo SSL predeterminado del sistema.
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)	Lo llaman los clientes para autenticar el servidor y, de forma opcional, el cliente en una conexión cliente-servidor. El proceso de autenticación utiliza la colección de certificados especificada y el protocolo SSL.

AuthenticateAsClient(SslClientAuthenticationOptions)

Lo llaman los clientes para autenticar el servidor y, de forma opcional, el cliente en una conexión 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

Contenedor de propiedades para la conexión SSL.

Excepciones

ArgumentNullException

targetHost es null.

AuthenticationException

No se pudo realizar la autenticación y este objeto queda en un estado no utilizable.

InvalidOperationException

Ya se ha producido la autenticación.

O bien

La autenticación de servidor con esta SslStream se intentó con anterioridad.

O bien

La autenticación ya está en curso.

ObjectDisposedException

Este objeto se ha cerrado.

Comentarios

A partir de .NET Framework 4.7, este método se autentica mediante None, que permite al sistema operativo elegir el mejor protocolo para usar y bloquear los protocolos que no sean seguros. En .NET Framework 4.6 (y .NET Framework 4.5 con las revisiones de seguridad más recientes instaladas), las versiones de los protocolos TLS/SSL permitidas son 1.0, 1.1 y 1.2 (a menos que edite el Registro de Windows para deshabilitar la criptografía robusta). No se usan certificados de cliente en la autenticación. La lista de revocación de certificados no se comprueba durante la autenticación. El valor especificado para targetHost debe coincidir con el nombre del certificado del servidor.

Cuando la autenticación se realiza correctamente, debe comprobar las IsEncrypted propiedades y IsSigned para determinar qué servicios de seguridad usan .SslStream Compruebe la IsMutuallyAuthenticated propiedad para determinar si se ha producido la autenticación mutua.

Si se produce un error en la autenticación, recibirá un AuthenticationExceptiony ya SslStream no se puede usar. Debe cerrar este objeto y quitar todas las referencias a él para que el recolector de elementos no utilizados pueda recopilarla.

AuthenticateAsClient(String)

Lo llaman los clientes para autenticar el servidor y, de forma opcional, el cliente en una conexión 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

El nombre del servidor que comparte esta clase SslStream.

Excepciones

ArgumentNullException

targetHost es null.

AuthenticationException

No se pudo realizar la autenticación y este objeto queda en un estado no utilizable.

InvalidOperationException

Ya se ha producido la autenticación.

O bien La autenticación de servidor con esta SslStream se intentó con anterioridad.

O bien La autenticación ya está en curso.

ObjectDisposedException

Este objeto se ha cerrado.

Comentarios

A partir de .NET Framework 4.7, este método se autentica mediante None, que permite al sistema operativo elegir el mejor protocolo para usar y bloquear los protocolos que no sean seguros. En .NET Framework 4.6 (y .NET Framework 4.5 con las revisiones de seguridad más recientes instaladas), las versiones de los protocolos TLS/SSL permitidas son 1.0, 1.1 y 1.2 (a menos que edite el Registro de Windows para deshabilitar la criptografía robusta). No se usan certificados de cliente en la autenticación. La lista de revocación de certificados no se comprueba durante la autenticación. El valor especificado para targetHost debe coincidir con el nombre del certificado del servidor.

Cuando la autenticación se realiza correctamente, debe comprobar las IsEncrypted propiedades y IsSigned para determinar qué servicios de seguridad usan .SslStream Compruebe la IsMutuallyAuthenticated propiedad para determinar si se ha producido la autenticación mutua.

Si se produce un error en la autenticación, recibirá un AuthenticationExceptiony ya SslStream no se puede usar. Debe cerrar este objeto y quitar todas las referencias a él para que el recolector de elementos no utilizados pueda recopilarla.

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Lo llaman los clientes para autenticar el servidor y, de forma opcional, el cliente en una conexión cliente-servidor. El proceso de autenticación usa la colección de certificados especificada y el protocolo SSL predeterminado del 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);

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

El nombre del servidor que compartirá esta clase SslStream.

clientCertificates

X509CertificateCollection

La clase X509CertificateCollection que contiene certificados de cliente.

checkCertificateRevocation

Boolean

Valor Boolean que especifica si se comprueba la lista de revocación de certificados durante la autenticación.

Comentarios

A partir de .NET Framework 4.7, este método se autentica mediante None, que permite al sistema operativo elegir el mejor protocolo para usar y bloquear los protocolos que no sean seguros. En .NET Framework 4.6 (y .NET Framework 4.5 con las revisiones de seguridad más recientes instaladas), las versiones de los protocolos TLS/SSL permitidas son 1.0, 1.1 y 1.2 (a menos que edite el Registro de Windows para deshabilitar la criptografía robusta).

Cuando la autenticación se realiza correctamente, debe comprobar las IsEncrypted propiedades y IsSigned para determinar qué servicios de seguridad usan .SslStream Compruebe la IsMutuallyAuthenticated propiedad para determinar si se ha producido la autenticación mutua.

Si se produce un error en la autenticación, recibirá un AuthenticationExceptiony ya SslStream no se puede usar. Debe cerrar este objeto y quitar todas las referencias a él para que el recolector de elementos no utilizados pueda recopilarla.

Nota

Los certificados de cliente no se admiten en el protocolo SSL versión 2.

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Lo llaman los clientes para autenticar el servidor y, de forma opcional, el cliente en una conexión cliente-servidor. El proceso de autenticación utiliza la colección de certificados especificada y el protocolo SSL.

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

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

El nombre del servidor que compartirá esta clase SslStream.

clientCertificates

X509CertificateCollection

La clase X509CertificateCollection que contiene certificados de cliente.

enabledSslProtocols

SslProtocols

Valor SslProtocols que representa el protocolo que se usa para la autenticación.

checkCertificateRevocation

Boolean

Valor Boolean que especifica si se comprueba la lista de revocación de certificados durante la autenticación.

Comentarios

A partir de .NET Framework 4.7, este método se autentica mediante None, que permite al sistema operativo elegir el mejor protocolo para usar y bloquear los protocolos que no sean seguros. En .NET Framework 4.6 (y .NET Framework 4.5 con las revisiones de seguridad más recientes instaladas), las versiones de los protocolos TLS/SSL permitidas son 1.0, 1.1 y 1.2 (a menos que edite el Registro de Windows para deshabilitar la criptografía robusta).

Cuando la autenticación se realiza correctamente, debe comprobar las IsEncrypted propiedades y IsSigned para determinar qué servicios de seguridad usan .SslStream Compruebe la IsMutuallyAuthenticated propiedad para determinar si se ha producido la autenticación mutua.

Si se produce un error en la autenticación, recibirá un AuthenticationExceptiony ya SslStream no se puede usar. Debe cerrar este objeto y quitar todas las referencias a él para que el recolector de elementos no utilizados pueda recopilarla.

Nota

Los certificados de cliente no se admiten en el protocolo SSL versión 2.