Comparteix a través de


NegotiateStream.AuthenticateAsClientAsync Método

Definición

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
Source:
NegotiateStream.cs
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

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

Excepciones

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

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

Este objeto se ha cerrado.

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

Se aplica a

AuthenticateAsClientAsync(NetworkCredential, String)

Source:
NegotiateStream.cs
Source:
NegotiateStream.cs
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

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

Excepciones

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

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

Este objeto se ha cerrado.

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.

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

Se aplica a

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)

Source:
NegotiateStream.cs
Source:
NegotiateStream.cs
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);
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

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

Excepciones

targetName es null.

O bien

credential es null.

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

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

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.

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

Se aplica a

AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Source:
NegotiateStream.cs
Source:
NegotiateStream.cs
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

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

Excepciones

allowedImpersonationLevel no es un valor válido.

targetName es null.

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

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

Este objeto se ha cerrado.

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

Se aplica a

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

Source:
NegotiateStream.cs
Source:
NegotiateStream.cs
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);
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

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

Excepciones

targetName es null.

O bien

credential es null.

allowedImpersonationLevel no es un valor válido.

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

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

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.

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

Se aplica a