SslStream.BeginAuthenticateAsServer 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í.
Comienza una operación asincrónica para controlar la autenticación del servidor de una conexión cliente-servidor.
Sobrecargas
| BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object) |
Lo llaman los servidores para comenzar una operación asincrónica con el fin de autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, 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 y requisitos especificados, además del protocolo de seguridad predeterminado del sistema. |
| BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, 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, requisitos y protocolo de seguridad especificados. |
Comentarios
Las sobrecargas de este método no bloquean mientras la autenticación está en curso. Para bloquear mientras espera a que se complete la autenticación, use uno de los AuthenticateAsServer métodos .
BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Lo llaman los servidores para comenzar una operación asincrónica con el fin de autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParámetros
- serverCertificate
- X509Certificate
X509Certificate utilizado para autenticar el servidor.
- 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
Objeto IAsyncResult que indica el estado de la operación asincrónica.
Excepciones
serverCertificate 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 cliente con esta SslStream se intentó con anterioridad.
o bien
La autenticación ya está en curso.
Este objeto se ha cerrado.
El método BeginAuthenticateAsServer no se admite en Windows 95, Windows 98 o Windows Millennium.
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). La lista de revocación de certificados no se comprueba durante la autenticación. El cliente no es necesario para proporcionar un certificado para la autenticación.
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 finalice 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 recopilarla.
Se aplica a
BeginAuthenticateAsServer(X509Certificate, Boolean, 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 y requisitos especificados, además del protocolo de seguridad predeterminado del sistema.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParámetros
- serverCertificate
- X509Certificate
X509Certificate utilizado para autenticar el servidor.
- clientCertificateRequired
- Boolean
Valor Boolean que especifica si se le pide al cliente un certificado para la autenticación. Tenga en cuenta que esto es solo una solicitud; si no se proporciona ningún certificado, el servidor todavía acepta la solicitud de conexió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
serverCertificate 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.
El método BeginAuthenticateAsServer no se admite en Windows 95, Windows 98 o Windows Millennium.
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).
La operación de autenticación asincrónica debe completarse llamando al EndAuthenticateAsServer 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 finalice la operación, use una de las sobrecargas del AuthenticateAsServer 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 recopilarla.
Se aplica a
BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, 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, requisitos y protocolo de seguridad especificados.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParámetros
- serverCertificate
- X509Certificate
X509Certificate utilizado para autenticar el servidor.
- clientCertificateRequired
- Boolean
Valor Boolean que especifica si se le pide al cliente un certificado para la autenticación. Tenga en cuenta que esto es solo una solicitud; si no se proporciona ningún certificado, el servidor todavía acepta la solicitud de conexión.
- 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
serverCertificate 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.
El método BeginAuthenticateAsServer no se admite en Windows 95, Windows 98 o Windows Millennium.
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).
La operación de autenticación asincrónica debe completarse llamando al EndAuthenticateAsServer 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 finalice la operación, use una de las sobrecargas del AuthenticateAsServer 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 recopilarla.
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de