Compartir vía


SslStream.AuthenticateAsServerAsync Método

Definición

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

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

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.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Pará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.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As Task

Pará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.Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As Task

Pará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

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.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As Task

Pará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.Task
Public Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As Task

Pará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

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