NegotiateStream.AuthenticateAsClient Método

Definición

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.Called by clients to authenticate the client, and optionally the server, in a client-server connection.

Sobrecargas

AuthenticateAsClient()

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.Called by clients to authenticate the client, and optionally the server, in a client-server connection.

AuthenticateAsClient(NetworkCredential, String)

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.Called by clients to authenticate the client, and optionally the server, in a client-server connection. El proceso de autenticación utiliza las credenciales de cliente especificadas.The authentication process uses the specified client credential.

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.Called by clients to authenticate the client, and optionally the server, in a client-server connection. El proceso de autenticación utiliza las credenciales de cliente y el enlace de canal especificados.The authentication process uses the specified client credential and the channel binding.

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.Called by clients to authenticate the client, and optionally the server, in a client-server connection. El proceso de autenticación utiliza las credenciales y las opciones de autenticación especificadas.The authentication process uses the specified credentials and authentication options.

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

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.Called by clients to authenticate the client, and optionally the server, in a client-server connection. El proceso de autenticación utiliza las credenciales, las opciones de autenticación y el enlace de canal especificados.The authentication process uses the specified credential, authentication options, and channel binding.

AuthenticateAsClient()

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.Called by clients to authenticate the client, and optionally the server, in a client-server connection.

public:
 virtual void AuthenticateAsClient();
public virtual void AuthenticateAsClient ();
abstract member AuthenticateAsClient : unit -> unit
override this.AuthenticateAsClient : unit -> unit
Public Overridable Sub AuthenticateAsClient ()

Excepciones

Se produjo un error en la autenticación.The authentication failed. Puede utilizar este objeto para reintentar la autenticación.You can use this object to retry the authentication.

Se produjo un error en la autenticación.The authentication failed. Puede utilizar este objeto para reintentar la autenticación.You can use this object to retry the authentication.

Este objeto se ha cerrado.This object has been closed.

Ya se ha producido la autenticación.Authentication has already occurred.

o bien-or-

Esta secuencia se ha utilizado previamente para intentar la autenticación como servidor.This stream was used previously to attempt authentication as the server. No puede utilizar la secuencia para reintentar la autenticación como cliente.You cannot use the stream to retry authentication as the client.

Comentarios

La autenticación utiliza la del cliente DefaultCredentials .The authentication uses the client's DefaultCredentials. No se especificó ningún nombre de entidad de seguridad de servicio (SPN) para el servidor.No Service Principal Name (SPN) is specified for the server. El nivel de suplantación es Identification , el nivel de seguridad es EncryptAndSign y se solicita la autenticación mutua.The impersonation level is Identification, the security level is EncryptAndSign, and mutual authentication is requested. La NegotiateStream clase construirá el SPN que se usa para la autenticación mutua.The NegotiateStream class will construct the SPN used for mutual authentication.

Cuando la autenticación se realiza correctamente, debe comprobar IsEncrypted las IsSigned propiedades y para determinar qué servicios de seguridad utiliza NegotiateStream .When authentication succeeds, you must check the IsEncrypted and IsSigned properties to determine what security services are used by the NegotiateStream. Compruebe la IsMutuallyAuthenticated propiedad para determinar si se ha producido la autenticación mutua.Check the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Si se produce un error en la autenticación, recibirá AuthenticationException o InvalidCredentialException .If the authentication fails, you receive an AuthenticationException or an InvalidCredentialException. En este caso, puede volver a intentar la autenticación con una credencial diferente.In this case, you can retry the authentication with a different credential.

Se aplica a

AuthenticateAsClient(NetworkCredential, String)

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.Called by clients to authenticate the client, and optionally the server, in a client-server connection. El proceso de autenticación utiliza las credenciales de cliente especificadas.The authentication process uses the specified client credential.

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.The NetworkCredential that is used to establish the identity of the client.

targetName
String

Nombre de entidad de seguridad de servicio (SPN) que identifica de forma única el servidor que se va a autenticar.The Service Principal Name (SPN) that uniquely identifies the server to authenticate.

Excepciones

Se produjo un error en la autenticación.The authentication failed. Puede utilizar este objeto para reintentar la autenticación.You can use this object to retry the authentication.

Se produjo un error en la autenticación.The authentication failed. Puede utilizar este objeto para reintentar la autenticación.You can use this object to retry the authentication.

Este objeto se ha cerrado.This object has been closed.

Ya se ha producido la autenticación.Authentication has already occurred.

o bien-or-

Esta secuencia se ha utilizado previamente para intentar la autenticación como servidor.This stream was used previously to attempt authentication as the server. No puede utilizar la secuencia para reintentar la autenticación como cliente.You cannot use the stream to retry authentication as the client.

targetName es null.targetName is null.

Comentarios

El nivel de suplantación es Identification , el nivel de seguridad es EncryptAndSign y se solicita la autenticación mutua.The impersonation level is Identification, the security level is EncryptAndSign, and mutual authentication is requested. La NegotiateStream clase construirá el SPN que se usa para la autenticación mutua.The NegotiateStream class will construct the SPN used for mutual authentication.

Cuando la autenticación se realiza correctamente, debe comprobar IsEncrypted las IsSigned propiedades y para determinar qué servicios de seguridad utiliza NegotiateStream .When authentication succeeds, you must check the IsEncrypted and IsSigned properties to determine what security services are used by the NegotiateStream. Compruebe la IsMutuallyAuthenticated propiedad para determinar si se ha producido la autenticación mutua.Check the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Se aplica a

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.Called by clients to authenticate the client, and optionally the server, in a client-server connection. El proceso de autenticación utiliza las credenciales de cliente y el enlace de canal especificados.The authentication process uses the specified client credential and the channel binding.

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.The NetworkCredential that is used to establish the identity of the client.

binding
ChannelBinding

Objeto ChannelBinding que se usa para la protección extendida.The ChannelBinding that is used for extended protection.

targetName
String

Nombre de entidad de seguridad de servicio (SPN) que identifica de forma única el servidor que se va a autenticar.The Service Principal Name (SPN) that uniquely identifies the server to authenticate.

Excepciones

targetName es null.targetName is null.

O bien-or- credential es null.credential is null.

Se produjo un error en la autenticación.The authentication failed. Puede utilizar este objeto para reintentar la autenticación.You can use this object to retry the authentication.

Se produjo un error en la autenticación.The authentication failed. Puede utilizar este objeto para reintentar la autenticación.You can use this object to retry the authentication.

Ya se ha producido la autenticación.Authentication has already occurred.

o bien-or-

Esta secuencia se ha utilizado previamente para intentar la autenticación como servidor.This stream was used previously to attempt authentication as the server. No puede utilizar la secuencia para reintentar la autenticación como cliente.You cannot use the stream to retry authentication as the client.

Este objeto se ha cerrado.This object has been closed.

Comentarios

El nivel de suplantación es Identification , el nivel de seguridad es EncryptAndSign y se solicita la autenticación mutua.The impersonation level is Identification, the security level is EncryptAndSign, and mutual authentication is requested. La NegotiateStream clase construirá el SPN que se usa para la autenticación mutua.The NegotiateStream class will construct the SPN used for mutual authentication.

El ChannelBinding utilizado para la protección extendida que se pasa a este método en el binding parámetro lo recuperaría una aplicación de TransportContext la propiedad en el objeto asociado SslStream .The ChannelBinding used for extended protection that is passed to this method in the binding parameter would be retrieved by an application from TransportContext property on the associated SslStream.

Cuando la autenticación se realiza correctamente, debe comprobar IsEncrypted las IsSigned propiedades y para determinar qué servicios de seguridad utiliza NegotiateStream .When authentication succeeds, you must check the IsEncrypted and IsSigned properties to determine what security services are used by the NegotiateStream. Compruebe la IsMutuallyAuthenticated propiedad para determinar si se ha producido la autenticación mutua.Check the IsMutuallyAuthenticated property to determine whether mutual authentication occurred.

Consulte también

Se aplica a

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.Called by clients to authenticate the client, and optionally the server, in a client-server connection. El proceso de autenticación utiliza las credenciales y las opciones de autenticación especificadas.The authentication process uses the specified credentials and authentication options.

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.The NetworkCredential that is used to establish the identity of the client.

targetName
String

Nombre de entidad de seguridad de servicio (SPN) que identifica de forma única el servidor que se va a autenticar.The Service Principal Name (SPN) that uniquely identifies the server to authenticate.

requiredProtectionLevel
ProtectionLevel

Uno de los valores de ProtectionLevel, que indica los servicios de seguridad de la secuencia.One of the ProtectionLevel values, indicating the security services for the stream.

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.One of the TokenImpersonationLevel values, indicating how the server can use the client's credentials to access resources.

Excepciones

allowedImpersonationLevel no es un valor válido.allowedImpersonationLevel is not a valid value.

targetName es null.targetName is null.

Se produjo un error en la autenticación.The authentication failed. Puede utilizar este objeto para reintentar la autenticación.You can use this object to retry the authentication.

Se produjo un error en la autenticación.The authentication failed. Puede utilizar este objeto para reintentar la autenticación.You can use this object to retry the authentication.

Este objeto se ha cerrado.This object has been closed.

Ya se ha producido la autenticación.Authentication has already occurred.

o bien-or-

Esta secuencia se ha utilizado previamente para intentar la autenticación como servidor.This stream was used previously to attempt authentication as the server. No puede utilizar la secuencia para reintentar la autenticación como cliente.You cannot use the stream to retry authentication as the client.

Comentarios

Use el requiredProtectionLevel parámetro para solicitar servicios de seguridad para los datos transmitidos mediante la secuencia autenticada.Use the requiredProtectionLevel parameter to request security services for data transmitted using the authenticated stream. Por ejemplo, para que los datos estén cifrados y firmados, especifique el EncryptAndSign valor.For example, to have the data encrypted and signed, specify the EncryptAndSign value. La autenticación correcta no garantiza que se haya concedido la solicitud solicitada ProtectionLevel .Successful authentication does not guarantee that the requested ProtectionLevel has been granted. Debe comprobar las IsEncrypted propiedades y IsSigned para determinar qué servicios de seguridad utiliza NegotiateStream .You must check the IsEncrypted and IsSigned properties to determine what security services are used by the NegotiateStream.

Si se produce un error en la autenticación, recibirá AuthenticationException o InvalidCredentialException .If the authentication fails, you receive an AuthenticationException or an InvalidCredentialException. En este caso, puede volver a intentar la autenticación con una credencial diferente.In this case, you can retry the authentication with a different credential.

Se aplica a

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

Lo llaman los clientes para autenticar el cliente, y opcionalmente el servidor, en una conexión cliente-servidor.Called by clients to authenticate the client, and optionally the server, in a client-server connection. El proceso de autenticación utiliza las credenciales, las opciones de autenticación y el enlace de canal especificados.The authentication process uses the specified credential, authentication options, and channel binding.

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.The NetworkCredential that is used to establish the identity of the client.

binding
ChannelBinding

Objeto ChannelBinding que se usa para la protección extendida.The ChannelBinding that is used for extended protection.

targetName
String

Nombre de entidad de seguridad de servicio (SPN) que identifica de forma única el servidor que se va a autenticar.The Service Principal Name (SPN) that uniquely identifies the server to authenticate.

requiredProtectionLevel
ProtectionLevel

Uno de los valores de ProtectionLevel, que indica los servicios de seguridad de la secuencia.One of the ProtectionLevel values, indicating the security services for the stream.

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.One of the TokenImpersonationLevel values, indicating how the server can use the client's credentials to access resources.

Excepciones

targetName es null.targetName is null.

O bien-or- credential es null.credential is null.

allowedImpersonationLevel no es un valor válido.allowedImpersonationLevel is not a valid value.

Se produjo un error en la autenticación.The authentication failed. Puede utilizar este objeto para reintentar la autenticación.You can use this object to retry the authentication.

Se produjo un error en la autenticación.The authentication failed. Puede utilizar este objeto para reintentar la autenticación.You can use this object to retry the authentication.

Ya se ha producido la autenticación.Authentication has already occurred.

o bien-or-

Esta secuencia se ha utilizado previamente para intentar la autenticación como servidor.This stream was used previously to attempt authentication as the server. No puede utilizar la secuencia para reintentar la autenticación como cliente.You cannot use the stream to retry authentication as the client.

Este objeto se ha cerrado.This object has been closed.

Comentarios

Use el requiredProtectionLevel parámetro para solicitar servicios de seguridad para los datos transmitidos mediante la secuencia autenticada.Use the requiredProtectionLevel parameter to request security services for data transmitted using the authenticated stream. Por ejemplo, para que los datos estén cifrados y firmados, especifique el EncryptAndSign valor.For example, to have the data encrypted and signed, specify the EncryptAndSign value. La autenticación correcta no garantiza que se haya concedido la solicitud solicitada ProtectionLevel .Successful authentication does not guarantee that the requested ProtectionLevel has been granted. Debe comprobar las IsEncrypted propiedades y IsSigned para determinar qué servicios de seguridad utiliza NegotiateStream .You must check the IsEncrypted and IsSigned properties to determine what security services are used by the NegotiateStream.

El ChannelBinding utilizado para la protección extendida que se pasa a este método en el binding parámetro lo recuperaría una aplicación de TransportContext la propiedad en el objeto asociado SslStream .The ChannelBinding used for extended protection that is passed to this method in the binding parameter would be retrieved by an application from TransportContext property on the associated SslStream.

Si se produce un error en la autenticación, recibirá AuthenticationException o InvalidCredentialException .If the authentication fails, you receive an AuthenticationException or an InvalidCredentialException. En este caso, puede volver a intentar la autenticación con una credencial diferente.In this case, you can retry the authentication with a different credential.

Consulte también

Se aplica a