NegotiateStream.AuthenticateAsClient Método

Definición

Espacio de nombres:

System.Net.Security

Ensamblado:

System.Net.Security.dll

Ensamblado:

System.dll

Ensamblado:

netstandard.dll

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

Sobrecargas

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

AuthenticateAsClient()

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

public:
 virtual void AuthenticateAsClient();

public virtual void AuthenticateAsClient ();

abstract member AuthenticateAsClient : unit -> unit
override this.AuthenticateAsClient : unit -> unit

Public Overridable Sub AuthenticateAsClient ()

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.

AuthenticateAsClient(NetworkCredential, String)

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

public:
 virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::String ^ targetName);

public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, string targetName);

abstract member AuthenticateAsClient : System.Net.NetworkCredential * string -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * string -> unit

Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, targetName As String)

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.

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.

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

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

public:
 virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName);

public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName);

public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName);

abstract member AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> unit

Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, binding As ChannelBinding, targetName As String)

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.

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.

Consulte también

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

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

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

public:
 virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);

public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

abstract member AuthenticateAsClient : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit

Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel)

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.

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.

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

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

public:
 virtual void AuthenticateAsClient(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 void AuthenticateAsClient (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

abstract member AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit

Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel)

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.

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.

Consulte también

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