NegotiateStream.AuthenticateAsClient Método

Referência

Definição

Namespace:: System.Net.Security

Assembly:: System.Net.Security.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Chamado por clientes para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor.

Sobrecargas

AuthenticateAsClient()	Chamado por clientes para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor.
AuthenticateAsClient(NetworkCredential, String)	Chamado por clientes para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa a credencial de cliente especificada.
AuthenticateAsClient(NetworkCredential, ChannelBinding, String)	Chamado por clientes para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa a credencial do cliente especificada e a associação de canal.
AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)	Chamado por clientes para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa as credenciais e as opções de autenticação especificadas.
AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)	Chamado por clientes para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa as credenciais especificadas, as opções de autenticação e a associação de canal.

AuthenticateAsClient()

Chamado por clientes para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor.

public:
 virtual void AuthenticateAsClient();

public virtual void AuthenticateAsClient ();

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

Public Overridable Sub AuthenticateAsClient ()

Exceções

AuthenticationException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidCredentialException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

ObjectDisposedException

Este objeto foi fechado.

InvalidOperationException

A autenticação já ocorreu.

- ou -

Este fluxo foi usado anteriormente para tentar realizar autenticação como o servidor. Você não pode usar o fluxo para tentar novamente a autenticação como cliente.

Comentários

A autenticação usa o cliente.DefaultCredentials Nenhum SPN (Nome da Entidade de Serviço) é especificado para o servidor. O nível de representação é Identification, o nível de segurança é EncryptAndSigne a autenticação mútua é solicitada. A NegotiateStream classe construirá o SPN usado para autenticação mútua.

Quando a autenticação for bem-sucedida, você deverá verificar as propriedades e IsSigned as IsEncrypted propriedades para determinar quais serviços de segurança são usados pelo NegotiateStream. Verifique a IsMutuallyAuthenticated propriedade para determinar se a autenticação mútua ocorreu.

Se a autenticação falhar, você receberá um AuthenticationException ou um InvalidCredentialException. Nesse caso, você pode tentar novamente a autenticação com uma credencial diferente.

Aplica-se a

AuthenticateAsClient(NetworkCredential, String)

Chamado por clientes para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa a credencial de cliente especificada.

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

O NetworkCredential que é usado para estabelecer a identidade do cliente.

targetName: String

O SPN (nome da entidade de serviço) que identifica exclusivamente o servidor a autenticar.

Exceções

AuthenticationException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidCredentialException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

ObjectDisposedException

Este objeto foi fechado.

InvalidOperationException

A autenticação já ocorreu.

- ou -

Este fluxo foi usado anteriormente para tentar realizar autenticação como o servidor. Você não pode usar o fluxo para tentar novamente a autenticação como cliente.

ArgumentNullException

targetName é null.

Comentários

O nível de representação é Identification, o nível de segurança é EncryptAndSigne a autenticação mútua é solicitada. A NegotiateStream classe construirá o SPN usado para autenticação mútua.

Aplica-se a

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

Chamado por clientes para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa a credencial do cliente especificada e a associação de canal.

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

O NetworkCredential que é usado para estabelecer a identidade do cliente.

binding: ChannelBinding

O ChannelBinding que é usado para proteção estendida.

targetName: String

O SPN (nome da entidade de serviço) que identifica exclusivamente o servidor a autenticar.

Exceções

ArgumentNullException

targetName é null.

- ou - credential é null.

AuthenticationException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidCredentialException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidOperationException

A autenticação já ocorreu.

- ou -

Este fluxo foi usado anteriormente para tentar realizar autenticação como o servidor. Você não pode usar o fluxo para tentar novamente a autenticação como cliente.

ObjectDisposedException

Este objeto foi fechado.

Comentários

O ChannelBinding usado para proteção estendida que é passado para esse método no binding parâmetro seria recuperado por um aplicativo de TransportContext propriedade na propriedade associada SslStream.

Confira também

Aplica-se a

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Chamado por clientes para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa as credenciais e as opções de autenticação 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

O NetworkCredential que é usado para estabelecer a identidade do cliente.

targetName: String

O SPN (nome da entidade de serviço) que identifica exclusivamente o servidor a autenticar.

requiredProtectionLevel: ProtectionLevel

Um dos valores de ProtectionLevel, que indica os serviços de segurança para o fluxo.

allowedImpersonationLevel: TokenImpersonationLevel

Um dos valores de TokenImpersonationLevel, que indica como o servidor pode usar as credenciais do cliente para acessar recursos.

Exceções

ArgumentOutOfRangeException

allowedImpersonationLevel não é um valor válido.

ArgumentNullException

targetName é nulo.

AuthenticationException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidCredentialException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

ObjectDisposedException

Este objeto foi fechado.

InvalidOperationException

A autenticação já ocorreu.

- ou -

Este fluxo foi usado anteriormente para tentar realizar autenticação como o servidor. Você não pode usar o fluxo para tentar novamente a autenticação como cliente.

Comentários

Use o requiredProtectionLevel parâmetro para solicitar serviços de segurança para dados transmitidos usando o fluxo autenticado. Por exemplo, para que os dados sejam criptografados e assinados, especifique o EncryptAndSign valor. A autenticação bem-sucedida não garante que a solicitação ProtectionLevel tenha sido concedida. Você deve verificar as propriedades e IsSigned as IsEncrypted propriedades para determinar quais serviços de segurança são usados pelo NegotiateStream.

Se a autenticação falhar, você receberá um AuthenticationException ou um InvalidCredentialException. Nesse caso, você pode repetir a autenticação com uma credencial diferente.

Aplica-se a

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

Chamado por clientes para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa as credenciais especificadas, as opções de autenticação e a associação de canal.

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

O NetworkCredential que é usado para estabelecer a identidade do cliente.

binding: ChannelBinding

O ChannelBinding que é usado para proteção estendida.

targetName: String

O SPN (nome da entidade de serviço) que identifica exclusivamente o servidor a autenticar.

requiredProtectionLevel: ProtectionLevel

Um dos valores de ProtectionLevel, que indica os serviços de segurança para o fluxo.

allowedImpersonationLevel: TokenImpersonationLevel

Um dos valores de TokenImpersonationLevel, que indica como o servidor pode usar as credenciais do cliente para acessar recursos.

Exceções

ArgumentNullException

targetName é null.

- ou - credential é null.

ArgumentOutOfRangeException

allowedImpersonationLevel não é um valor válido.

AuthenticationException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidCredentialException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidOperationException

A autenticação já ocorreu.

- ou -

Este fluxo foi usado anteriormente para tentar realizar autenticação como o servidor. Você não pode usar o fluxo para tentar novamente a autenticação como cliente.

ObjectDisposedException

Este objeto foi fechado.

Comentários

Se a autenticação falhar, você receberá um AuthenticationException ou um InvalidCredentialException. Nesse caso, você pode repetir a autenticação com uma credencial diferente.

Confira também

Aplica-se a

NegotiateStream.AuthenticateAsClient Método

Definição

Sobrecargas

AuthenticateAsClient()

Exceções

Comentários

Aplica-se a

AuthenticateAsClient(NetworkCredential, String)

Parâmetros

Exceções

Comentários

Aplica-se a

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Parâmetros

Exceções

Comentários

Aplica-se a

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

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Recursos adicionais