NegotiateStream.AuthenticateAsClientAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Aangeroepen door clients om de client te verifiëren, en eventueel de server, in een client-serververbinding als asynchrone bewerking.
Overloads
| Name | Description |
|---|---|
| AuthenticateAsClientAsync() |
Aangeroepen door clients om de client te verifiëren, en eventueel de server, in een client-serververbinding als asynchrone bewerking. |
| AuthenticateAsClientAsync(NetworkCredential, String) |
Aangeroepen door clients om de client te verifiëren, en eventueel de server, in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven clientreferenties. |
| AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String) |
Aangeroepen door clients om de client te verifiëren, en eventueel de server, in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven clientreferenties en de kanaalbinding. |
| AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel) |
Aangeroepen door clients om de client te verifiëren, en eventueel de server, in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven referenties en verificatieopties. |
| AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel) |
Aangeroepen door clients om de client te verifiëren, en eventueel de server, in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven referenties, verificatieopties en kanaalbinding. |
AuthenticateAsClientAsync()
Aangeroepen door clients om de client te verifiëren, en eventueel de server, in een client-serververbinding als asynchrone bewerking.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync();public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync();abstract member AuthenticateAsClientAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : unit -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync () As TaskRetouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
De verificatie is mislukt. U kunt dit object gebruiken om de verificatie opnieuw uit te voeren.
De verificatie is mislukt. U kunt dit object gebruiken om de verificatie opnieuw uit te voeren.
Dit object is gesloten.
Verificatie is al opgetreden.
– of –
Deze stream is eerder gebruikt om verificatie uit te proberen als de server. U kunt de stream niet gebruiken om verificatie opnieuw te proberen als de client.
Opmerkingen
De verificatie maakt gebruik van de client DefaultCredentials. Er is geen SPN (Service Principal Name) opgegeven voor de server. Het imitatieniveau is Identification, het beveiligingsniveau is EncryptAndSignen wederzijdse verificatie wordt aangevraagd. De NegotiateStream klasse maakt de SPN die wordt gebruikt voor wederzijdse verificatie.
Wanneer de verificatie is geslaagd, moet u de IsEncrypted en IsSigned eigenschappen controleren om te bepalen welke beveiligingsservices worden gebruikt door de NegotiateStream. Controleer de IsMutuallyAuthenticated eigenschap om te bepalen of er wederzijdse verificatie is opgetreden.
Als de verificatie mislukt, ontvangt u een AuthenticationException of een InvalidCredentialException. In dit geval kunt u de verificatie opnieuw proberen met een andere referentie.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door AuthenticateAsClient()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
AuthenticateAsClientAsync(NetworkCredential, String)
Aangeroepen door clients om de client te verifiëren, en eventueel de server, in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven clientreferenties.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(System.Net.NetworkCredential credential, string targetName);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String) As TaskParameters
- credential
- NetworkCredential
Dit NetworkCredential wordt gebruikt om de identiteit van de client vast te stellen.
- targetName
- String
De SPN (Service Principal Name) waarmee de server uniek wordt geïdentificeerd om te verifiëren.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
De verificatie is mislukt. U kunt dit object gebruiken om de verificatie opnieuw uit te voeren.
De verificatie is mislukt. U kunt dit object gebruiken om de verificatie opnieuw uit te voeren.
Dit object is gesloten.
Verificatie is al opgetreden.
– of –
Deze stream is eerder gebruikt om verificatie uit te proberen als de server. U kunt de stream niet gebruiken om verificatie opnieuw te proberen als de client.
targetName is null.
Opmerkingen
Het imitatieniveau is Identification, het beveiligingsniveau is EncryptAndSignen wederzijdse verificatie wordt aangevraagd. De NegotiateStream klasse maakt de SPN die wordt gebruikt voor wederzijdse verificatie.
Wanneer de verificatie is geslaagd, moet u de IsEncrypted en IsSigned eigenschappen controleren om te bepalen welke beveiligingsservices worden gebruikt door de NegotiateStream. Controleer de IsMutuallyAuthenticated eigenschap om te bepalen of er wederzijdse verificatie is opgetreden.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door AuthenticateAsClient(NetworkCredential, String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)
Aangeroepen door clients om de client te verifiëren, en eventueel de server, in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven clientreferenties en de kanaalbinding.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String) As TaskParameters
- credential
- NetworkCredential
Dit NetworkCredential wordt gebruikt om de identiteit van de client vast te stellen.
- binding
- ChannelBinding
De ChannelBinding gegevens die worden gebruikt voor uitgebreide beveiliging.
- targetName
- String
De SPN (Service Principal Name) waarmee de server uniek wordt geïdentificeerd om te verifiëren.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
De verificatie is mislukt. U kunt dit object gebruiken om de verificatie opnieuw uit te voeren.
De verificatie is mislukt. U kunt dit object gebruiken om de verificatie opnieuw uit te voeren.
Verificatie is al opgetreden.
– of –
Deze stream is eerder gebruikt om verificatie uit te proberen als de server. U kunt de stream niet gebruiken om verificatie opnieuw te proberen als de client.
Dit object is gesloten.
Opmerkingen
Het imitatieniveau is Identification, het beveiligingsniveau is EncryptAndSignen wederzijdse verificatie wordt aangevraagd. De NegotiateStream klasse maakt de SPN die wordt gebruikt voor wederzijdse verificatie.
De ChannelBinding gebruikte voor uitgebreide beveiliging die wordt doorgegeven aan deze methode in de binding parameter, wordt opgehaald door een toepassing van TransportContext de eigenschap op de bijbehorende SslStreameigenschap.
Wanneer de verificatie is geslaagd, moet u de IsEncrypted en IsSigned eigenschappen controleren om te bepalen welke beveiligingsservices worden gebruikt door de NegotiateStream. Controleer de IsMutuallyAuthenticated eigenschap om te bepalen of er wederzijdse verificatie is opgetreden.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door AuthenticateAsClient(NetworkCredential, ChannelBinding, String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Zie ook
Van toepassing op
AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)
Aangeroepen door clients om de client te verifiëren, en eventueel de server, in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven referenties en verificatieopties.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(System.Net.NetworkCredential credential, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As TaskParameters
- credential
- NetworkCredential
Dit NetworkCredential wordt gebruikt om de identiteit van de client vast te stellen.
- targetName
- String
De SPN (Service Principal Name) waarmee de server uniek wordt geïdentificeerd om te verifiëren.
- requiredProtectionLevel
- ProtectionLevel
Een van de ProtectionLevel waarden die de beveiligingsservices voor de stream aangeeft.
- allowedImpersonationLevel
- TokenImpersonationLevel
Een van de TokenImpersonationLevel waarden die aangeven hoe de server de referenties van de client kan gebruiken voor toegang tot resources.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
allowedImpersonationLevel is geen geldige waarde.
targetName is nul.
De verificatie is mislukt. U kunt dit object gebruiken om de verificatie opnieuw uit te voeren.
De verificatie is mislukt. U kunt dit object gebruiken om de verificatie opnieuw uit te voeren.
Dit object is gesloten.
Verificatie is al opgetreden.
– of –
Deze stream is eerder gebruikt om verificatie uit te proberen als de server. U kunt de stream niet gebruiken om verificatie opnieuw te proberen als de client.
Opmerkingen
Gebruik de requiredProtectionLevel parameter om beveiligingsservices aan te vragen voor gegevens die worden verzonden met behulp van de geverifieerde stream. Als u bijvoorbeeld de gegevens wilt laten versleutelen en ondertekenen, geeft u de EncryptAndSign waarde op. Geslaagde verificatie garandeert niet dat het aangevraagde ProtectionLevel is verleend. U moet de IsEncrypted en IsSigned eigenschappen controleren om te bepalen welke beveiligingsservices worden gebruikt door de NegotiateStream.
Als de verificatie mislukt, ontvangt u een AuthenticationException of een InvalidCredentialException. In dit geval kunt u de verificatie opnieuw proberen met een andere referentie.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door AuthenticateAsClient(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)
Aangeroepen door clients om de client te verifiëren, en eventueel de server, in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven referenties, verificatieopties en kanaalbinding.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(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 System.Threading.Tasks.Task AuthenticateAsClientAsync(System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As TaskParameters
- credential
- NetworkCredential
Dit NetworkCredential wordt gebruikt om de identiteit van de client vast te stellen.
- binding
- ChannelBinding
De ChannelBinding gegevens die worden gebruikt voor uitgebreide beveiliging.
- targetName
- String
De SPN (Service Principal Name) waarmee de server uniek wordt geïdentificeerd om te verifiëren.
- requiredProtectionLevel
- ProtectionLevel
Een van de ProtectionLevel waarden die de beveiligingsservices voor de stream aangeeft.
- allowedImpersonationLevel
- TokenImpersonationLevel
Een van de TokenImpersonationLevel waarden die aangeven hoe de server de referenties van de client kan gebruiken voor toegang tot resources.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
allowedImpersonationLevel is geen geldige waarde.
De verificatie is mislukt. U kunt dit object gebruiken om de verificatie opnieuw uit te voeren.
De verificatie is mislukt. U kunt dit object gebruiken om de verificatie opnieuw uit te voeren.
Verificatie is al opgetreden.
– of –
Deze stream is eerder gebruikt om verificatie uit te proberen als de server. U kunt de stream niet gebruiken om verificatie opnieuw te proberen als de client.
Dit object is gesloten.
Opmerkingen
Gebruik de requiredProtectionLevel parameter om beveiligingsservices aan te vragen voor gegevens die worden verzonden met behulp van de geverifieerde stream. Als u bijvoorbeeld de gegevens wilt laten versleutelen en ondertekenen, geeft u de EncryptAndSign waarde op. Geslaagde verificatie garandeert niet dat het aangevraagde ProtectionLevel is verleend. U moet de IsEncrypted en IsSigned eigenschappen controleren om te bepalen welke beveiligingsservices worden gebruikt door de NegotiateStream.
De ChannelBinding gebruikte voor uitgebreide beveiliging die wordt doorgegeven aan deze methode in de binding parameter, wordt opgehaald door een toepassing van TransportContext de eigenschap op de bijbehorende SslStreameigenschap.
Als de verificatie mislukt, ontvangt u een AuthenticationException of een InvalidCredentialException. In dit geval kunt u de verificatie opnieuw proberen met een andere referentie.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door AuthenticateAsClient(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.