NegotiateStream.BeginAuthenticateAsServer Método

Referência

Definição

Namespace:: System.Net.Security

Assembly:: System.Net.Security.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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

IAsyncResult

Um objeto IAsyncResult que indica o status da operação assíncrona.

Exceções

ArgumentException

O CustomChannelBinding e o CustomServiceNames na política de proteção estendida passada no parâmetro policy são ambos null.

ArgumentNullException

credential é null.

ArgumentOutOfRangeException

requiredImpersonationLevel deve ser Identification, Impersonation ou Delegation,

AuthenticationException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidCredentialException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidOperationException

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.

ObjectDisposedException

Este objeto foi fechado.

PlatformNotSupportedException

O parâmetro policy foi definido como Always em uma plataforma que não dá suporte para proteção estendida.

NotSupportedException

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

IAsyncResult

Um objeto IAsyncResult que indica o status da operação assíncrona.

Exceções

AuthenticationException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidCredentialException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

ObjectDisposedException

Este objeto foi fechado.

NotSupportedException

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

IAsyncResult

Um objeto IAsyncResult que indica o status da operação assíncrona.

Exceções

ArgumentException

O CustomChannelBinding e o CustomServiceNames na política de proteção estendida passada no parâmetro policy são ambos null.

AuthenticationException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidCredentialException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

ObjectDisposedException

Este objeto foi fechado.

PlatformNotSupportedException

O parâmetro policy foi definido como Always em uma plataforma que não dá suporte para proteção estendida.

NotSupportedException

Não há suporte para Windows 95 e Windows 98.

Comentários

Se o policy parâmetro for null, uma política de proteção estendida será usada que tenha PolicyEnforcement definido como Never.

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

IAsyncResult

Um objeto IAsyncResult que indica o status da operação assíncrona.

Exceções

ArgumentNullException

credential é null.

ArgumentOutOfRangeException

requiredImpersonationLevel deve ser Identification, Impersonation ou Delegation,

AuthenticationException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

InvalidCredentialException

A autenticação falhou. Você pode usar esse objeto para tentar realizar a autenticação novamente.

ObjectDisposedException

Este objeto foi fechado.

InvalidOperationException

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.

NotSupportedException

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.

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

NegotiateStream.BeginAuthenticateAsServer Método

Definição

Sobrecargas

Comentários

BeginAuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

BeginAuthenticateAsServer(AsyncCallback, Object)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Comentários

Recursos adicionais