SslStream.AuthenticateAsServerAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Appelé par les serveurs pour authentifier le serveur et éventuellement le client dans une connexion client-serveur en tant qu’opération asynchrone.
Surcharges
| Nom | Description |
|---|---|
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Appelé par les serveurs pour authentifier le serveur et éventuellement le client dans une connexion client-serveur à l’aide des certificats, exigences et protocole de sécurité spécifiés en tant qu’opération asynchrone. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Appelé par les serveurs pour authentifier le serveur et éventuellement le client dans une connexion client-serveur à l’aide des certificats, exigences et protocole de sécurité spécifiés en tant qu’opération asynchrone. |
| AuthenticateAsServerAsync(X509Certificate) |
Appelé par les serveurs pour authentifier le serveur et éventuellement le client dans une connexion client-serveur à l’aide du certificat spécifié en tant qu’opération asynchrone. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Authentifie le serveur et éventuellement le client dans une connexion client-serveur en tant qu’opération asynchrone. Le processus d’authentification utilise des informations spécifiées dans le conteneur de |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
Appelé par les serveurs pour authentifier le serveur et éventuellement le client dans une connexion client-serveur à l’aide des certificats, exigences et protocole de sécurité spécifiés en tant qu’opération asynchrone.
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 TaskParamètres
- serverCertificate
- X509Certificate
X509Certificate utilisé pour authentifier le serveur.
- clientCertificateRequired
- Boolean
Valeur Boolean qui spécifie si le client est invité à demander un certificat pour l’authentification. Notez qu’il s’agit uniquement d’une demande : si aucun certificat n’est fourni, le serveur accepte toujours la demande de connexion.
- enabledSslProtocols
- SslProtocols
Valeur SslProtocols qui représente les protocoles utilisés pour l’authentification.
- checkCertificateRevocation
- Boolean
Valeur Boolean qui spécifie si la liste de révocation de certificats est vérifiée pendant l’authentification.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
serverCertificate a la valeur null.
L’authentification a échoué et laissé cet objet dans un état inutilisable.
L’authentification s’est déjà produite.
-ou-
L’authentification du client à l’aide de celle-ci SslStream a été essayée précédemment.
-ou-
L’authentification est déjà en cours.
Cet objet a été fermé.
Remarques
À compter de .NET Framework 4.7, cette méthode s’authentifie à l’aide Nonedu système d’exploitation, ce qui permet au système d’exploitation de choisir le meilleur protocole à utiliser et de bloquer les protocoles qui ne sont pas sécurisés. Dans .NET Framework 4.6 (et .NET Framework 4.5 avec les derniers correctifs de sécurité installés), les versions autorisées des protocoles TLS/SSL sont 1.2, 1.1 et 1.0 (sauf si vous désactivez le chiffrement fort en modifiant le Registre Windows).
Si l’authentification échoue, vous recevez un AuthenticationException, et cela SslStream n’est plus utilisable. Vous devez fermer cet objet et supprimer toutes les références à cet objet afin qu’il puisse être collecté par le garbage collector.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).
S’applique à
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
Appelé par les serveurs pour authentifier le serveur et éventuellement le client dans une connexion client-serveur à l’aide des certificats, exigences et protocole de sécurité spécifiés en tant qu’opération asynchrone.
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 TaskParamètres
- serverCertificate
- X509Certificate
X509Certificate utilisé pour authentifier le serveur.
- clientCertificateRequired
- Boolean
Valeur Boolean qui spécifie si le client est invité à demander un certificat pour l’authentification. Notez qu’il s’agit uniquement d’une demande : si aucun certificat n’est fourni, le serveur accepte toujours la demande de connexion.
- checkCertificateRevocation
- Boolean
Valeur Boolean qui spécifie si la liste de révocation de certificats est vérifiée pendant l’authentification.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
serverCertificate a la valeur null.
L’authentification a échoué et laissé cet objet dans un état inutilisable.
L’authentification s’est déjà produite.
-ou-
L’authentification du client à l’aide de celle-ci SslStream a été essayée précédemment.
-ou-
L’authentification est déjà en cours.
Cet objet a été fermé.
Remarques
À compter de .NET Framework 4.7, cette méthode s’authentifie à l’aide Nonedu système d’exploitation, ce qui permet au système d’exploitation de choisir le meilleur protocole à utiliser et de bloquer les protocoles qui ne sont pas sécurisés. Dans .NET Framework 4.6 (et .NET Framework 4.5 avec les derniers correctifs de sécurité installés), les versions autorisées des protocoles TLS/SSL sont 1.2, 1.1 et 1.0 (sauf si vous désactivez le chiffrement fort en modifiant le Registre Windows).
Si l’authentification échoue, vous recevez un AuthenticationException, et cela SslStream n’est plus utilisable. Vous devez fermer cet objet et supprimer toutes les références à cet objet afin qu’il puisse être collecté par le garbage collector.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par AuthenticateAsServer(X509Certificate, Boolean, Boolean).
S’applique à
AuthenticateAsServerAsync(X509Certificate)
Appelé par les serveurs pour authentifier le serveur et éventuellement le client dans une connexion client-serveur à l’aide du certificat spécifié en tant qu’opération asynchrone.
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 TaskParamètres
- serverCertificate
- X509Certificate
Certificat utilisé pour authentifier le serveur.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
serverCertificate a la valeur null.
L’authentification a échoué et laissé cet objet dans un état inutilisable.
L’authentification s’est déjà produite.
-ou-
L’authentification du client à l’aide de celle-ci SslStream a été essayée précédemment.
-ou-
L’authentification est déjà en cours.
Cet objet a été fermé.
La méthode AuthenticateAsServerAsync n’est pas prise en charge sur Windows 95, Windows 98 ou Windows Millénaire.
Remarques
À compter de .NET Framework 4.7, cette méthode s’authentifie à l’aide Nonedu système d’exploitation, ce qui permet au système d’exploitation de choisir le meilleur protocole à utiliser et de bloquer les protocoles qui ne sont pas sécurisés. Dans .NET Framework 4.6 (et .NET Framework 4.5 avec les derniers correctifs de sécurité installés), les versions autorisées des protocoles TLS/SSL sont 1.2, 1.1 et 1.0 (sauf si vous désactivez le chiffrement fort en modifiant le Registre Windows).
Cette méthode s’authentifie à l’aide Defaultde . La liste de révocation de certificats n’est pas vérifiée pendant l’authentification. Le client n’est pas tenu de fournir un certificat pour l’authentification.
Si l’authentification échoue, vous recevez un AuthenticationException, et cela SslStream n’est plus utilisable. Vous devez fermer cet objet et supprimer toutes les références à cet objet afin qu’il puisse être collecté par le garbage collector.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par AuthenticateAsServer(X509Certificate).
S’applique à
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
Authentifie le serveur et éventuellement le client dans une connexion client-serveur en tant qu’opération asynchrone. Le processus d’authentification utilise des informations spécifiées dans le conteneur de sslServerAuthenticationOptions propriétés.
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 TaskParamètres
- sslServerAuthenticationOptions
- SslServerAuthenticationOptions
Conteneur de propriétés pour la connexion SSL.
- cancellationToken
- CancellationToken
Jeton à surveiller pour les demandes d’annulation.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
Soit ServerCertificateSelectionCallback ou ServerCertificateServerCertificateContext est et LocalCertificateSelectionCallback n’est null pas défini dans le SslStream constructeur.
sslServerAuthenticationOptions a la valeur null.
L’authentification a échoué et laissé cet objet dans un état inutilisable.
L’authentification s’est déjà produite.
-ou-
L’authentification du client à l’aide de celle-ci SslStream a été essayée précédemment.
-ou-
L’authentification est déjà en cours.
Cet objet a été fermé.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
Remarques
Si l’authentification échoue, vous recevez un AuthenticationException, et cela SslStream n’est plus utilisable. Vous devez fermer cet objet et supprimer toutes les références à cet objet afin qu’il puisse être collecté par le garbage collector.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par AuthenticateAsServer(SslServerAuthenticationOptions).