NegotiateStream.AuthenticateAsServerAsync 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 como uma operação assíncrona.
Sobrecargas
| Name | Description |
|---|---|
| AuthenticateAsServerAsync() |
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor como uma operação assíncrona. |
| AuthenticateAsServerAsync(ExtendedProtectionPolicy) |
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza a política de proteção estendida especificada. |
| AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel) |
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza as credenciais do servidor e as opções de autenticação especificadas. |
| AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel) |
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor como uma operação assíncrona. 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. |
AuthenticateAsServerAsync()
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor como uma operação assíncrona.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync();public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync();abstract member AuthenticateAsServerAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : unit -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync () As TaskDevoluções
O objeto tarefa que representa a operação assíncrona.
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.
Se a autenticação falhar, recebe um AuthenticationException ou um InvalidCredentialException. Neste caso, pode tentar a autenticação novamente com uma credencial diferente.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsServer().
Aplica-se a
AuthenticateAsServerAsync(ExtendedProtectionPolicy)
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza a política de proteção estendida especificada.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy);abstract member AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (policy As ExtendedProtectionPolicy) As TaskParâmetros
- policy
- ExtendedProtectionPolicy
O ExtendedProtectionPolicy que é usado para proteção prolongada.
Devoluções
O objeto tarefa que representa a operação assíncrona.
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.
Se a autenticação falhar, recebe um AuthenticationException ou um InvalidCredentialException. Neste caso, pode tentar a autenticação novamente com uma credencial diferente.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsServer(ExtendedProtectionPolicy).
Ver também
Aplica-se a
AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor como uma operação assíncrona. O processo de autenticação utiliza as credenciais do servidor e as opções de autenticação especificadas.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As TaskParâ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.
Devoluções
O objeto tarefa que representa a operação assíncrona.
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.
Se a autenticação falhar, recebe um AuthenticationException ou um InvalidCredentialException. Neste caso, pode tentar a autenticação novamente com uma credencial diferente.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel).
Aplica-se a
AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)
Chamada pelos servidores para autenticar o cliente, e opcionalmente o servidor, numa ligação cliente-servidor como uma operação assíncrona. 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 System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As TaskParâ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.
Devoluções
O objeto tarefa que representa a operação assíncrona.
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.
Se a autenticação falhar, recebe um AuthenticationException ou um InvalidCredentialException. Neste caso, pode tentar a autenticação novamente com uma credencial diferente.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel).