NegotiateStream.AuthenticateAsClient Método

Definição

Espaço de Nomes:: System.Net.Security

Assemblagem:: System.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Chamada pelos clientes para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor.

Sobrecargas

Name	Description
AuthenticateAsClient()	Chamada pelos clientes para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor.
AuthenticateAsClient(NetworkCredential, String)	Chamada pelos clientes para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza a credencial do cliente especificada.
AuthenticateAsClient(NetworkCredential, ChannelBinding, String)	Chamada pelos clientes para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza a credencial do cliente especificada e a ligação ao canal.
AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)	Chamada pelos clientes para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza as credenciais e opções de autenticação especificadas.
AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)	Chamada pelos clientes para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza a credencial especificada, as opções de autenticação e a ligação de canal.

AuthenticateAsClient()

Chamada pelos clientes para autenticar o cliente, e opcionalmente o servidor, numa ligação 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. Pode usar este objeto para tentar novamente a autenticação.

InvalidCredentialException

A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.

ObjectDisposedException

Este objeto foi encerrado.

InvalidOperationException

A autenticação já ocorreu.

-ou-

Este fluxo era usado anteriormente para tentar autenticação como servidor. Não podes usar o stream para tentar autenticação novamente como cliente.

Observações

A autenticação utiliza o DefaultCredentials. Não é especificado nenhum Nome Principal de Serviço (SPN) para o servidor. O nível de personificação é Identification, o nível de segurança é EncryptAndSign, e solicita-se autenticação mútua. A NegotiateStream classe irá construir o SPN usado para autenticação mútua.

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

Se a autenticação falhar, recebe um AuthenticationException ou um InvalidCredentialException. Neste caso, pode tentar a autenticação novamente com uma credencial diferente.

Aplica-se a

AuthenticateAsClient(NetworkCredential, String)

Chamada pelos clientes para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza a credencial do 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 Nome Principal do Serviço (SPN) que identifica de forma única o servidor a autenticar.

Exceções

AuthenticationException

A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.

InvalidCredentialException

A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.

ObjectDisposedException

Este objeto foi encerrado.

InvalidOperationException

A autenticação já ocorreu.

-ou-

Este fluxo era usado anteriormente para tentar autenticação como servidor. Não podes usar o stream para tentar autenticação novamente como cliente.

ArgumentNullException

targetName é null.

Observações

O nível de personificação é Identification, o nível de segurança é EncryptAndSign, e solicita-se autenticação mútua. A NegotiateStream classe irá construir o SPN usado para autenticação mútua.

Aplica-se a

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

Chamada pelos clientes para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza a credencial do cliente especificada e a ligação ao 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);

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

targetName: String

O Nome Principal do Serviço (SPN) que identifica de forma única o servidor a autenticar.

Exceções

ArgumentNullException

targetName é null.

-ou-

credential é null.

AuthenticationException

A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.

InvalidCredentialException

A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.

InvalidOperationException

A autenticação já ocorreu.

-ou-

Este fluxo era usado anteriormente para tentar autenticação como servidor. Não podes usar o stream para tentar autenticação novamente como cliente.

ObjectDisposedException

Este objeto foi encerrado.

Observações

O ChannelBinding usado para proteção estendida que é passado a este método no binding parâmetro seria recuperado por uma aplicação a partir da TransportContext propriedade na associada SslStream.

Ver também

Aplica-se a

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Chamada pelos clientes para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza as credenciais e 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 Nome Principal do Serviço (SPN) que identifica de forma única o servidor a autenticar.

requiredProtectionLevel: ProtectionLevel

Um dos ProtectionLevel valores, indicando os serviços de segurança do fluxo.

allowedImpersonationLevel: TokenImpersonationLevel

Um dos TokenImpersonationLevel valores, indica como o servidor pode usar as credenciais do cliente para aceder a recursos.

Exceções

ArgumentOutOfRangeException

allowedImpersonationLevel não é um valor válido.

ArgumentNullException

targetName é null.

AuthenticationException

A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.

InvalidCredentialException

A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.

ObjectDisposedException

Este objeto foi encerrado.

InvalidOperationException

A autenticação já ocorreu.

-ou-

Este fluxo era usado anteriormente para tentar autenticação como servidor. Não podes usar o stream para tentar autenticação novamente como cliente.

Observações

Use o requiredProtectionLevel parâmetro para solicitar serviços de segurança para os dados transmitidos através do fluxo autenticado. Por exemplo, para que os dados sejam encriptados e assinados, especifique o EncryptAndSign valor. A autenticação bem-sucedida não garante que o pedido ProtectionLevel tenha sido concedido. Deve verificar as IsEncrypted e IsSigned propriedades para determinar que serviços de segurança são utilizados pelo NegotiateStream.

Se a autenticação falhar, recebe um AuthenticationException ou um InvalidCredentialException. Neste caso, pode tentar a autenticação novamente com uma credencial diferente.

Aplica-se a

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

Chamada pelos clientes para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza a credencial especificada, as opções de autenticação e a ligaçã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);

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

targetName: String

O Nome Principal do Serviço (SPN) que identifica de forma única o servidor a autenticar.

requiredProtectionLevel: ProtectionLevel

Um dos ProtectionLevel valores, indicando os serviços de segurança do fluxo.

allowedImpersonationLevel: TokenImpersonationLevel

Um dos TokenImpersonationLevel valores, indica como o servidor pode usar as credenciais do cliente para aceder a recursos.

Exceções

ArgumentNullException

targetName é null.

-ou-

credential é null.

ArgumentOutOfRangeException

allowedImpersonationLevel não é um valor válido.

AuthenticationException

A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.

InvalidCredentialException

A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.

InvalidOperationException

A autenticação já ocorreu.

-ou-

Este fluxo era usado anteriormente para tentar autenticação como servidor. Não podes usar o stream para tentar autenticação novamente como cliente.

ObjectDisposedException

Este objeto foi encerrado.

Observações

Se a autenticação falhar, recebe um AuthenticationException ou um InvalidCredentialException. Neste caso, pode tentar a autenticação novamente com uma credencial diferente.

Ver também

Aplica-se a

Comentários

Esta página foi útil?