SslStream.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.
Verifieer de clientzijde van een client-serververbinding als een asynchrone bewerking.
Overloads
| Name | Description |
|---|---|
| AuthenticateAsClientAsync(String) |
Aangeroepen door clients om de server te verifiëren en optioneel de client in een client-serververbinding als asynchrone bewerking. |
| AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken) |
Aangeroepen door clients om de server te verifiëren en optioneel de client in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van gegevens die zijn opgegeven in de |
| AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean) |
Aangeroepen door clients om de server te verifiëren en optioneel de client in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven certificaatverzameling en het standaard SSL-protocol van het systeem. |
| AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean) |
Aangeroepen door clients om de server te verifiëren en optioneel de client in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven certificaatverzameling en het SSL-protocol. |
AuthenticateAsClientAsync(String)
Aangeroepen door clients om de server te verifiëren en optioneel de client in een client-serververbinding als asynchrone bewerking.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost);abstract member AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String) As TaskParameters
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
targetHost is null.
De verificatie is mislukt en heeft dit object een onbruikbare status.
Verificatie is al opgetreden.
– of –
Serververificatie waarbij dit SslStream wordt gebruikt, is eerder geprobeerd.
– of –
Verificatie wordt al uitgevoerd.
Dit object is gesloten.
Opmerkingen
Vanaf .NET Framework 4.7 verifieert deze methode met behulp van None, waarmee het besturingssysteem het beste protocol kan kiezen en protocollen blokkeert die niet beveiligd zijn. In .NET Framework 4.6 (en .NET Framework 4.5 waarop de nieuwste beveiligingspatches zijn geïnstalleerd), zijn de toegestane versies van TLS/SSL-protocollen 1.2, 1.1 en 1.0 (tenzij u sterke cryptografie uitschakelt door het Windows Register te bewerken). Er worden geen clientcertificaten gebruikt in de verificatie. De certificaatintrekkingslijst wordt niet gecontroleerd tijdens verificatie. De opgegeven targetHost waarde moet overeenkomen met de naam op het certificaat van de server.
Wanneer de verificatie is geslaagd, moet u de IsEncrypted en IsSigned eigenschappen controleren om te bepalen welke beveiligingsservices worden gebruikt door de SslStream. Controleer de IsMutuallyAuthenticated eigenschap om te bepalen of er wederzijdse verificatie is opgetreden.
Als de verificatie mislukt, ontvangt u een AuthenticationException, en dit SslStream kan niet meer worden gebruikt. Sluit dit object en verwijder alle verwijzingen naar het object, zodat het kan worden verzameld door de garbagecollector.
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(String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)
Aangeroepen door clients om de server te verifiëren en optioneel de client in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van gegevens die zijn opgegeven in de sslClientAuthenticationOptions eigenschappenverzameling.
public:
System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task AuthenticateAsClientAsync(System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken);member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, cancellationToken As CancellationToken) As TaskParameters
- sslClientAuthenticationOptions
- SslClientAuthenticationOptions
De eigenschappentas voor de SSL-verbinding.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
sslClientAuthenticationOptions is null.
De verificatie is mislukt en heeft dit object een onbruikbare status.
Verificatie is al opgetreden.
– of –
Serververificatie waarbij dit SslStream wordt gebruikt, is eerder geprobeerd.
– of –
Verificatie wordt al uitgevoerd.
Dit object is gesloten.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Wanneer de verificatie is geslaagd, moet u de IsEncrypted en IsSigned eigenschappen controleren om te bepalen welke beveiligingsservices worden gebruikt door de SslStream. Controleer de IsMutuallyAuthenticated eigenschap om te bepalen of er wederzijdse verificatie is opgetreden.
Als de verificatie mislukt, ontvangt u een AuthenticationException, en dit SslStream kan niet meer worden gebruikt. Sluit dit object en verwijder alle verwijzingen naar het object, zodat het kan worden verzameld door de garbagecollector.
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(SslClientAuthenticationOptions)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)
Aangeroepen door clients om de server te verifiëren en optioneel de client in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven certificaatverzameling en het standaard SSL-protocol van het systeem.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation);abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As TaskParameters
- clientCertificates
- X509CertificateCollection
Het X509CertificateCollection bestand met clientcertificaten.
- checkCertificateRevocation
- Boolean
Een Boolean waarde die aangeeft of de certificaatintrekkingslijst tijdens de verificatie wordt gecontroleerd.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
De verificatie is mislukt en heeft dit object een onbruikbare status.
Verificatie is al opgetreden.
– of –
Serververificatie waarbij dit SslStream wordt gebruikt, is eerder geprobeerd.
– of –
Verificatie wordt al uitgevoerd.
Dit object is gesloten.
Opmerkingen
Vanaf .NET Framework 4.7 verifieert deze methode met behulp van None, waarmee het besturingssysteem het beste protocol kan kiezen en protocollen blokkeert die niet beveiligd zijn. In .NET Framework 4.6 (en .NET Framework 4.5 waarop de nieuwste beveiligingspatches zijn geïnstalleerd), zijn de toegestane versies van TLS/SSL-protocollen 1.2, 1.1 en 1.0 (tenzij u sterke cryptografie uitschakelt door het Windows Register te bewerken).
Wanneer de verificatie is geslaagd, moet u de IsEncrypted en IsSigned eigenschappen controleren om te bepalen welke beveiligingsservices worden gebruikt door de SslStream. Controleer de IsMutuallyAuthenticated eigenschap om te bepalen of er wederzijdse verificatie is opgetreden.
Als de verificatie mislukt, ontvangt u een AuthenticationException, en dit SslStream kan niet meer worden gebruikt. Sluit dit object en verwijder alle verwijzingen naar het object, zodat het kan worden verzameld door de garbagecollector.
Note
Clientcertificaten worden niet ondersteund in het SSL-protocol versie 2.
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(String, X509CertificateCollection, Boolean)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)
Aangeroepen door clients om de server te verifiëren en optioneel de client in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van de opgegeven certificaatverzameling en het SSL-protocol.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParameters
- clientCertificates
- X509CertificateCollection
Het X509CertificateCollection bestand met clientcertificaten.
- enabledSslProtocols
- SslProtocols
De SslProtocols waarde die protocollen vertegenwoordigt die worden gebruikt voor verificatie.
- checkCertificateRevocation
- Boolean
Een Boolean waarde die aangeeft of de certificaatintrekkingslijst tijdens de verificatie wordt gecontroleerd.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
De verificatie is mislukt en heeft dit object een onbruikbare status.
Verificatie is al opgetreden.
– of –
Serververificatie waarbij dit SslStream wordt gebruikt, is eerder geprobeerd.
– of –
Verificatie wordt al uitgevoerd.
Dit object is gesloten.
Opmerkingen
Vanaf .NET Framework 4.7 verifieert deze methode met behulp van None, waarmee het besturingssysteem het beste protocol kan kiezen en protocollen blokkeert die niet beveiligd zijn. In .NET Framework 4.6 (en .NET Framework 4.5 waarop de nieuwste beveiligingspatches zijn geïnstalleerd), zijn de toegestane versies van TLS/SSL-protocollen 1.2, 1.1 en 1.0 (tenzij u sterke cryptografie uitschakelt door het Windows Register te bewerken).
Wanneer de verificatie is geslaagd, moet u de IsEncrypted en IsSigned eigenschappen controleren om te bepalen welke beveiligingsservices worden gebruikt door de SslStream. Controleer de IsMutuallyAuthenticated eigenschap om te bepalen of er wederzijdse verificatie is opgetreden.
Als de verificatie mislukt, ontvangt u een AuthenticationException, en dit SslStream kan niet meer worden gebruikt. Sluit dit object en verwijder alle verwijzingen naar het object, zodat het kan worden verzameld door de garbagecollector.
Note
Clientcertificaten worden niet ondersteund in het SSL-protocol versie 2.
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(String, X509CertificateCollection, SslProtocols, Boolean)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.