NegotiateStream.AuthenticateAsClientAsync Método

Definición

Espacio de nombres:

System.Net.Security

Ensamblado:

System.Net.Security.dll

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor como una operación asincrónica.

Sobrecargas

AuthenticateAsClientAsync()	Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor como una operación asincrónica.
AuthenticateAsClientAsync(NetworkCredential, String)	Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación utiliza las credenciales de cliente especificadas.
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)	Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación utiliza las credenciales de cliente y el enlace de canal especificados.
AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)	Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación utiliza las credenciales y las opciones de autenticación especificadas.
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)	Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación utiliza las credenciales, las opciones de autenticación y el enlace de canal especificados.

AuthenticateAsClientAsync()

Source:

NegotiateStream.cs

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor como una operación asincrónica.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync();

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync ();

abstract member AuthenticateAsClientAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : unit -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync () As Task

Devoluciones

Task

Objeto de tarea que representa la operación asincrónica.

Excepciones

AuthenticationException

Se produjo un error en la autenticación. Puede utilizar este objeto para reintentar la autenticación.

InvalidCredentialException

Se produjo un error en la autenticación. Puede utilizar este objeto para reintentar la autenticación.

ObjectDisposedException

Este objeto se ha cerrado.

InvalidOperationException

Ya se ha producido la autenticación.

o bien

Esta secuencia se ha utilizado previamente para intentar la autenticación como servidor. No puede utilizar la secuencia para reintentar la autenticación como cliente.

Comentarios

La autenticación usa la propiedad del DefaultCredentialscliente. No se especifica ningún nombre de entidad de seguridad de servicio (SPN) para el servidor. El nivel de suplantación es Identification, el nivel de seguridad es EncryptAndSigny se solicita la autenticación mutua. La NegotiateStream clase construirá el SPN usado para la autenticación mutua.

Cuando la autenticación se realiza correctamente, debe comprobar las IsEncrypted propiedades y IsSigned para determinar qué servicios de seguridad usan .NegotiateStream Compruebe la IsMutuallyAuthenticated propiedad para determinar si se ha producido la autenticación mutua.

Si se produce un error en la autenticación, recibirá o AuthenticationException .InvalidCredentialException En este caso, puede volver a intentar la autenticación con una credencial diferente.

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 AuthenticateAsClient().

AuthenticateAsClientAsync(NetworkCredential, String)

Source:

NegotiateStream.cs

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación utiliza las credenciales de cliente especificadas.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, string targetName);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String) As Task

Parámetros

credential

NetworkCredential

NetworkCredential que se utiliza para establecer la identidad del cliente.

targetName

String

Nombre de entidad de seguridad de servicio (SPN) que identifica de forma única el servidor que se va a autenticar.

Devoluciones

Task

Objeto de tarea que representa la operación asincrónica.

Excepciones

AuthenticationException

Se produjo un error en la autenticación. Puede utilizar este objeto para reintentar la autenticación.

InvalidCredentialException

Se produjo un error en la autenticación. Puede utilizar este objeto para reintentar la autenticación.

ObjectDisposedException

Este objeto se ha cerrado.

InvalidOperationException

Ya se ha producido la autenticación.

o bien

Esta secuencia se ha utilizado previamente para intentar la autenticación como servidor. No puede utilizar la secuencia para reintentar la autenticación como cliente.

ArgumentNullException

targetName es null.

Comentarios

El nivel de suplantación es Identification, el nivel de seguridad es EncryptAndSigny se solicita la autenticación mutua. La NegotiateStream clase construirá el SPN usado para la autenticación mutua.

Cuando la autenticación se realiza correctamente, debe comprobar las IsEncrypted propiedades y IsSigned para determinar qué servicios de seguridad usan .NegotiateStream Compruebe la IsMutuallyAuthenticated propiedad para determinar si se ha producido la autenticación mutua.

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 AuthenticateAsClient(NetworkCredential, String).

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)

Source:

NegotiateStream.cs

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación utiliza las credenciales de cliente y el enlace de canal especificados.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String) As Task

Parámetros

credential

NetworkCredential

NetworkCredential que se utiliza para establecer la identidad del cliente.

binding

ChannelBinding

Objeto ChannelBinding que se usa para la protección extendida.

targetName

String

Nombre de entidad de seguridad de servicio (SPN) que identifica de forma única el servidor que se va a autenticar.

Devoluciones

Task

Objeto de tarea que representa la operación asincrónica.

Excepciones

ArgumentNullException

targetName es null.

O bien

credential es null.

AuthenticationException

Se produjo un error en la autenticación. Puede utilizar este objeto para reintentar la autenticación.

InvalidCredentialException

Se produjo un error en la autenticación. Puede utilizar este objeto para reintentar la autenticación.

InvalidOperationException

Ya se ha producido la autenticación.

o bien

Esta secuencia se ha utilizado previamente para intentar la autenticación como servidor. No puede utilizar la secuencia para reintentar la autenticación como cliente.

ObjectDisposedException

Este objeto se ha cerrado.

Comentarios

El nivel de suplantación es Identification, el nivel de seguridad es EncryptAndSigny se solicita la autenticación mutua. La NegotiateStream clase construirá el SPN usado para la autenticación mutua.

El ChannelBinding objeto utilizado para la protección ampliada que se pasa a este método en el binding parámetro se recuperaría mediante una aplicación de la TransportContext propiedad en el asociado SslStream.

Cuando la autenticación se realiza correctamente, debe comprobar las IsEncrypted propiedades y IsSigned para determinar qué servicios de seguridad usan .NegotiateStream Compruebe la IsMutuallyAuthenticated propiedad para determinar si se ha producido la autenticación mutua.

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 AuthenticateAsClient(NetworkCredential, ChannelBinding, String).

Consulte también

• ChannelBinding
• Autenticación de Windows integrada con protección ampliada

AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Source:

NegotiateStream.cs

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación utiliza las credenciales y las opciones de autenticación especificadas.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As Task

Parámetros

credential

NetworkCredential

NetworkCredential que se utiliza para establecer la identidad del cliente.

targetName

String

Nombre de entidad de seguridad de servicio (SPN) que identifica de forma única el servidor que se va a autenticar.

requiredProtectionLevel

ProtectionLevel

Uno de los valores de ProtectionLevel, que indica los servicios de seguridad de la secuencia.

allowedImpersonationLevel

TokenImpersonationLevel

Uno de los valores de TokenImpersonationLevel, que indica cómo puede utilizar el servidor las credenciales del cliente para tener acceso a los recursos.

Devoluciones

Task

Objeto de tarea que representa la operación asincrónica.

Excepciones

ArgumentOutOfRangeException

allowedImpersonationLevel no es un valor válido.

ArgumentNullException

targetName es null.

AuthenticationException

Se produjo un error en la autenticación. Puede utilizar este objeto para reintentar la autenticación.

InvalidCredentialException

Se produjo un error en la autenticación. Puede utilizar este objeto para reintentar la autenticación.

ObjectDisposedException

Este objeto se ha cerrado.

InvalidOperationException

Ya se ha producido la autenticación.

o bien

Esta secuencia se ha utilizado previamente para intentar la autenticación como servidor. No puede utilizar la secuencia para reintentar la autenticación como cliente.

Comentarios

Use el requiredProtectionLevel parámetro para solicitar servicios de seguridad para los datos transmitidos mediante la secuencia autenticada. Por ejemplo, para que los datos se cifren y firmen, especifique el EncryptAndSign valor . La autenticación correcta no garantiza que se haya concedido la solicitud ProtectionLevel . Debe comprobar las IsEncrypted propiedades y IsSigned para determinar qué servicios de seguridad usan .NegotiateStream

Si se produce un error en la autenticación, recibirá o AuthenticationException .InvalidCredentialException En este caso, puede volver a intentar la autenticación con una credencial diferente.

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 AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel).

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)

Source:

NegotiateStream.cs

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor como una operación asincrónica. El proceso de autenticación utiliza las credenciales, las opciones de autenticación y el enlace de canal especificados.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As Task

Parámetros

credential

NetworkCredential

NetworkCredential que se utiliza para establecer la identidad del cliente.

binding

ChannelBinding

Objeto ChannelBinding que se usa para la protección extendida.

targetName

String

Nombre de entidad de seguridad de servicio (SPN) que identifica de forma única el servidor que se va a autenticar.

requiredProtectionLevel

ProtectionLevel

Uno de los valores de ProtectionLevel, que indica los servicios de seguridad de la secuencia.

allowedImpersonationLevel

TokenImpersonationLevel

Uno de los valores de TokenImpersonationLevel, que indica cómo puede utilizar el servidor las credenciales del cliente para tener acceso a los recursos.

Devoluciones

Task

Objeto de tarea que representa la operación asincrónica.

Excepciones

ArgumentNullException

targetName es null.

O bien

credential es null.

ArgumentOutOfRangeException

allowedImpersonationLevel no es un valor válido.

AuthenticationException

Se produjo un error en la autenticación. Puede utilizar este objeto para reintentar la autenticación.

InvalidCredentialException

Se produjo un error en la autenticación. Puede utilizar este objeto para reintentar la autenticación.

InvalidOperationException

Ya se ha producido la autenticación.

o bien

Esta secuencia se ha utilizado previamente para intentar la autenticación como servidor. No puede utilizar la secuencia para reintentar la autenticación como cliente.

ObjectDisposedException

Este objeto se ha cerrado.

Comentarios

Use el requiredProtectionLevel parámetro para solicitar servicios de seguridad para los datos transmitidos mediante la secuencia autenticada. Por ejemplo, para que los datos se cifren y firmen, especifique el EncryptAndSign valor . La autenticación correcta no garantiza que se haya concedido la solicitud ProtectionLevel . Debe comprobar las IsEncrypted propiedades y IsSigned para determinar qué servicios de seguridad usan .NegotiateStream

El ChannelBinding objeto utilizado para la protección ampliada que se pasa a este método en el binding parámetro se recuperaría mediante una aplicación de la TransportContext propiedad en el asociado SslStream.

Si se produce un error en la autenticación, recibirá o AuthenticationException .InvalidCredentialException En este caso, puede volver a intentar la autenticación con una credencial diferente.

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 AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel).

Consulte también

• ChannelBinding
• Autenticación de Windows integrada con protección ampliada