NegotiateStream.AuthenticateAsServerAsync Metod
Definition
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.
Hanterar serversidan för en autentisering för en klient-server-anslutning som en asynkron åtgärd.
Överlagringar
| Name | Description |
|---|---|
| AuthenticateAsServerAsync() |
Anropas av servrar för att autentisera klienten, och eventuellt servern, i en klient-server-anslutning som en asynkron åtgärd. |
| AuthenticateAsServerAsync(ExtendedProtectionPolicy) |
Anropas av servrar för att autentisera klienten, och eventuellt servern, i en klient-server-anslutning som en asynkron åtgärd. Autentiseringsprocessen använder den angivna utökade skyddsprincipen. |
| AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel) |
Anropas av servrar för att autentisera klienten, och eventuellt servern, i en klient-server-anslutning som en asynkron åtgärd. Autentiseringsprocessen använder de angivna serverautentiseringsuppgifterna och autentiseringsalternativen. |
| AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel) |
Anropas av servrar för att autentisera klienten, och eventuellt servern, i en klient-server-anslutning som en asynkron åtgärd. Autentiseringsprocessen använder de angivna serverautentiseringsuppgifterna, autentiseringsalternativen och den utökade skyddsprincipen. |
AuthenticateAsServerAsync()
Anropas av servrar för att autentisera klienten, och eventuellt servern, i en klient-server-anslutning som en asynkron åtgärd.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync();public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync();abstract member AuthenticateAsServerAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : unit -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync () As TaskReturer
Aktivitetsobjektet som representerar den asynkrona åtgärden.
Undantag
Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.
Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.
Det här objektet har stängts.
Windows 95 och Windows 98 stöds inte.
Kommentarer
Autentiseringen använder serverns DefaultCredentials. Inget SPN (Service Principal Name) har angetts för servern. Personifieringsnivån är Identificationoch säkerhetsnivån är EncryptAndSign.
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.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av AuthenticateAsServer().
Gäller för
AuthenticateAsServerAsync(ExtendedProtectionPolicy)
Anropas av servrar för att autentisera klienten, och eventuellt servern, i en klient-server-anslutning som en asynkron åtgärd. Autentiseringsprocessen använder den angivna utökade skyddsprincipen.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy);abstract member AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (policy As ExtendedProtectionPolicy) As TaskParametrar
- policy
- ExtendedProtectionPolicy
Det ExtendedProtectionPolicy som används för utökat skydd.
Returer
Aktivitetsobjektet som representerar den asynkrona åtgärden.
Undantag
Och CustomChannelBindingCustomServiceNames på den utökade skyddsprincipen som skickas i parametern policy är båda null.
Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.
Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.
Det här objektet har stängts.
Parametern policy har angetts till Always på en plattform som inte stöder utökat skydd.
Windows 95 och Windows 98 stöds inte.
Kommentarer
Autentiseringen använder serverns DefaultCredentials. Inget SPN (Service Principal Name) har angetts för servern. Personifieringsnivån är Identificationoch säkerhetsnivån är EncryptAndSign.
Om parametern policy är nullanvänds en utökad skyddsprincip som har PolicyEnforcement angetts till Never.
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.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av AuthenticateAsServer(ExtendedProtectionPolicy).
Se även
Gäller för
AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)
Anropas av servrar för att autentisera klienten, och eventuellt servern, i en klient-server-anslutning som en asynkron åtgärd. Autentiseringsprocessen använder de angivna serverautentiseringsuppgifterna och autentiseringsalternativen.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As TaskParametrar
- credential
- NetworkCredential
Det NetworkCredential som används för att upprätta serverns identitet.
- requiredProtectionLevel
- ProtectionLevel
Ett av ProtectionLevel värdena som anger säkerhetstjänsterna för dataströmmen.
- requiredImpersonationLevel
- TokenImpersonationLevel
Ett av TokenImpersonationLevel värdena som anger hur servern kan använda klientens autentiseringsuppgifter för att komma åt resurser.
Returer
Aktivitetsobjektet som representerar den asynkrona åtgärden.
Undantag
credential är null.
requiredImpersonationLevel måste vara Identification, Impersonation, eller Delegation,
Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentisera.
Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.
Det här objektet har stängts.
Autentiseringen har redan inträffat.
-eller-
Den här strömmen användes tidigare för att försöka autentisering som klient. Du kan inte använda strömmen för att försöka autentisering igen som server.
Windows 95 och Windows 98 stöds inte.
Kommentarer
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.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av AuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel).
Gäller för
AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)
Anropas av servrar för att autentisera klienten, och eventuellt servern, i en klient-server-anslutning som en asynkron åtgärd. Autentiseringsprocessen använder de angivna serverautentiseringsuppgifterna, autentiseringsalternativen och den utökade skyddsprincipen.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As TaskParametrar
- credential
- NetworkCredential
Det NetworkCredential som används för att fastställa klientens identitet.
- policy
- ExtendedProtectionPolicy
Det ExtendedProtectionPolicy som används för utökat skydd.
- requiredProtectionLevel
- ProtectionLevel
Ett av ProtectionLevel värdena som anger säkerhetstjänsterna för dataströmmen.
- requiredImpersonationLevel
- TokenImpersonationLevel
Ett av TokenImpersonationLevel värdena som anger hur servern kan använda klientens autentiseringsuppgifter för att komma åt resurser.
Returer
Aktivitetsobjektet som representerar den asynkrona åtgärden.
Undantag
Och CustomChannelBindingCustomServiceNames på den utökade skyddsprincipen som skickas i parametern policy är båda null.
credential är null.
requiredImpersonationLevel måste vara Identification, Impersonation, eller Delegation,
Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentisera.
Autentiseringen misslyckades. Du kan använda det här objektet för att försöka autentiseringen igen.
Autentiseringen har redan inträffat.
-eller-
Den här strömmen användes tidigare för att försöka autentisering som klient. Du kan inte använda strömmen för att försöka autentisering igen som server.
Det här objektet har stängts.
Parametern policy har angetts till Always på en plattform som inte stöder utökat skydd.
Windows 95 och Windows 98 stöds inte.
Kommentarer
Om parametern policy är nullanvänds en utökad skyddsprincip som har PolicyEnforcement angetts till Never.
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.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av AuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel).