NegotiateStream.AuthenticateAsServer Método
Definição
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.
Trata do lado servidor de uma autenticação para uma ligação cliente-servidor.
Sobrecargas
| Name | Description |
|---|---|
| AuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel) |
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza as credenciais do servidor especificadas, as opções de autenticação e a política de proteção alargada. |
| AuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel) |
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza as credenciais do servidor e as opções de autenticação especificadas. |
| AuthenticateAsServer() |
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. |
| AuthenticateAsServer(ExtendedProtectionPolicy) |
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza a política de proteção estendida especificada. |
Observações
Estes métodos bloqueiam enquanto a autenticação está em curso. Para evitar que a aplicação bloqueie enquanto espera que a autenticação seja concluída, utilize o BeginAuthenticateAsServer método.
AuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza as credenciais do servidor especificadas, as opções de autenticação e a política de proteção alargada.
public:
virtual void AuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);public virtual void AuthenticateAsServer(System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);abstract member AuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unitPublic Overridable Sub AuthenticateAsServer (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel)Parâmetros
- credential
- NetworkCredential
O NetworkCredential que é usado para estabelecer a identidade do cliente.
- policy
- ExtendedProtectionPolicy
O ExtendedProtectionPolicy que é usado para proteção prolongada.
- requiredProtectionLevel
- ProtectionLevel
Um dos ProtectionLevel valores, indicando os serviços de segurança do fluxo.
- requiredImpersonationLevel
- TokenImpersonationLevel
Um dos TokenImpersonationLevel valores, indica como o servidor pode usar as credenciais do cliente para aceder a recursos.
Exceções
Os CustomChannelBinding e CustomServiceNames na política de proteção estendida passada no policy parâmetro são ambos null.
credential é null.
requiredImpersonationLevel deve ser Identification, Impersonation, ou Delegation,
A autenticação falhou. Podes usar este objeto para tentar autenticar o r.
A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.
A autenticação já ocorreu.
-ou-
Este fluxo era usado anteriormente para tentar autenticação como cliente. Não podes usar o stream para tentar autenticação novamente como servidor.
Este objeto foi encerrado.
O policy parâmetro foi definido para Always numa plataforma que não suporta proteção estendida.
Windows 95 e Windows 98 não são suportados.
Observações
Se o policy parâmetro for null, então é usada uma política de proteção estendida que tem PolicyEnforcement definido como Never.
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.
Este método bloqueia até que a operação seja concluída. Para evitar bloqueios até a operação terminar, utilize uma das BeginAuthenticateAsServer sobrecargas do método.
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
AuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza as credenciais do servidor e as opções de autenticação especificadas.
public:
virtual void AuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);public virtual void AuthenticateAsServer(System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);abstract member AuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unitPublic Overridable Sub AuthenticateAsServer (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel)Parâmetros
- credential
- NetworkCredential
O NetworkCredential que é usado para estabelecer a identidade do servidor.
- requiredProtectionLevel
- ProtectionLevel
Um dos ProtectionLevel valores, indicando os serviços de segurança do fluxo.
- requiredImpersonationLevel
- TokenImpersonationLevel
Um dos TokenImpersonationLevel valores, indica como o servidor pode usar as credenciais do cliente para aceder a recursos.
Exceções
credential é null.
requiredImpersonationLevel deve ser Identification, Impersonation, ou Delegation,
A autenticação falhou. Podes usar este objeto para tentar autenticar o r.
A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.
Este objeto foi encerrado.
A autenticação já ocorreu.
-ou-
Este fluxo era usado anteriormente para tentar autenticação como cliente. Não podes usar o stream para tentar autenticação novamente como servidor.
Windows 95 e Windows 98 não são suportados.
Observações
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.
Este método bloqueia até que a operação seja concluída. Para evitar bloqueios até a operação terminar, utilize uma das BeginAuthenticateAsServer sobrecargas do método.
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
AuthenticateAsServer()
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor.
public:
virtual void AuthenticateAsServer();public virtual void AuthenticateAsServer();abstract member AuthenticateAsServer : unit -> unit
override this.AuthenticateAsServer : unit -> unitPublic Overridable Sub AuthenticateAsServer ()Exceções
A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.
A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.
Este objeto foi encerrado.
Windows 95 e Windows 98 não são suportados.
Observações
A autenticação utiliza o arquivo do servidor DefaultCredentials. Não é especificado nenhum Nome Principal de Serviço (SPN) para o servidor. O nível de personificação é Identification, e o nível de segurança é EncryptAndSign.
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.
Este método bloqueia até que a operação seja concluída. Para evitar bloqueios até a operação terminar, utilize uma das BeginAuthenticateAsServer sobrecargas do método.
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
AuthenticateAsServer(ExtendedProtectionPolicy)
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor. O processo de autenticação utiliza a política de proteção estendida especificada.
public:
virtual void AuthenticateAsServer(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy);public virtual void AuthenticateAsServer(System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy);abstract member AuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> unit
override this.AuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> unitPublic Overridable Sub AuthenticateAsServer (policy As ExtendedProtectionPolicy)Parâmetros
- policy
- ExtendedProtectionPolicy
O ExtendedProtectionPolicy que é usado para proteção prolongada.
Exceções
Os CustomChannelBinding e CustomServiceNames na política de proteção estendida passada no policy parâmetro são ambos null.
A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.
A autenticação falhou. Pode usar este objeto para tentar novamente a autenticação.
Este objeto foi encerrado.
O policy parâmetro foi definido para Always numa plataforma que não suporta proteção estendida.
Windows 95 e Windows 98 não são suportados.
Observações
A autenticação utiliza o arquivo do servidor DefaultCredentials. Não é especificado nenhum Nome Principal de Serviço (SPN) para o servidor. O nível de personificação é Identification, e o nível de segurança é EncryptAndSign.
Se o policy parâmetro for null, então é usada uma política de proteção estendida que tem PolicyEnforcement definido como Never.
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.
Este método bloqueia até que a operação seja concluída. Para evitar bloqueios até a operação terminar, utilize uma das BeginAuthenticateAsServer sobrecargas do método.
Se a autenticação falhar, recebe um AuthenticationException ou um InvalidCredentialException. Neste caso, pode tentar a autenticação novamente com uma credencial diferente.