SslStream.AuthenticateAsServerAsync 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í.
Llamado por los servidores para autenticar el servidor y, opcionalmente, el cliente en una conexión cliente-servidor como una operación asincrónica.
Sobrecargas
| Nombre | Description |
|---|---|
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Llamado por los servidores para autenticar el servidor y, opcionalmente, el cliente en una conexión de cliente-servidor mediante los certificados, requisitos y protocolo de seguridad especificados como una operación asincrónica. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Llamado por los servidores para autenticar el servidor y, opcionalmente, el cliente en una conexión de cliente-servidor mediante los certificados, requisitos y protocolo de seguridad especificados como una operación asincrónica. |
| AuthenticateAsServerAsync(X509Certificate) |
Llamado por los servidores para autenticar el servidor y, opcionalmente, el cliente en una conexión cliente-servidor mediante el certificado especificado como una operación asincrónica. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Autentica el servidor y, opcionalmente, el cliente en una conexión de cliente-servidor como una operación asincrónica. El proceso de autenticación usa información especificada en el contenedor de |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
Llamado por los servidores para autenticar el servidor y, opcionalmente, el cliente en una conexión de cliente-servidor mediante los certificados, requisitos y protocolo de seguridad especificados como una operación asincrónica.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParámetros
- serverCertificate
- X509Certificate
X509Certificate usado para autenticar el servidor.
- clientCertificateRequired
- Boolean
Valor Boolean que especifica si se solicita 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 sigue aceptando la solicitud de conexión.
- 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.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
serverCertificate 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 de cliente 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).
Si se produce un error en la autenticación, recibirá un AuthenticationExceptiony 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.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).
Se aplica a
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
Llamado por los servidores para autenticar el servidor y, opcionalmente, el cliente en una conexión de cliente-servidor mediante los certificados, requisitos y protocolo de seguridad especificados como una operación asincrónica.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As TaskParámetros
- serverCertificate
- X509Certificate
X509Certificate usado para autenticar el servidor.
- clientCertificateRequired
- Boolean
Valor Boolean que especifica si se solicita 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 sigue aceptando la solicitud de conexión.
- checkCertificateRevocation
- Boolean
Valor Boolean que especifica si la lista de revocación de certificados se comprueba durante la autenticación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
serverCertificate 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 de cliente 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).
Si se produce un error en la autenticación, recibirá un AuthenticationExceptiony 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.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por AuthenticateAsServer(X509Certificate, Boolean, Boolean).
Se aplica a
AuthenticateAsServerAsync(X509Certificate)
Llamado por los servidores para autenticar el servidor y, opcionalmente, el cliente en una conexión cliente-servidor mediante el certificado especificado como una operación asincrónica.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As TaskParámetros
- serverCertificate
- X509Certificate
Certificado que se usa para autenticar el servidor.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
serverCertificate 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 de cliente con esto SslStream se intentó anteriormente.
O bien
La autenticación ya está en curso.
Este objeto se ha cerrado.
El método AuthenticateAsServerAsync 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, 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).
Este método se autentica mediante Default. La lista de revocación de certificados no se comprueba durante la autenticación. No es necesario que el cliente proporcione un certificado para la autenticación.
Si se produce un error en la autenticación, recibirá un AuthenticationExceptiony 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.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por AuthenticateAsServer(X509Certificate).
Se aplica a
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
Autentica el servidor y, opcionalmente, el cliente en una conexión de cliente-servidor como una operación asincrónica. El proceso de autenticación usa información especificada en el contenedor de sslServerAuthenticationOptions propiedades.
public:
System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken);member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As TaskParámetros
- sslServerAuthenticationOptions
- SslServerAuthenticationOptions
Contenedor de propiedades para la conexión SSL.
- cancellationToken
- CancellationToken
Token que se va a supervisar para las solicitudes de cancelación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
O ServerCertificateSelectionCallback o ServerCertificateServerCertificateContext es null y LocalCertificateSelectionCallback no está establecido en el SslStream constructor.
sslServerAuthenticationOptions 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 de cliente con esto SslStream se intentó anteriormente.
O bien
La autenticación ya está en curso.
Este objeto se ha cerrado.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Si se produce un error en la autenticación, recibirá un AuthenticationExceptiony 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.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por AuthenticateAsServer(SslServerAuthenticationOptions).