Udostępnij za pośrednictwem

NegotiateStream.BeginAuthenticateAsServer Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net.Security
Zestaw:
System.Net.Security.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll

Rozpoczyna operację asynchroniczną w celu obsługi po stronie serwera uwierzytelniania połączenia klient-serwer.

Przeciążenia

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

Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klient-serwer. Proces uwierzytelniania używa określonych poświadczeń serwera, opcji uwierzytelniania i zasad rozszerzonej ochrony. Ta metoda nie blokuje.
BeginAuthenticateAsServer(AsyncCallback, Object)

Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klient-serwer. Ta metoda nie blokuje.
BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object)

Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klient-serwer. Proces uwierzytelniania używa określonych zasad ochrony rozszerzonej. Ta metoda nie blokuje.
BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)

Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klient-serwer. Proces uwierzytelniania używa określonych poświadczeń serwera i opcji uwierzytelniania. Ta metoda nie blokuje.

Uwagi

Przeciążenia tej metody nie blokują się, gdy uwierzytelnianie jest w toku. Aby zablokować podczas oczekiwania na ukończenie uwierzytelniania, użyj AuthenticateAsServer metody .

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

Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs

Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klient-serwer. Proces uwierzytelniania używa określonych poświadczeń serwera, opcji uwierzytelniania i zasad rozszerzonej ochrony. Ta metoda nie blokuje.

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

Parametry

credential
NetworkCredential

Służy NetworkCredential do ustanawiania tożsamości klienta.

policy
ExtendedProtectionPolicy

Służy ExtendedProtectionPolicy do rozszerzonej ochrony.

requiredProtectionLevel
ProtectionLevel

ProtectionLevel Jedna z wartości wskazująca usługi zabezpieczeń dla strumienia.

requiredImpersonationLevel
TokenImpersonationLevel

TokenImpersonationLevel Jedna z wartości wskazująca, jak serwer może używać poświadczeń klienta do uzyskiwania dostępu do zasobów.

asyncCallback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu uwierzytelniania.

asyncState
Object

Obiekt zdefiniowany przez użytkownika zawierający informacje o operacji zapisu. Ten obiekt jest przekazywany do delegata po zakończeniu asyncCallback operacji.

Zwraca

IAsyncResult

IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.

Wyjątki

ArgumentException

Wartości i CustomChannelBindingCustomServiceNames w zasadach rozszerzonej ochrony przekazanych w parametrze policy to .null

ArgumentNullException

credential to null.

ArgumentOutOfRangeException

requiredImpersonationLevel musi mieć Identificationwartość , Impersonationlub Delegation,

AuthenticationException

Uwierzytelnianie nie powiodło się. Tego obiektu można użyć do ponawiania próby uwierzytelnienia.

InvalidCredentialException

Uwierzytelnianie nie powiodło się. Tego obiektu można użyć do ponawiania próby uwierzytelnienia.

InvalidOperationException

Uwierzytelnianie już wystąpiło.

-lub-

Ten strumień był wcześniej używany do próby uwierzytelnienia jako klienta. Nie można użyć strumienia, aby ponowić próbę uwierzytelnienia jako serwera.

ObjectDisposedException

Ten obiekt został zamknięty.

PlatformNotSupportedException

Parametr policy został ustawiony Always na wartość na platformie, która nie obsługuje rozszerzonej ochrony.

NotSupportedException

Systemy Windows 95 i Windows 98 nie są obsługiwane.

Uwagi

Użyj parametru , requiredProtectionLevel aby zażądać usług zabezpieczeń dla danych przesyłanych przy użyciu uwierzytelnionego strumienia. Na przykład aby dane były zaszyfrowane i podpisane, określ EncryptAndSign wartość . Pomyślne uwierzytelnienie nie gwarantuje, że żądanie ProtectionLevel zostało przyznane. Należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę NegotiateStream.

policy Jeśli parametr ma nullwartość , używane są zasady ochrony rozszerzonej, które mają PolicyEnforcement ustawioną wartość Never.

Ta metoda jest asynchroniczna i nie blokuje jej podczas wykonywania operacji. Aby zablokować operację do czasu zakończenia operacji, użyj jednego z AuthenticateAsServer przeciążeń metody.

Operacja uwierzytelniania asynchronicznego musi zostać ukończona przez wywołanie EndAuthenticateAsServer metody . Zazwyczaj metoda jest wywoływana przez delegata asyncCallback . Aby uzyskać szczegółowe informacje na temat korzystania z modelu programowania asynchronicznego, zobacz Asynchroniczne wywoływanie metod synchronicznych

Jeśli uwierzytelnianie zakończy się niepowodzeniem, otrzymasz element AuthenticationExceptionInvalidCredentialExceptionlub . W takim przypadku można ponowić próbę uwierzytelnienia przy użyciu innego poświadczenia.

Zobacz też

Dotyczy

BeginAuthenticateAsServer(AsyncCallback, Object)

Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs

Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klient-serwer. Ta metoda nie blokuje.

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

Parametry

asyncCallback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu uwierzytelniania.

asyncState
Object

Obiekt zdefiniowany przez użytkownika zawierający informacje o operacji. Ten obiekt jest przekazywany do delegata po zakończeniu asyncCallback operacji.

Zwraca

IAsyncResult

IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.

Wyjątki

AuthenticationException

Uwierzytelnianie nie powiodło się. Tego obiektu można użyć do ponawiania próby uwierzytelnienia.

InvalidCredentialException

Uwierzytelnianie nie powiodło się. Tego obiektu można użyć do ponawiania próby uwierzytelnienia.

ObjectDisposedException

Ten obiekt został zamknięty.

NotSupportedException

Systemy Windows 95 i Windows 98 nie są obsługiwane.

Uwagi

Uwierzytelnianie używa serwera DefaultCredentials. Dla serwera nie określono nazwy głównej usługi (SPN). Poziom personifikacji to Identification, poziom zabezpieczeń to EncryptAndSign.

Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę NegotiateStream. Sprawdź właściwość , IsMutuallyAuthenticated aby określić, czy wystąpiło wzajemne uwierzytelnianie.

Aby zablokować operację do czasu zakończenia operacji, użyj jednego z AuthenticateAsServer przeciążeń metody.

Jeśli uwierzytelnianie zakończy się niepowodzeniem, otrzymasz element AuthenticationExceptionInvalidCredentialExceptionlub . W takim przypadku można ponowić próbę uwierzytelnienia przy użyciu innego poświadczenia.

Dotyczy

BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object)

Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs

Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klient-serwer. Proces uwierzytelniania używa określonych zasad ochrony rozszerzonej. Ta metoda nie blokuje.

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

Parametry

policy
ExtendedProtectionPolicy

Służy ExtendedProtectionPolicy do rozszerzonej ochrony.

asyncCallback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu uwierzytelniania.

asyncState
Object

Obiekt zdefiniowany przez użytkownika zawierający informacje o operacji zapisu. Ten obiekt jest przekazywany do delegata po zakończeniu asyncCallback operacji.

Zwraca

IAsyncResult

IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.

Wyjątki

ArgumentException

Wartości i CustomChannelBindingCustomServiceNames w zasadach rozszerzonej ochrony przekazanych w parametrze policy to .null

AuthenticationException

Uwierzytelnianie nie powiodło się. Tego obiektu można użyć do ponawiania próby uwierzytelnienia.

InvalidCredentialException

Uwierzytelnianie nie powiodło się. Tego obiektu można użyć do ponawiania próby uwierzytelnienia.

ObjectDisposedException

Ten obiekt został zamknięty.

PlatformNotSupportedException

Parametr policy został ustawiony Always na wartość na platformie, która nie obsługuje rozszerzonej ochrony.

NotSupportedException

Systemy Windows 95 i Windows 98 nie są obsługiwane.

Uwagi

Uwierzytelnianie używa serwera DefaultCredentials. Dla serwera nie określono nazwy głównej usługi (SPN). Poziom personifikacji to Identification, poziom zabezpieczeń to EncryptAndSign.

policy Jeśli parametr ma nullwartość , używane są zasady ochrony rozszerzonej, które mają PolicyEnforcement ustawioną wartość Never.

Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę NegotiateStream. Sprawdź właściwość , IsMutuallyAuthenticated aby określić, czy wystąpiło wzajemne uwierzytelnianie.

Aby zablokować operację do czasu zakończenia operacji, użyj jednego z AuthenticateAsServer przeciążeń metody.

Jeśli uwierzytelnianie zakończy się niepowodzeniem, otrzymasz element AuthenticationExceptionInvalidCredentialExceptionlub . W takim przypadku można ponowić próbę uwierzytelnienia przy użyciu innego poświadczenia.

Zobacz też

Dotyczy

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

Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs
Źródło:
NegotiateStream.cs

Wywoływane przez serwery w celu rozpoczęcia operacji asynchronicznej w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klient-serwer. Proces uwierzytelniania używa określonych poświadczeń serwera i opcji uwierzytelniania. Ta metoda nie blokuje.

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

Parametry

credential
NetworkCredential

Służy NetworkCredential do ustanawiania tożsamości klienta.

requiredProtectionLevel
ProtectionLevel

ProtectionLevel Jedna z wartości wskazująca usługi zabezpieczeń dla strumienia.

requiredImpersonationLevel
TokenImpersonationLevel

TokenImpersonationLevel Jedna z wartości wskazująca, jak serwer może używać poświadczeń klienta do uzyskiwania dostępu do zasobów.

asyncCallback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu uwierzytelniania.

asyncState
Object

Obiekt zdefiniowany przez użytkownika zawierający informacje o operacji. Ten obiekt jest przekazywany do delegata po zakończeniu asyncCallback operacji.

Zwraca

IAsyncResult

IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.

Wyjątki

ArgumentNullException

credential to null.

ArgumentOutOfRangeException

requiredImpersonationLevel musi mieć Identificationwartość , Impersonationlub Delegation,

AuthenticationException

Uwierzytelnianie nie powiodło się. Tego obiektu można użyć do ponawiania próby uwierzytelnienia.

InvalidCredentialException

Uwierzytelnianie nie powiodło się. Tego obiektu można użyć do ponawiania próby uwierzytelnienia.

ObjectDisposedException

Ten obiekt został zamknięty.

InvalidOperationException

Uwierzytelnianie już wystąpiło.

-lub-

Ten strumień był wcześniej używany do próby uwierzytelnienia jako klienta. Nie można użyć strumienia, aby ponowić próbę uwierzytelnienia jako serwera.

NotSupportedException

Systemy Windows 95 i Windows 98 nie są obsługiwane.

Uwagi

Użyj parametru , requiredProtectionLevel aby zażądać usług zabezpieczeń dla danych przesyłanych przy użyciu uwierzytelnionego strumienia. Na przykład aby dane były zaszyfrowane i podpisane, określ EncryptAndSign wartość . Pomyślne uwierzytelnienie nie gwarantuje, że żądanie ProtectionLevel zostało przyznane. Należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę NegotiateStream.

Ta metoda jest asynchroniczna i nie blokuje jej podczas wykonywania operacji. Aby zablokować operację do czasu zakończenia operacji, użyj jednego z AuthenticateAsServer przeciążeń metody.

Operacja uwierzytelniania asynchronicznego musi zostać ukończona przez wywołanie EndAuthenticateAsServer metody . Zazwyczaj metoda jest wywoływana przez delegata asyncCallback . Aby uzyskać szczegółowe informacje na temat korzystania z modelu programowania asynchronicznego, zobacz Asynchroniczne wywoływanie metod synchronicznych

Jeśli uwierzytelnianie zakończy się niepowodzeniem, otrzymasz element AuthenticationExceptionInvalidCredentialExceptionlub . W takim przypadku można ponowić próbę uwierzytelnienia przy użyciu innego poświadczenia.

Dotyczy