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í.
Lo llaman los servidores con el fin de autenticar el servidor, y opcionalmente el cliente, en una conexión cliente-servidor como una operación asincrónica.
Sobrecargas
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Los llaman los servidores para autenticar el servidor y, opcionalmente, el cliente en una conexión cliente/servidor mediante los certificados, los requisitos y el protocolo de seguridad especificados como una operación asincrónica. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Los llaman los servidores para autenticar el servidor y, opcionalmente, el cliente en una conexión cliente/servidor mediante los certificados, los requisitos y el protocolo de seguridad especificados como una operación asincrónica. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Lo llaman los servidores con el fin de autenticar el servidor, y opcionalmente el cliente, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación usa información especificada en el contenedor de propiedades |
| AuthenticateAsServerAsync(X509Certificate) |
Lo llaman los servidores para autenticar el servidor, y opcionalmente el cliente, en una conexión cliente-servidor utilizando el certificado especificado como una operación asincrónica. |
| AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken) |
Lo llaman los servidores con el fin de autenticar el servidor, y opcionalmente el cliente, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación usa la información devuelta por |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Los llaman los servidores para autenticar el servidor y, opcionalmente, el cliente en una conexión cliente/servidor mediante los certificados, los requisitos y el 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 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.
Devoluciones
Objeto de tarea que representa 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.
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).
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.
Este método almacena en la tarea que devuelve todas las excepciones que no son de 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, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).
Se aplica a
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Los llaman los servidores para autenticar el servidor y, opcionalmente, el cliente en una conexión cliente/servidor mediante los certificados, los requisitos y el 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 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.
Devoluciones
Objeto de tarea que representa 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.
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).
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.
Este método almacena en la tarea que devuelve todas las excepciones que no son de 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, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por AuthenticateAsServer(X509Certificate, Boolean, Boolean).
Se aplica a
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Lo llaman los servidores con el fin de autenticar el servidor, y opcionalmente el cliente, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación usa información especificada en el contenedor de propiedades sslClientAuthenticationOptions.
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 = default);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, Optional cancellationToken As CancellationToken = Nothing) As 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 para supervisar solicitudes de cancelación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
ServerCertificateSelectionCallback o ServerCertificate o ServerCertificateContext es null y LocalCertificateSelectionCallback no está establecido en el constructor SslStream.
sslServerAuthenticationOptions 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.
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 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.
Este método almacena en la tarea que devuelve todas las excepciones que no son de 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, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por AuthenticateAsServer(SslServerAuthenticationOptions).
Se aplica a
AuthenticateAsServerAsync(X509Certificate)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Lo llaman los servidores para autenticar el servidor, y opcionalmente el cliente, en una conexión cliente-servidor utilizando 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 utilizado para autenticar el servidor.
Devoluciones
Objeto de tarea que representa 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 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, 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).
Este método se autentica mediante Default. 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.
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.
Este método almacena en la tarea que devuelve todas las excepciones que no son de 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, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por AuthenticateAsServer(X509Certificate).
Se aplica a
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Lo llaman los servidores con el fin de autenticar el servidor, y opcionalmente el cliente, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación usa la información devuelta por optionsCallback.
public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.ServerOptionsSelectionCallback optionsCallback, object? state, System.Threading.CancellationToken cancellationToken = default);member this.AuthenticateAsServerAsync : System.Net.Security.ServerOptionsSelectionCallback * obj * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- optionsCallback
- ServerOptionsSelectionCallback
El delegado de devolución de llamada.
- state
- Object
El objeto de estado que se va a pasar a optionsCallback cuando se invoque la devolución de llamada.
- cancellationToken
- CancellationToken
Token para supervisar solicitudes de cancelación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
ServerCertificateSelectionCallback o ServerCertificate o ServerCertificateContext es null y LocalCertificateSelectionCallback no está establecido en el constructor SslStream.
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.
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 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
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