SslStream.AuthenticateAsClientAsync Méthode

Définition

Espace de noms:

System.Net.Security

Assemblys:

netstandard.dll, System.Net.Security.dll

Authentifiez le côté client d’une connexion client-serveur en tant qu’opération asynchrone.

Surcharges

Nom	Description
AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)	Appelé par les clients pour authentifier le serveur et éventuellement le client dans une connexion client-serveur en tant qu’opération asynchrone. Le processus d’authentification utilise la collection de certificats et le protocole SSL spécifiés.
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)	Appelé par les clients pour authentifier le serveur et éventuellement le client dans une connexion client-serveur en tant qu’opération asynchrone. Le processus d’authentification utilise la collection de certificats spécifiée et le protocole SSL par défaut du système.
AuthenticateAsClientAsync(String)	Appelé par les clients pour authentifier le serveur et éventuellement le client dans une connexion client-serveur en tant qu’opération asynchrone.
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)	Appelé par les clients pour authentifier 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 sslClientAuthenticationOptions propriétés.

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Source:

SslStream.cs

Appelé par les clients pour authentifier le serveur et éventuellement le client dans une connexion client-serveur en tant qu’opération asynchrone. Le processus d’authentification utilise la collection de certificats et le protocole SSL spécifiés.

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.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Paramètres

targetHost

String

Nom du serveur qui partagera ce SslStreamfichier .

clientCertificates

X509CertificateCollection

Qui X509CertificateCollection contient des certificats clients.

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

Task

Objet de tâche représentant l’opération asynchrone.

Exceptions

AuthenticationException

L’authentification a échoué et laissé cet objet dans un état inutilisable.

InvalidOperationException

L’authentification s’est déjà produite.

- ou -

L’authentification du serveur à l’aide de celle-ci SslStream a été essayée précédemment.

- ou -

L’authentification est déjà en cours.

ObjectDisposedException

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).

Lorsque l’authentification réussit, vous devez vérifier les propriétés et IsSigned les IsEncrypted propriétés pour déterminer quels services de sécurité sont utilisés par le SslStream. Vérifiez la propriété pour déterminer si l’authentification IsMutuallyAuthenticated mutuelle s’est produite.

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.

Note

Les certificats clients ne sont pas pris en charge dans le protocole SSL version 2.

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 AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean).

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Source:

SslStream.cs

Appelé par les clients pour authentifier le serveur et éventuellement le client dans une connexion client-serveur en tant qu’opération asynchrone. Le processus d’authentification utilise la collection de certificats spécifiée et le protocole SSL par défaut du système.

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.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As Task

Paramètres

targetHost

String

Nom du serveur qui partagera ce SslStreamfichier .

clientCertificates

X509CertificateCollection

Qui X509CertificateCollection contient des certificats clients.

checkCertificateRevocation

Boolean

Valeur Boolean qui spécifie si la liste de révocation de certificats est vérifiée pendant l’authentification.

Retours

Task

Objet de tâche représentant l’opération asynchrone.

Exceptions

AuthenticationException

L’authentification a échoué et laissé cet objet dans un état inutilisable.

InvalidOperationException

L’authentification s’est déjà produite.

- ou -

L’authentification du serveur à l’aide de celle-ci SslStream a été essayée précédemment.

- ou -

L’authentification est déjà en cours.

ObjectDisposedException

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).

Lorsque l’authentification réussit, vous devez vérifier les propriétés et IsSigned les IsEncrypted propriétés pour déterminer quels services de sécurité sont utilisés par le SslStream. Vérifiez la propriété pour déterminer si l’authentification IsMutuallyAuthenticated mutuelle s’est produite.

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.

Note

Les certificats clients ne sont pas pris en charge dans le protocole SSL version 2.

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 AuthenticateAsClient(String, X509CertificateCollection, Boolean).

AuthenticateAsClientAsync(String)

Source:

SslStream.cs

Appelé par les clients pour authentifier le serveur et éventuellement le client dans une connexion client-serveur en tant qu’opération asynchrone.

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.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String) As Task

Paramètres

targetHost

String

Nom du serveur qui partage ce SslStream.

Retours

Task

Objet de tâche représentant l’opération asynchrone.

Exceptions

ArgumentNullException

targetHost a la valeur null.

AuthenticationException

L’authentification a échoué et laissé cet objet dans un état inutilisable.

InvalidOperationException

L’authentification s’est déjà produite.

- ou -

L’authentification du serveur à l’aide de celle-ci SslStream a été essayée précédemment.

- ou -

L’authentification est déjà en cours.

ObjectDisposedException

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). Aucun certificat client n’est utilisé dans l’authentification. La liste de révocation de certificats n’est pas vérifiée pendant l’authentification. La valeur spécifiée targetHost pour doit correspondre au nom du certificat du serveur.

Lorsque l’authentification réussit, vous devez vérifier les propriétés et IsSigned les IsEncrypted propriétés pour déterminer quels services de sécurité sont utilisés par le SslStream. Vérifiez la propriété pour déterminer si l’authentification IsMutuallyAuthenticated mutuelle s’est produite.

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 AuthenticateAsClient(String).

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Source:

SslStream.cs

Appelé par les clients pour authentifier 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 sslClientAuthenticationOptions propriétés.

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 = default);

member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Paramètres

sslClientAuthenticationOptions

SslClientAuthenticationOptions

Conteneur de propriétés pour la connexion SSL.

cancellationToken

CancellationToken

Jeton à surveiller pour les demandes d’annulation.

Retours

Task

Objet de tâche représentant l’opération asynchrone.

Exceptions

ArgumentNullException

sslClientAuthenticationOptions a la valeur null.

AuthenticationException

L’authentification a échoué et laissé cet objet dans un état inutilisable.

InvalidOperationException

L’authentification s’est déjà produite.

- ou -

L’authentification du serveur à l’aide de celle-ci SslStream a été essayée précédemment.

- ou -

L’authentification est déjà en cours.

ObjectDisposedException

Cet objet a été fermé.

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Lorsque l’authentification réussit, vous devez vérifier les propriétés et IsSigned les IsEncrypted propriétés pour déterminer quels services de sécurité sont utilisés par le SslStream. Vérifiez la propriété pour déterminer si l’authentification IsMutuallyAuthenticated mutuelle s’est produite.

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 AuthenticateAsClient(SslClientAuthenticationOptions).