SslStream.AuthenticateAsServer 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.
Wordt aangeroepen door servers om de server en eventueel de client in een client-serververbinding te verifiëren.
Overloads
| Name | Description |
|---|---|
| AuthenticateAsServer(X509Certificate) |
Aangeroepen door servers om de server en eventueel de client in een client-serververbinding te verifiëren met behulp van het opgegeven certificaat. |
| AuthenticateAsServer(X509Certificate, Boolean, Boolean) |
Wordt aangeroepen door servers om de server en eventueel de client in een clientserververbinding te verifiëren met behulp van de opgegeven certificaten en vereisten en het standaardbeveiligingsprotocol van het systeem. |
| AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean) |
Wordt 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. |
AuthenticateAsServer(X509Certificate)
Aangeroepen door servers om de server en eventueel de client in een client-serververbinding te verifiëren met behulp van het opgegeven certificaat.
public:
virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);
public virtual void AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);
abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit
Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate)
Parameters
- serverCertificate
- X509Certificate
Het certificaat dat wordt gebruikt om de server te verifiëren.
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 AuthenticateAsServer 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). De certificaatintrekkingslijst wordt niet gecontroleerd tijdens verificatie. De client is niet vereist om een certificaat voor verificatie op te geven.
Deze methode blokkeert totdat de bewerking is voltooid. Als u wilt voorkomen dat de bewerking wordt geblokkeerd totdat de bewerking is voltooid, gebruikt u een van de overbelastingen van de BeginAuthenticateAsServer methode.
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.
Van toepassing op
AuthenticateAsServer(X509Certificate, Boolean, Boolean)
Wordt aangeroepen door servers om de server en eventueel de client in een clientserververbinding te verifiëren met behulp van de opgegeven certificaten en vereisten en het standaardbeveiligingsprotocol van het systeem.
public:
virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);
public virtual void AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);
abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit
Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean)
Parameters
- 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.
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 AuthenticateAsServer 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 blokkeert totdat de bewerking is voltooid. Als u wilt voorkomen dat de bewerking wordt geblokkeerd totdat de bewerking is voltooid, gebruikt u een van de overbelastingen van de BeginAuthenticateAsServer methode.
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.
Van toepassing op
AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)
Wordt 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.
public:
virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
public virtual void AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit
Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)
Parameters
- 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.
Uitzonderingen
serverCertificate is null.
enabledSslProtocols is geen geldige SslProtocols waarde.
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 AuthenticateAsServer 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 blokkeert totdat de bewerking is voltooid. Als u wilt voorkomen dat de bewerking wordt geblokkeerd totdat de bewerking is voltooid, gebruikt u een van de overbelastingen van de BeginAuthenticateAsServer methode.
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.