SslStream.AuthenticateAsServerAsync 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 servers om de server en eventueel de client in een client-serververbinding te verifiëren als asynchrone bewerking.
Overloads
| Name | Description |
|---|---|
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Aangeroepen door servers om de server en eventueel de client in een client-serververbinding te verifiëren met behulp van de opgegeven certificaten, vereisten en beveiligingsprotocol als asynchrone bewerking. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Aangeroepen door servers om de server en eventueel de client in een client-serververbinding te verifiëren met behulp van de opgegeven certificaten, vereisten en beveiligingsprotocol als asynchrone bewerking. |
| AuthenticateAsServerAsync(X509Certificate) |
Aangeroepen door servers om de server en eventueel de client in een client-serververbinding te verifiëren met behulp van het opgegeven certificaat als asynchrone bewerking. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Verifieert de server en eventueel de client in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van gegevens die zijn opgegeven in de |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
Aangeroepen door servers om de server en eventueel de client in een client-serververbinding te verifiëren met behulp van de opgegeven certificaten, vereisten en beveiligingsprotocol als asynchrone bewerking.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParameters
- serverCertificate
- X509Certificate
Het X509Certificate dat wordt gebruikt om de server te verifiëren.
- clientCertificateRequired
- Boolean
Een Boolean waarde die aangeeft of de client wordt gevraagd om een certificaat voor verificatie. Houd er rekening mee dat dit alleen een aanvraag is. Als er geen certificaat is opgegeven, accepteert de server nog steeds de verbindingsaanvraag.
- 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
serverCertificate is null.
De verificatie is mislukt en heeft dit object een onbruikbare status.
Verificatie is al opgetreden.
– of –
Clientverificatie 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).
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 AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
Aangeroepen door servers om de server en eventueel de client in een client-serververbinding te verifiëren met behulp van de opgegeven certificaten, vereisten en beveiligingsprotocol als asynchrone bewerking.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As TaskParameters
- serverCertificate
- X509Certificate
Het X509Certificate dat wordt gebruikt om de server te verifiëren.
- clientCertificateRequired
- Boolean
Een Boolean waarde die aangeeft of de client wordt gevraagd om een certificaat voor verificatie. Houd er rekening mee dat dit alleen een aanvraag is. Als er geen certificaat is opgegeven, accepteert de server nog steeds de verbindingsaanvraag.
- checkCertificateRevocation
- Boolean
Een Boolean waarde die aangeeft of de certificaatintrekkingslijst tijdens de verificatie wordt gecontroleerd.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
serverCertificate is null.
De verificatie is mislukt en heeft dit object een onbruikbare status.
Verificatie is al opgetreden.
– of –
Clientverificatie 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).
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 AuthenticateAsServer(X509Certificate, Boolean, Boolean)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
AuthenticateAsServerAsync(X509Certificate)
Aangeroepen door servers om de server en eventueel de client in een client-serververbinding te verifiëren met behulp van het opgegeven certificaat als asynchrone bewerking.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As TaskParameters
- serverCertificate
- X509Certificate
Het certificaat dat wordt gebruikt om de server te verifiëren.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
serverCertificate is null.
De verificatie is mislukt en heeft dit object een onbruikbare status.
Verificatie is al opgetreden.
– of –
Clientverificatie waarbij dit SslStream wordt gebruikt, is eerder geprobeerd.
– of –
Verificatie wordt al uitgevoerd.
Dit object is gesloten.
De methode AuthenticateAsServerAsync wordt niet ondersteund op Windows 95, Windows 98 of Windows Millennium.
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).
Deze methode wordt geverifieerd met behulp van Default. De certificaatintrekkingslijst wordt niet gecontroleerd tijdens verificatie. De client is niet vereist om een certificaat voor verificatie op te geven.
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 AuthenticateAsServer(X509Certificate)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
Verifieert de server en eventueel de client in een client-serververbinding als asynchrone bewerking. Het verificatieproces maakt gebruik van gegevens die zijn opgegeven in de sslServerAuthenticationOptions eigenschappenverzameling.
public:
System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task AuthenticateAsServerAsync(System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken);member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As TaskParameters
- sslServerAuthenticationOptions
- SslServerAuthenticationOptions
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
Of ServerCertificateSelectionCallback is of ServerCertificateContextServerCertificate is null en LocalCertificateSelectionCallback is niet ingesteld in de SslStream constructor.
sslServerAuthenticationOptions is null.
De verificatie is mislukt en heeft dit object een onbruikbare status.
Verificatie is al opgetreden.
– of –
Clientverificatie 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
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 AuthenticateAsServer(SslServerAuthenticationOptions)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.