NegotiateStream.AuthenticateAsClient Metod

Definition

Namnområde:: System.Net.Security

Sammansättning:: System.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Anropas av klienter för att autentisera klienten och eventuellt servern i en klient-server-anslutning.

Överlagringar

Name	Description
AuthenticateAsClient()	Anropas av klienter för att autentisera klienten och eventuellt servern i en klient-server-anslutning.
AuthenticateAsClient(NetworkCredential, String)	Anropas av klienter för att autentisera klienten och eventuellt servern i en klient-server-anslutning. Autentiseringsprocessen använder den angivna klientautentiseringsuppgiften.
AuthenticateAsClient(NetworkCredential, ChannelBinding, String)	Anropas av klienter för att autentisera klienten och eventuellt servern i en klient-server-anslutning. Autentiseringsprocessen använder den angivna klientautentiseringsuppgiften och kanalbindningen.
AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)	Anropas av klienter för att autentisera klienten och eventuellt servern i en klient-server-anslutning. Autentiseringsprocessen använder de angivna autentiseringsalternativen och autentiseringsalternativen.
AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)	Anropas av klienter för att autentisera klienten och eventuellt servern i en klient-server-anslutning. Autentiseringsprocessen använder de angivna autentiseringsalternativen, autentiseringsalternativen och kanalbindningen.

AuthenticateAsClient()

Anropas av klienter för att autentisera klienten och eventuellt servern i en klient-server-anslutning.

public:
 virtual void AuthenticateAsClient();

public virtual void AuthenticateAsClient();

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

Public Overridable Sub AuthenticateAsClient ()

Undantag

AuthenticationException

Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.

InvalidCredentialException

Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.

ObjectDisposedException

Det här objektet har stängts.

InvalidOperationException

Autentiseringen har redan inträffat.

-eller-

Den här strömmen användes tidigare för att försöka autentisering som server. Du kan inte använda strömmen för att försöka autentisering igen som klient.

Kommentarer

Autentiseringen använder klientens DefaultCredentials. Inget SPN (Service Principal Name) har angetts för servern. Personifieringsnivån är Identification, säkerhetsnivån är EncryptAndSignoch ömsesidig autentisering begärs. Klassen NegotiateStream konstruerar det SPN som används för ömsesidig autentisering.

När autentiseringen IsEncrypted lyckas måste du kontrollera egenskaperna och IsSigned för att avgöra vilka säkerhetstjänster som används av NegotiateStream. Kontrollera egenskapen IsMutuallyAuthenticated för att avgöra om ömsesidig autentisering har inträffat.

Om autentiseringen misslyckas får du en AuthenticationException eller en InvalidCredentialException. I det här fallet kan du försöka autentiseringen igen med en annan autentiseringsuppgift.

Gäller för

AuthenticateAsClient(NetworkCredential, String)

Anropas av klienter för att autentisera klienten och eventuellt servern i en klient-server-anslutning. Autentiseringsprocessen använder den angivna klientautentiseringsuppgiften.

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)

Parametrar

credential: NetworkCredential

Det NetworkCredential som används för att fastställa klientens identitet.

targetName: String

Tjänstens huvudnamn (SPN) som unikt identifierar servern som ska autentiseras.

Undantag

AuthenticationException

Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.

InvalidCredentialException

Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.

ObjectDisposedException

Det här objektet har stängts.

InvalidOperationException

Autentiseringen har redan inträffat.

-eller-

Den här strömmen användes tidigare för att försöka autentisering som server. Du kan inte använda strömmen för att försöka autentisering igen som klient.

ArgumentNullException

targetName är null.

Kommentarer

Personifieringsnivån är Identification, säkerhetsnivån är EncryptAndSignoch ömsesidig autentisering begärs. Klassen NegotiateStream konstruerar det SPN som används för ömsesidig autentisering.

Gäller för

AuthenticateAsClient(NetworkCredential, ChannelBinding, String)

Anropas av klienter för att autentisera klienten och eventuellt servern i en klient-server-anslutning. Autentiseringsprocessen använder den angivna klientautentiseringsuppgiften och kanalbindningen.

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)

Parametrar

credential: NetworkCredential

Det NetworkCredential som används för att fastställa klientens identitet.

binding: ChannelBinding

Det ChannelBinding som används för utökat skydd.

targetName: String

Tjänstens huvudnamn (SPN) som unikt identifierar servern som ska autentiseras.

Undantag

ArgumentNullException

targetName är null.

-eller-

credential är null.

AuthenticationException

Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.

InvalidCredentialException

Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.

InvalidOperationException

Autentiseringen har redan inträffat.

-eller-

Den här strömmen användes tidigare för att försöka autentisering som server. Du kan inte använda strömmen för att försöka autentisering igen som klient.

ObjectDisposedException

Det här objektet har stängts.

Kommentarer

Den ChannelBinding som används för utökat skydd som skickas till den här metoden i parametern binding hämtas av ett program från TransportContext egenskapen på den associerade SslStream.

Se även

Gäller för

AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Anropas av klienter för att autentisera klienten och eventuellt servern i en klient-server-anslutning. Autentiseringsprocessen använder de angivna autentiseringsalternativen och autentiseringsalternativen.

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)

Parametrar

credential: NetworkCredential

Det NetworkCredential som används för att fastställa klientens identitet.

targetName: String

Tjänstens huvudnamn (SPN) som unikt identifierar servern som ska autentiseras.

requiredProtectionLevel: ProtectionLevel

Ett av ProtectionLevel värdena som anger säkerhetstjänsterna för dataströmmen.

allowedImpersonationLevel: TokenImpersonationLevel

Ett av TokenImpersonationLevel värdena som anger hur servern kan använda klientens autentiseringsuppgifter för att komma åt resurser.

Undantag

ArgumentOutOfRangeException

allowedImpersonationLevel är inte ett giltigt värde.

ArgumentNullException

targetName är null.

AuthenticationException

Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.

InvalidCredentialException

Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.

ObjectDisposedException

Det här objektet har stängts.

InvalidOperationException

Autentiseringen har redan inträffat.

-eller-

Den här strömmen användes tidigare för att försöka autentisering som server. Du kan inte använda strömmen för att försöka autentisering igen som klient.

Kommentarer

Använd parametern requiredProtectionLevel för att begära säkerhetstjänster för data som överförs med hjälp av den autentiserade dataströmmen. Om du till exempel vill att data ska krypteras och signeras anger du EncryptAndSign värdet. Lyckad autentisering garanterar inte att den begärda ProtectionLevel har beviljats. Du måste kontrollera IsEncrypted egenskaperna och IsSigned för att avgöra vilka säkerhetstjänster som används av NegotiateStream.

Om autentiseringen misslyckas får du en AuthenticationException eller en InvalidCredentialException. I det här fallet kan du försöka autentiseringen igen med en annan autentiseringsuppgift.

Gäller för

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

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)

Parametrar

credential: NetworkCredential

Det NetworkCredential som används för att fastställa klientens identitet.

binding: ChannelBinding

Det ChannelBinding som används för utökat skydd.

targetName: String

Tjänstens huvudnamn (SPN) som unikt identifierar servern som ska autentiseras.

requiredProtectionLevel: ProtectionLevel

Ett av ProtectionLevel värdena som anger säkerhetstjänsterna för dataströmmen.

allowedImpersonationLevel: TokenImpersonationLevel

Ett av TokenImpersonationLevel värdena som anger hur servern kan använda klientens autentiseringsuppgifter för att komma åt resurser.

Undantag

ArgumentNullException

targetName är null.

-eller-

credential är null.

ArgumentOutOfRangeException

allowedImpersonationLevel är inte ett giltigt värde.

AuthenticationException

Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.

InvalidCredentialException

Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.

InvalidOperationException

Autentiseringen har redan inträffat.

-eller-

Den här strömmen användes tidigare för att försöka autentisering som server. Du kan inte använda strömmen för att försöka autentisering igen som klient.

ObjectDisposedException

Det här objektet har stängts.

Kommentarer

Den ChannelBinding som används för utökat skydd som skickas till den här metoden i parametern binding hämtas av ett program från TransportContext egenskapen på den associerade SslStream.

Om autentiseringen misslyckas får du en AuthenticationException eller en InvalidCredentialException. I det här fallet kan du försöka autentiseringen igen med en annan autentiseringsuppgift.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?