Compartir a través de


SslStream.BeginAuthenticateAsClient Método

Definición

Comienza una operación para autenticar el cliente de una conexión cliente-servidor.

Sobrecargas

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Lo llaman clientes para empezar una operación asincrónica con el fin de autenticar el servidor y opcionalmente el cliente.

BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)

Los llaman los servidores para comenzar una operación asincrónica con el fin de autenticar el servidor y, opcionalmente, el cliente mediante los certificados especificados y el protocolo de seguridad predeterminado del sistema.

BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)

Lo llaman los clientes para empezar una operación asincrónica con el fin de autenticar el servidor y, opcionalmente el cliente, mediante los certificados, los requisitos y el protocolo de seguridad especificados.

Comentarios

Las sobrecargas de este método no se bloquean mientras la autenticación está en curso. Para bloquear mientras espera a que se complete la autenticación, use uno de los AuthenticateAsClient métodos .

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Source:
SslStream.cs
Source:
SslStream.cs
Source:
SslStream.cs

Lo llaman clientes para empezar una operación asincrónica con el fin de autenticar el servidor y opcionalmente el cliente.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parámetros

targetHost
String

El nombre del servidor que comparte esta clase SslStream.

asyncCallback
AsyncCallback

Delegado de AsyncCallback que hace referencia al método que se invocará cuando la autenticación se complete.

asyncState
Object

Objeto definido por el usuario que contiene información sobre la operación. Este objeto se pasa al delegado de asyncCallback cuando la operación ha terminado.

Devoluciones

Un objeto IAsyncResult que indica el estado de la operación asincrónica.

Excepciones

targetHost es null.

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

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.

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.

La operación de autenticación asincrónica debe completarse llamando al EndAuthenticateAsClient método . Normalmente, el delegado invoca el asyncCallback método .

Este método no se bloquea mientras se completa la operación. Para bloquear hasta que se complete la operación, use una de las sobrecargas del AuthenticateAsClient método .

Para obtener información detallada sobre cómo usar el modelo de programación asincrónica, vea Llamar a métodos sincrónicos de forma asincrónica.

Si recibe un AuthenticationException, 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.

Se aplica a

BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)

Source:
SslStream.cs
Source:
SslStream.cs
Source:
SslStream.cs

Los llaman los servidores para comenzar una operación asincrónica con el fin de autenticar el servidor y, opcionalmente, el cliente mediante los certificados especificados y el protocolo de seguridad predeterminado del sistema.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parámetros

targetHost
String

El nombre del servidor que comparte 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.

asyncCallback
AsyncCallback

Delegado de AsyncCallback que hace referencia al método que se invocará cuando la autenticación se complete.

asyncState
Object

Objeto definido por el usuario que contiene información sobre la operación. Este objeto se pasa al delegado de asyncCallback cuando la operación ha terminado.

Devoluciones

Un objeto IAsyncResult que indica el estado de la operación asincrónica.

Excepciones

targetHost es null.

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

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.

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

El valor especificado para targetHost debe coincidir con el nombre del certificado del servidor.

La operación de autenticación asincrónica debe completarse llamando al EndAuthenticateAsClient método . Normalmente, el delegado invoca el asyncCallback método .

Este método no se bloquea mientras se completa la operación. Para bloquear hasta que se complete la operación, use una de las sobrecargas del AuthenticateAsClient método .

Para obtener información detallada sobre cómo usar el modelo de programación asincrónica, vea Llamar a métodos sincrónicos de forma asincrónica.

Si recibe un AuthenticationException, 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.

Se aplica a

BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)

Source:
SslStream.cs
Source:
SslStream.cs
Source:
SslStream.cs

Lo llaman los clientes para empezar una operación asincrónica con el fin de autenticar el servidor y, opcionalmente el cliente, mediante los certificados, los requisitos y el protocolo de seguridad especificados.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parámetros

targetHost
String

El nombre del servidor que comparte 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.

asyncCallback
AsyncCallback

Delegado de AsyncCallback que hace referencia al método que se invocará cuando la autenticación se complete.

asyncState
Object

Objeto definido por el usuario que contiene información sobre la operación. Este objeto se pasa al delegado de asyncCallback cuando la operación ha terminado.

Devoluciones

Un objeto IAsyncResult que indica el estado de la operación asincrónica.

Excepciones

targetHost es null.

enabledSslProtocols no es un valor SslProtocols válido.

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

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.

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

El valor especificado para targetHost debe coincidir con el nombre del certificado del servidor.

La operación de autenticación asincrónica debe completarse llamando al EndAuthenticateAsClient método . Normalmente, el delegado invoca el asyncCallback método .

Este método no se bloquea mientras se completa la operación. Para bloquear hasta que se complete la operación, use una de las sobrecargas del AuthenticateAsClient método .

Para obtener información detallada sobre cómo usar el modelo de programación asincrónica, vea Llamar a métodos sincrónicos de forma asincrónica.

Si recibe un AuthenticationException, 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.

Se aplica a