NegotiateStream.BeginAuthenticateAsServer 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.
Inicia-se uma operação assíncrona para tratar do lado servidor da autenticação de uma ligação cliente-servidor.
Sobrecargas
| Name | Description |
|---|---|
| BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object) |
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do cliente, e opcionalmente do servidor, numa ligação cliente-servidor. O processo de autenticação utiliza as credenciais do servidor e as opções de autenticação especificadas. Este método não bloqueia. |
| BeginAuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object) |
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do cliente, e opcionalmente do 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. Este método não bloqueia. |
| BeginAuthenticateAsServer(AsyncCallback, Object) |
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do cliente, e opcionalmente do servidor, numa ligação cliente-servidor. Este método não bloqueia. |
| BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object) |
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do cliente, e opcionalmente do servidor, numa ligação cliente-servidor. O processo de autenticação utiliza a política de proteção estendida especificada. Este método não bloqueia. |
Observações
As sobrecargas deste método não bloqueiam enquanto a autenticação está em andamento. Para bloquear enquanto espera que a autenticação seja concluída, use o AuthenticateAsServer método.
BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do cliente, e opcionalmente do servidor, numa ligação cliente-servidor. O processo de autenticação utiliza as credenciais do servidor e as opções de autenticação especificadas. Este método não bloqueia.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer(System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParâmetros
- credential
- NetworkCredential
O NetworkCredential que é usado para estabelecer a identidade do cliente.
- 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.
- asyncCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a invocar quando a autenticação estiver concluída.
- asyncState
- Object
Um objeto definido pelo utilizador contendo informação sobre a operação. Este objeto é passado para o asyncCallback delegado quando a operação termina.
Devoluções
Um objeto que IAsyncResult indica o estado da operação assíncrona.
Exceções
credential é null.
requiredImpersonationLevel deve ser Identification, Impersonation, ou Delegation,
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.
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
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 foi concedido. Deve verificar as IsEncrypted e IsSigned propriedades para determinar que serviços de segurança são utilizados pelo NegotiateStream.
Este método é assíncrono e não bloqueia enquanto a operação está concluída. Para bloquear até a operação terminar, use uma das AuthenticateAsServer sobrecargas de métodos.
A operação de autenticação assíncrona deve ser realizada chamando o EndAuthenticateAsServer método. Normalmente, o método é invocado pelo asyncCallback delegado. Para informações detalhadas sobre a utilização do modelo de programação assíncrona, veja Chamar Métodos Síncronos Assíncronos
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
BeginAuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do cliente, e opcionalmente do 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. Este método não bloqueia.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer(System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParâ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.
- asyncCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a invocar quando a autenticação estiver concluída.
- asyncState
- Object
Um objeto definido pelo utilizador contendo informação sobre a operação de escrita. Este objeto é passado para o asyncCallback delegado quando a operação termina.
Devoluções
Um objeto que IAsyncResult indica o estado da 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. Pode usar este objeto para tentar novamente a autenticação.
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
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 foi concedido. Deve verificar as IsEncrypted e IsSigned propriedades para determinar que serviços de segurança são utilizados pelo NegotiateStream.
Se o policy parâmetro for null, então é usada uma política de proteção estendida que tem PolicyEnforcement definido como Never.
Este método é assíncrono e não bloqueia enquanto a operação está concluída. Para bloquear até a operação terminar, use uma das AuthenticateAsServer sobrecargas de métodos.
A operação de autenticação assíncrona deve ser realizada chamando o EndAuthenticateAsServer método. Normalmente, o método é invocado pelo asyncCallback delegado. Para informações detalhadas sobre a utilização do modelo de programação assíncrona, veja Chamar Métodos Síncronos Assíncronos
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
BeginAuthenticateAsServer(AsyncCallback, Object)
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do cliente, e opcionalmente do servidor, numa ligação cliente-servidor. Este método não bloqueia.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer(AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParâmetros
- asyncCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a invocar quando a autenticação estiver concluída.
- asyncState
- Object
Um objeto definido pelo utilizador contendo informação sobre a operação. Este objeto é passado para o asyncCallback delegado quando a operação termina.
Devoluções
Um objeto que IAsyncResult indica o estado da 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, 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.
Para bloquear até a operação terminar, use uma das AuthenticateAsServer sobrecargas de métodos.
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
BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object)
Chamado pelos servidores para iniciar uma operação assíncrona de autenticação do cliente, e opcionalmente do servidor, numa ligação cliente-servidor. O processo de autenticação utiliza a política de proteção estendida especificada. Este método não bloqueia.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsServer(System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsServer (policy As ExtendedProtectionPolicy, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParâmetros
- policy
- ExtendedProtectionPolicy
O ExtendedProtectionPolicy que é usado para proteção prolongada.
- asyncCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a invocar quando a autenticação estiver concluída.
- asyncState
- Object
Um objeto definido pelo utilizador contendo informação sobre a operação de escrita. Este objeto é passado para o asyncCallback delegado quando a operação termina.
Devoluções
Um objeto que IAsyncResult indica o estado da 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, 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.
Para bloquear até a operação terminar, use uma das AuthenticateAsServer sobrecargas de métodos.
Se a autenticação falhar, recebe um AuthenticationException ou um InvalidCredentialException. Neste caso, pode tentar a autenticação novamente com uma credencial diferente.