SslStream.BeginAuthenticateAsClient Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicia una operación para autenticar el lado cliente de una conexión de cliente-servidor.
Sobrecargas
| Nombre | Description |
|---|---|
| BeginAuthenticateAsClient(String, AsyncCallback, Object) |
Llamado por los clientes para iniciar una operación asincrónica para autenticar el servidor y, opcionalmente, el cliente. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object) |
Llamado por los clientes para iniciar una operación asincrónica para autenticar el servidor y, opcionalmente, el cliente con los certificados especificados y el protocolo de seguridad predeterminado del sistema. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object) |
Llamado por los clientes para iniciar una operación asincrónica para autenticar el servidor y, opcionalmente, el cliente mediante los certificados 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
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Llamado por los clientes para iniciar una operación asincrónica para 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 -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParámetros
- asyncCallback
- AsyncCallback
AsyncCallback Delegado que hace referencia al método que se va a invocar cuando se completa la autenticación.
- asyncState
- Object
Objeto definido por el usuario que contiene información sobre la operación. Este objeto se pasa al asyncCallback delegado cuando se completa la operación.
Devoluciones
Objeto IAsyncResult que indica el estado de la operación asincrónica.
Excepciones
targetHost es null.
Error en la autenticación y se dejó este objeto en un estado inutilizable.
Ya se ha producido la autenticación.
O bien
La autenticación del servidor con esto SslStream se intentó anteriormente.
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, lo que permite al sistema operativo elegir el mejor protocolo que usar y bloquear protocolos que no son seguros. En .NET Framework 4.6 (y .NET Framework 4.5 con las revisiones de seguridad más recientes instaladas), las versiones de protocolos TLS/SSL permitidas son 1.2, 1.1 y 1.0 (a menos que deshabilite la criptografía segura editando el Registro de Windows). 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 en el 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 el uso del modelo de programación asincrónica, vea Llamar a métodos sincrónicos de forma asincrónica.
Si recibe un AuthenticationException, SslStream ya no se puede usar. Debe cerrar este objeto y quitar todas las referencias a él para que el recolector de elementos no utilizados pueda recopilarlo.
Se aplica a
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Llamado por los clientes para iniciar una operación asincrónica para autenticar el servidor y, opcionalmente, el cliente con 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 -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParámetros
- clientCertificates
- X509CertificateCollection
Que X509CertificateCollection contiene los certificados de cliente.
- checkCertificateRevocation
- Boolean
Valor Boolean que especifica si la lista de revocación de certificados se comprueba durante la autenticación.
- asyncCallback
- AsyncCallback
AsyncCallback Delegado que hace referencia al método que se va a invocar cuando se completa la autenticación.
- asyncState
- Object
Objeto definido por el usuario que contiene información sobre la operación. Este objeto se pasa al asyncCallback delegado cuando se completa la operación.
Devoluciones
Objeto IAsyncResult que indica el estado de la operación asincrónica.
Excepciones
targetHost es null.
Error en la autenticación y se dejó este objeto en un estado inutilizable.
Ya se ha producido la autenticación.
O bien
La autenticación del servidor con esto SslStream se intentó anteriormente.
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, lo que permite al sistema operativo elegir el mejor protocolo que usar y bloquear protocolos que no son seguros. En .NET Framework 4.6 (y .NET Framework 4.5 con las revisiones de seguridad más recientes instaladas), las versiones de protocolos TLS/SSL permitidas son 1.2, 1.1 y 1.0 (a menos que deshabilite la criptografía segura editando el Registro de Windows).
El valor especificado para targetHost debe coincidir con el nombre en el 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 el uso del modelo de programación asincrónica, vea Llamar a métodos sincrónicos de forma asincrónica.
Si recibe un AuthenticationException, SslStream ya no se puede usar. Debe cerrar este objeto y quitar todas las referencias a él para que el recolector de elementos no utilizados pueda recopilarlo.
Note
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
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Llamado por los clientes para iniciar una operación asincrónica para autenticar el servidor y, opcionalmente, el cliente mediante los certificados 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 -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParámetros
- clientCertificates
- X509CertificateCollection
Que X509CertificateCollection contiene los certificados de cliente.
- enabledSslProtocols
- SslProtocols
Valor SslProtocols que representa los protocolos usados para la autenticación.
- checkCertificateRevocation
- Boolean
Valor Boolean que especifica si la lista de revocación de certificados se comprueba durante la autenticación.
- asyncCallback
- AsyncCallback
AsyncCallback Delegado que hace referencia al método que se va a invocar cuando se completa la autenticación.
- asyncState
- Object
Objeto definido por el usuario que contiene información sobre la operación. Este objeto se pasa al asyncCallback delegado cuando se completa la operación.
Devoluciones
Objeto IAsyncResult que indica el estado de la operación asincrónica.
Excepciones
targetHost es null.
enabledSslProtocols no es un valor válido SslProtocols .
Error en la autenticación y se dejó este objeto en un estado inutilizable.
Ya se ha producido la autenticación.
O bien
La autenticación del servidor con esto SslStream se intentó anteriormente.
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, lo que permite al sistema operativo elegir el mejor protocolo que usar y bloquear protocolos que no son seguros. En .NET Framework 4.6 (y .NET Framework 4.5 con las revisiones de seguridad más recientes instaladas), las versiones de protocolos TLS/SSL permitidas son 1.2, 1.1 y 1.0 (a menos que deshabilite la criptografía segura editando el Registro de Windows).
El valor especificado para targetHost debe coincidir con el nombre en el 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 el uso del modelo de programación asincrónica, vea Llamar a métodos sincrónicos de forma asincrónica.
Si recibe un AuthenticationException, SslStream ya no se puede usar. Debe cerrar este objeto y quitar todas las referencias a él para que el recolector de elementos no utilizados pueda recopilarlo.
Note
Los certificados de cliente no se admiten en el protocolo SSL versión 2.
