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 sous forme d'opération asynchrone.
Surcharges
| 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 spécifiés, de la configuration requise et du protocole de sécurité au cours d’une 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 spécifiés, de la configuration requise et du protocole de sécurité au cours d’une opération asynchrone. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Appelé par les serveurs pour authentifier le serveur, et éventuellement le client, dans une connexion client-serveur sous forme d'opération asynchrone. Le processus d’authentification utilise les informations spécifiées dans le conteneur de propriétés |
| AuthenticateAsServerAsync(X509Certificate) |
Appelé par les serveurs pour authentifier le serveur, et éventuellement le client, dans une connexion client-serveur en utilisant le certificat spécifié sous forme d'opération asynchrone. |
| AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken) |
Appelé par les serveurs pour authentifier le serveur, et éventuellement le client, dans une connexion client-serveur sous forme d'opération asynchrone. Le processus d’authentification utilise les informations retournées par |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Appelé par les serveurs pour authentifier le serveur et éventuellement le client dans une connexion client-serveur à l’aide des certificats spécifiés, de la configuration requise et du protocole de sécurité au cours d’une 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
Le X509Certificate utilisé pour authentifier le serveur.
- clientCertificateRequired
- Boolean
Valeur Boolean qui spécifie si le client est invité à fournir un certificat d’authentification. Notez qu’il s’agit uniquement d’une demande : si aucun certificat n’est fourni, le serveur accepte tout de même la demande de connexion.
- enabledSslProtocols
- SslProtocols
Valeur SslProtocols qui représente des protocoles utilisés pour l'authentification.
- checkCertificateRevocation
- Boolean
Valeur Boolean qui spécifie si la liste de révocation des 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 a laissé cet objet dans un état inutilisable.
L’authentification a déjà eu lieu.
- ou -
L’authentification du client avec ce SslStream a déjà été tentée.
- ou -
L’authentification est déjà en cours.
L’objet a été fermé.
Remarques
À compter du NET Framework 4.7, cette méthode authentifie avec None, 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 le .NET Framework 4.6 (et le .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, qui SslStream n’est plus utilisable. Vous devez fermer cet objet et supprimer toutes les références à celui-ci afin qu’il puisse être collecté par le récupérateur de mémoire.
Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).
S’applique à
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Appelé par les serveurs pour authentifier le serveur et éventuellement le client dans une connexion client-serveur à l’aide des certificats spécifiés, de la configuration requise et du protocole de sécurité au cours d’une 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
Le X509Certificate utilisé pour authentifier le serveur.
- clientCertificateRequired
- Boolean
Valeur Boolean qui spécifie si le client est invité à fournir un certificat d’authentification. Notez qu’il s’agit uniquement d’une demande : si aucun certificat n’est fourni, le serveur accepte tout de même la demande de connexion.
- checkCertificateRevocation
- Boolean
Valeur Boolean qui spécifie si la liste de révocation des 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 a laissé cet objet dans un état inutilisable.
L’authentification a déjà eu lieu.
- ou -
L’authentification du client avec ce SslStream a déjà été tentée.
- ou -
L’authentification est déjà en cours.
L’objet a été fermé.
Remarques
À compter du NET Framework 4.7, cette méthode authentifie avec None, 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 le .NET Framework 4.6 (et le .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, qui SslStream n’est plus utilisable. Vous devez fermer cet objet et supprimer toutes les références à celui-ci afin qu’il puisse être collecté par le récupérateur de mémoire.
Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par AuthenticateAsServer(X509Certificate, Boolean, Boolean).
S’applique à
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Appelé par les serveurs pour authentifier le serveur, et éventuellement le client, dans une connexion client-serveur sous forme d'opération asynchrone. Le processus d’authentification utilise les informations spécifiées dans le conteneur de propriétés sslClientAuthenticationOptions.
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 = default);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, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As TaskParamètres
- sslServerAuthenticationOptions
- SslServerAuthenticationOptions
Le conteneur des propriétés pour la connexion SSL.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
ServerCertificateSelectionCallback ou ServerCertificate ou ServerCertificateContext est null, et LocalCertificateSelectionCallback n’est pas défini dans le constructeur SslStream.
sslServerAuthenticationOptions a la valeur null.
L’authentification a échoué et a laissé cet objet dans un état inutilisable.
L’authentification a déjà eu lieu.
- ou -
L’authentification du client avec ce SslStream a déjà été tentée.
- ou -
L’authentification est déjà en cours.
L’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, qui SslStream n’est plus utilisable. Vous devez fermer cet objet et supprimer toutes les références à celui-ci afin qu’il puisse être collecté par le récupérateur de mémoire.
Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par AuthenticateAsServer(SslServerAuthenticationOptions).
S’applique à
AuthenticateAsServerAsync(X509Certificate)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Appelé par les serveurs pour authentifier le serveur, et éventuellement le client, dans une connexion client-serveur en utilisant le certificat spécifié sous forme d'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 a laissé cet objet dans un état inutilisable.
L’authentification a déjà eu lieu.
- ou -
L’authentification du client avec ce SslStream a déjà été tentée.
- ou -
L’authentification est déjà en cours.
L’objet a été fermé.
La méthode AuthenticateAsServerAsync n’est pas prise en charge sur Windows 95, Windows 98 et Windows Millennium.
Remarques
À compter du NET Framework 4.7, cette méthode authentifie avec None, 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 le .NET Framework 4.6 (et le .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 de Default. La liste de révocation des certificats n’est pas vérifiée lors de l’authentification. Le client n’est pas tenu de fournir un certificat pour l’authentification.
Si l’authentification échoue, vous recevez un AuthenticationException, qui SslStream n’est plus utilisable. Vous devez fermer cet objet et supprimer toutes les références à celui-ci afin qu’il puisse être collecté par le garbage collector.
Cette méthode stocke dans la tâche toutes les exceptions de 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 sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par AuthenticateAsServer(X509Certificate).
S’applique à
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Appelé par les serveurs pour authentifier le serveur, et éventuellement le client, dans une connexion client-serveur sous forme d'opération asynchrone. Le processus d’authentification utilise les informations retournées par optionsCallback.
public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.ServerOptionsSelectionCallback optionsCallback, object? state, System.Threading.CancellationToken cancellationToken = default);member this.AuthenticateAsServerAsync : System.Net.Security.ServerOptionsSelectionCallback * obj * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As TaskParamètres
- optionsCallback
- ServerOptionsSelectionCallback
Le délégué de rappel.
- state
- Object
Objet d’état à passer à optionsCallback lorsque le rappel est appelé.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
ServerCertificateSelectionCallback ou ServerCertificate ou ServerCertificateContext est null, et LocalCertificateSelectionCallback n’est pas défini dans le constructeur SslStream.
L’authentification a échoué et a laissé cet objet dans un état inutilisable.
L’authentification a déjà eu lieu.
- ou -
L’authentification du client avec ce SslStream a déjà été tentée.
- ou -
L’authentification est déjà en cours.
L’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, qui SslStream n’est plus utilisable. Vous devez fermer cet objet et supprimer toutes les références à celui-ci afin qu’il puisse être collecté par le garbage collector.
