NegotiateStream.BeginAuthenticateAsServer Método
Definição
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.
Inicia uma operação assíncrona para lidar com o lado do servidor de autenticação de uma conexão cliente-servidor.
Sobrecargas
BeginAuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object) |
Chamado por servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa as credenciais de servidor especificadas, as opções de autenticação e a política de proteção estendida. Esse método não bloqueia. |
BeginAuthenticateAsServer(AsyncCallback, Object) |
Chamado por servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. Esse método não bloqueia. |
BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object) |
Chamado por servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa a política de proteção estendida especificada. Esse método não bloqueia. |
BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object) |
Chamado por servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa as opções de autenticação e credenciais de servidor especificadas. Esse método não bloqueia. |
Comentários
As sobrecargas desse método não bloqueiam enquanto a autenticação está em andamento. Para bloquear enquanto aguarda a conclusão da autenticação, use o AuthenticateAsServer método .
BeginAuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)
- Origem:
- NegotiateStream.cs
- Origem:
- NegotiateStream.cs
- Origem:
- NegotiateStream.cs
Chamado por servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa as credenciais de servidor especificadas, as opções de autenticação e a política de proteção estendida. Esse 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);
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 -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Parâmetros
- credential
- NetworkCredential
O NetworkCredential que é usado para estabelecer a identidade do cliente.
- policy
- ExtendedProtectionPolicy
O ExtendedProtectionPolicy que é usado para proteção estendida.
- requiredProtectionLevel
- ProtectionLevel
Um dos valores de ProtectionLevel, que indica os serviços de segurança para o fluxo.
- requiredImpersonationLevel
- TokenImpersonationLevel
Um dos valores de TokenImpersonationLevel, que indica como o servidor pode usar as credenciais do cliente para acessar recursos.
- asyncCallback
- AsyncCallback
Um representante AsyncCallback que faz referência ao método a ser invocado quando a autenticação é concluída.
- asyncState
- Object
Um objeto definido pelo usuário que contém informações sobre a operação de gravação. Esse objeto é passado para o representante asyncCallback
quando a operação é concluída.
Retornos
Um objeto IAsyncResult que indica o status da operação assíncrona.
Exceções
O CustomChannelBinding e o CustomServiceNames na política de proteção estendida passada no parâmetro policy
são ambos null
.
credential
é null
.
requiredImpersonationLevel
deve ser Identification, Impersonation ou Delegation,
A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.
A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.
A autenticação já ocorreu.
- ou -
Este fluxo foi usado anteriormente para tentar realizar autenticação como o cliente. Você não pode usar o fluxo para tentar novamente a autenticação como servidor.
Este objeto foi fechado.
O parâmetro policy
foi definido como Always em uma plataforma que não dá suporte para proteção estendida.
Não há suporte para Windows 95 e Windows 98.
Comentários
Use o requiredProtectionLevel
parâmetro para solicitar serviços de segurança para dados transmitidos usando o fluxo autenticado. Por exemplo, para ter os dados criptografados e assinados, especifique o EncryptAndSign valor. A autenticação bem-sucedida não garante que o solicitado ProtectionLevel tenha sido concedido. Você deve marcar as IsEncrypted propriedades e IsSigned para determinar quais serviços de segurança são usados pelo NegotiateStream.
Se o policy
parâmetro for null
, uma política de proteção estendida será usada que tenha PolicyEnforcement definido como Never.
Esse método é assíncrono e não bloqueia enquanto a operação é concluída. Para bloquear até que a operação seja concluída, use uma das sobrecargas de AuthenticateAsServer método.
A operação de autenticação assíncrona deve ser concluída chamando o EndAuthenticateAsServer método . Normalmente, o método é invocado pelo asyncCallback
delegado. Para obter informações detalhadas sobre como usar o modelo de programação assíncrona, consulte Chamando métodos síncronos de forma assíncrona
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
BeginAuthenticateAsServer(AsyncCallback, Object)
- Origem:
- NegotiateStream.cs
- Origem:
- NegotiateStream.cs
- Origem:
- NegotiateStream.cs
Chamado por servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. Esse método não bloqueia.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Parâmetros
- asyncCallback
- AsyncCallback
Um representante AsyncCallback que faz referência ao método a ser invocado quando a autenticação é concluída.
- asyncState
- Object
Um objeto definido pelo usuário que contém informações sobre a operação. Esse objeto é passado para o representante asyncCallback
quando a operação é concluída.
Retornos
Um objeto IAsyncResult que indica o status da operação assíncrona.
Exceções
A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.
A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.
Este objeto foi fechado.
Não há suporte para Windows 95 e Windows 98.
Comentários
A autenticação usa o do DefaultCredentialsservidor . 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 é EncryptAndSign.
Quando a autenticação for bem-sucedida, você deverá marcar as IsEncrypted propriedades e IsSigned 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.
Para bloquear até que a operação seja concluída, use uma das sobrecargas de AuthenticateAsServer método.
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
BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object)
- Origem:
- NegotiateStream.cs
- Origem:
- NegotiateStream.cs
- Origem:
- NegotiateStream.cs
Chamado por servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa a política de proteção estendida especificada. Esse 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);
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 -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (policy As ExtendedProtectionPolicy, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Parâmetros
- policy
- ExtendedProtectionPolicy
O ExtendedProtectionPolicy que é usado para proteção estendida.
- asyncCallback
- AsyncCallback
Um representante AsyncCallback que faz referência ao método a ser invocado quando a autenticação é concluída.
- asyncState
- Object
Um objeto definido pelo usuário que contém informações sobre a operação de gravação. Esse objeto é passado para o representante asyncCallback
quando a operação é concluída.
Retornos
Um objeto IAsyncResult que indica o status da operação assíncrona.
Exceções
O CustomChannelBinding e o CustomServiceNames na política de proteção estendida passada no parâmetro policy
são ambos null
.
A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.
A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.
Este objeto foi fechado.
O parâmetro policy
foi definido como Always em uma plataforma que não dá suporte para proteção estendida.
Não há suporte para Windows 95 e Windows 98.
Comentários
A autenticação usa o do DefaultCredentialsservidor . 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 é EncryptAndSign.
Se o policy
parâmetro for null
, uma política de proteção estendida será usada que tenha PolicyEnforcement definido como Never.
Quando a autenticação for bem-sucedida, você deverá marcar as IsEncrypted propriedades e IsSigned 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.
Para bloquear até que a operação seja concluída, use uma das sobrecargas de AuthenticateAsServer método.
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
BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)
- Origem:
- NegotiateStream.cs
- Origem:
- NegotiateStream.cs
- Origem:
- NegotiateStream.cs
Chamado por servidores para iniciar uma operação assíncrona para autenticar o cliente e, opcionalmente, o servidor, em uma conexão de cliente-servidor. O processo de autenticação usa as opções de autenticação e credenciais de servidor especificadas. Esse 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);
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 -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Parâmetros
- credential
- NetworkCredential
O NetworkCredential que é usado para estabelecer a identidade do cliente.
- requiredProtectionLevel
- ProtectionLevel
Um dos valores de ProtectionLevel, que indica os serviços de segurança para o fluxo.
- requiredImpersonationLevel
- TokenImpersonationLevel
Um dos valores de TokenImpersonationLevel, que indica como o servidor pode usar as credenciais do cliente para acessar recursos.
- asyncCallback
- AsyncCallback
Um representante AsyncCallback que faz referência ao método a ser invocado quando a autenticação é concluída.
- asyncState
- Object
Um objeto definido pelo usuário que contém informações sobre a operação. Esse objeto é passado para o representante asyncCallback
quando a operação é concluída.
Retornos
Um objeto IAsyncResult que indica o status da operação assíncrona.
Exceções
credential
é null
.
requiredImpersonationLevel
deve ser Identification, Impersonation ou Delegation,
A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.
A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.
Este objeto foi fechado.
A autenticação já ocorreu.
- ou -
Este fluxo foi usado anteriormente para tentar realizar autenticação como o cliente. Você não pode usar o fluxo para tentar novamente a autenticação como servidor.
Não há suporte para Windows 95 e Windows 98.
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 o solicitado ProtectionLevel tenha sido concedido. Você deve marcar as IsEncrypted propriedades e IsSigned para determinar quais serviços de segurança são usados pelo NegotiateStream.
Esse método é assíncrono e não bloqueia enquanto a operação é concluída. Para bloquear até que a operação seja concluída, use uma das sobrecargas de AuthenticateAsServer método.
A operação de autenticação assíncrona deve ser concluída chamando o EndAuthenticateAsServer método . Normalmente, o método é invocado pelo asyncCallback
delegado. Para obter informações detalhadas sobre como usar o modelo de programação assíncrona, consulte Chamando métodos síncronos de forma assíncrona
Se a autenticação falhar, você receberá um AuthenticationException ou um InvalidCredentialException. Nesse caso, você pode repetir a autenticação com uma credencial diferente.