NegotiateStream.AuthenticateAsClient Metoda

Definicja

Przestrzeń nazw:

System.Net.Security

Zestaw:

System.Net.Security.dll

Wywoływane przez klientów w celu uwierzytelniania klienta i opcjonalnie serwera w połączeniu klient-serwer.

Przeciążenia

AuthenticateAsClient()	Wywoływane przez klientów w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klienta-serwera.
AuthenticateAsClient(NetworkCredential, String)	Wywoływane przez klientów w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klienta-serwera. Proces uwierzytelniania używa określonego poświadczenia klienta.
AuthenticateAsClient(NetworkCredential, ChannelBinding, String)	Wywoływane przez klientów w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klienta-serwera. Proces uwierzytelniania używa określonego poświadczenia klienta i powiązania kanału.
AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)	Wywoływane przez klientów w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klienta-serwera. Proces uwierzytelniania używa określonych poświadczeń i opcji uwierzytelniania.
AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)	Wywoływane przez klientów w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klienta-serwera. Proces uwierzytelniania używa określonych poświadczeń, opcji uwierzytelniania i powiązania kanału.

AuthenticateAsClient()

Źródło:

NegotiateStream.cs

Wywoływane przez klientów w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klienta-serwera.

public:
 virtual void AuthenticateAsClient();

public virtual void AuthenticateAsClient ();

abstract member AuthenticateAsClient : unit -> unit
override this.AuthenticateAsClient : unit -> unit

Public Overridable Sub AuthenticateAsClient ()

Wyjątki

AuthenticationException

Uwierzytelnianie nie powiodło się. Możesz użyć tego obiektu, aby ponowić próbę uwierzytelnienia.

InvalidCredentialException

Uwierzytelnianie nie powiodło się. Możesz użyć tego obiektu, aby ponowić próbę uwierzytelnienia.

ObjectDisposedException

Ten obiekt został zamknięty.

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

-lub-

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

Uwagi

Uwierzytelnianie używa klienta DefaultCredentials. Dla serwera nie określono nazwy głównej usługi (SPN). Poziom personifikacji to , poziom zabezpieczeń to IdentificationEncryptAndSign, a żądanie wzajemnego uwierzytelniania. Klasa NegotiateStream skonstruuje nazwę SPN używaną do wzajemnego uwierzytelniania.

Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, jakie usługi zabezpieczeń są używane przez usługę NegotiateStream. Sprawdź właściwość, IsMutuallyAuthenticated aby określić, czy doszło do wzajemnego uwierzytelniania.

Jeśli uwierzytelnianie zakończy się niepowodzeniem, zostanie wyświetlony element AuthenticationException lub .InvalidCredentialException W takim przypadku możesz ponowić próbę uwierzytelnienia przy użyciu innego poświadczenia.

AuthenticateAsClient(NetworkCredential, String)

Źródło:

NegotiateStream.cs

Wywoływane przez klientów w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klienta-serwera. Proces uwierzytelniania używa określonego poświadczenia klienta.

public:
 virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::String ^ targetName);

public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, string targetName);

abstract member AuthenticateAsClient : System.Net.NetworkCredential * string -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * string -> unit

Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, targetName As String)

Parametry

credential

NetworkCredential

Element NetworkCredential służący do ustanawiania tożsamości klienta.

targetName

String

Główna nazwa usługi (SPN), która jednoznacznie identyfikuje serwer do uwierzytelnienia.

Wyjątki

AuthenticationException

Uwierzytelnianie nie powiodło się. Możesz użyć tego obiektu, aby ponowić próbę uwierzytelnienia.

InvalidCredentialException

Uwierzytelnianie nie powiodło się. Możesz użyć tego obiektu, aby ponowić próbę uwierzytelnienia.

ObjectDisposedException

Ten obiekt został zamknięty.

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

-lub-

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

ArgumentNullException

targetName to null.

Uwagi

Poziom personifikacji to , poziom zabezpieczeń to IdentificationEncryptAndSign, a żądanie wzajemnego uwierzytelniania. Klasa NegotiateStream skonstruuje nazwę SPN używaną do wzajemnego uwierzytelniania.

Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, jakie usługi zabezpieczeń są używane przez usługę NegotiateStream. Sprawdź właściwość, IsMutuallyAuthenticated aby określić, czy doszło do wzajemnego uwierzytelniania.

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

Źródło:

NegotiateStream.cs

Wywoływane przez klientów w celu uwierzytelnienia klienta i opcjonalnie serwera w połączeniu klienta-serwera. Proces uwierzytelniania używa określonego poświadczenia klienta i powiązania kanału.

public:
 virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName);

public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName);

abstract member AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> unit

Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, binding As ChannelBinding, targetName As String)

Parametry

credential

NetworkCredential

Element NetworkCredential służący do ustanawiania tożsamości klienta.

binding

ChannelBinding

Element ChannelBinding , który jest używany do rozszerzonej ochrony.

targetName

String

Główna nazwa usługi (SPN), która jednoznacznie identyfikuje serwer do uwierzytelnienia.

Wyjątki

ArgumentNullException

targetName to null.

-lub-

credential to null.

AuthenticationException

Uwierzytelnianie nie powiodło się. Możesz użyć tego obiektu, aby ponowić próbę uwierzytelnienia.

InvalidCredentialException

Uwierzytelnianie nie powiodło się. Możesz użyć tego obiektu, aby ponowić próbę uwierzytelnienia.

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

-lub-

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

ObjectDisposedException

Ten obiekt został zamknięty.

Uwagi

Poziom personifikacji to , poziom zabezpieczeń to IdentificationEncryptAndSign, a żądanie wzajemnego uwierzytelniania. Klasa NegotiateStream skonstruuje nazwę SPN używaną do wzajemnego uwierzytelniania.

Używana ChannelBinding do rozszerzonej ochrony przekazywanej do tej metody w parametrze binding zostanie pobrana przez aplikację z właściwości skojarzonej z TransportContext programem SslStream.

Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, jakie usługi zabezpieczeń są używane przez usługę NegotiateStream. Sprawdź właściwość, IsMutuallyAuthenticated aby określić, czy doszło do wzajemnego uwierzytelniania.

Zobacz też

• ChannelBinding
• Zintegrowane uwierzytelnianie systemu Windows z ochroną rozszerzoną

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Źródło:

NegotiateStream.cs

Wywoływane przez klientów w celu uwierzytelniania klienta i opcjonalnie serwera w połączeniu klient-serwer. Proces uwierzytelniania używa określonych poświadczeń i opcji uwierzytelniania.

public:
 virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);

public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

abstract member AuthenticateAsClient : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit

Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel)

Parametry

credential

NetworkCredential

Element NetworkCredential służący do ustanawiania tożsamości klienta.

targetName

String

Główna nazwa usługi (SPN), która jednoznacznie identyfikuje serwer do uwierzytelnienia.

requiredProtectionLevel

ProtectionLevel

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

allowedImpersonationLevel

TokenImpersonationLevel

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

Wyjątki

ArgumentOutOfRangeException

allowedImpersonationLevel jest nieprawidłową wartością.

ArgumentNullException

targetName ma wartość null.

AuthenticationException

Uwierzytelnianie nie powiodło się. Możesz użyć tego obiektu, aby ponowić próbę uwierzytelnienia.

InvalidCredentialException

Uwierzytelnianie nie powiodło się. Możesz użyć tego obiektu, aby ponowić próbę uwierzytelnienia.

ObjectDisposedException

Ten obiekt został zamknięty.

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

-lub-

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

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 szyfrowane i podpisane, określ EncryptAndSign wartość. Pomyślne uwierzytelnienie nie gwarantuje udzielenia żądanego ProtectionLevel uwierzytelniania. Należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, jakie usługi zabezpieczeń są używane przez usługę NegotiateStream.

Jeśli uwierzytelnianie zakończy się niepowodzeniem, zostanie wyświetlony element AuthenticationException lub .InvalidCredentialException W takim przypadku można ponowić próbę uwierzytelnienia przy użyciu innego poświadczenia.

AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)

Źródło:

NegotiateStream.cs

Wywoływane przez klientów w celu uwierzytelniania klienta i opcjonalnie serwera w połączeniu klient-serwer. Proces uwierzytelniania używa określonych poświadczeń, opcji uwierzytelniania i powiązania kanału.

public:
 virtual void AuthenticateAsClient(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);

public virtual void AuthenticateAsClient (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

abstract member AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit
override this.AuthenticateAsClient : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> unit

Public Overridable Sub AuthenticateAsClient (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel)

Parametry

credential

NetworkCredential

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

binding

ChannelBinding

Służy ChannelBinding do rozszerzonej ochrony.

targetName

String

Główna nazwa usługi (SPN), która jednoznacznie identyfikuje serwer do uwierzytelnienia.

requiredProtectionLevel

ProtectionLevel

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

allowedImpersonationLevel

TokenImpersonationLevel

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

Wyjątki

ArgumentNullException

targetName to null.

-lub-

credential to null.

ArgumentOutOfRangeException

allowedImpersonationLevel jest nieprawidłową wartością.

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 serwera. Nie można użyć strumienia, aby ponowić próbę uwierzytelnienia jako klienta.

ObjectDisposedException

Ten obiekt został zamknięty.

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 udzielenia żądanego ProtectionLevel . 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.

Używana ChannelBinding do rozszerzonej ochrony przekazanej do tej metody w parametrze binding zostanie pobrana przez aplikację z właściwości skojarzonej SslStreamz TransportContext programem .

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ż

• ChannelBinding
• Zintegrowane uwierzytelnianie systemu Windows z ochroną rozszerzoną