SslStream.BeginAuthenticateAsClient 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.
Commence une opération pour authentifier le côté client d'une connexion client-serveur.
Surcharges
| BeginAuthenticateAsClient(String, AsyncCallback, Object) |
Appelé par les clients pour commencer une opération asynchrone pour authentifier le serveur et, éventuellement, le client. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object) |
Appelé par les clients pour lancer une opération asynchrone d’authentification du serveur et éventuellement du client à l’aide des certificats spécifiés et du protocole de sécurité par défaut du système. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object) |
Appelé par les clients pour commencer une opération asynchrone pour authentifier le serveur et éventuellement le client à l'aide des certificats spécifiés et du protocole de sécurité. |
Remarques
Les surcharges de cette méthode ne se bloquent pas tant que l’authentification est en cours. Pour bloquer en attendant la fin de l’authentification, utilisez l’une AuthenticateAsClient des méthodes .
BeginAuthenticateAsClient(String, AsyncCallback, Object)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Appelé par les clients pour commencer une opération asynchrone pour authentifier le serveur et, éventuellement, le client.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParamètres
- asyncCallback
- AsyncCallback
Délégué AsyncCallback qui fait référence à la méthode à appeler quand l’authentification est terminée.
- asyncState
- Object
Objet défini par l'utilisateur qui comporte des informations sur l'opération. Cet objet est passé au délégué asyncCallback quand l'opération se termine.
Retours
Objet IAsyncResult qui indique l'état de l'opération asynchrone.
Exceptions
targetHost 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 serveur avec cette 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). Aucun certificat client n’est utilisé dans l’authentification. La liste de révocation des certificats n’est pas vérifiée lors de l’authentification.
La valeur spécifiée pour targetHost doit correspondre au nom sur le certificat du serveur.
L’opération d’authentification asynchrone doit être effectuée en appelant la EndAuthenticateAsClient méthode . En règle générale, la méthode est appelée par le asyncCallback délégué.
Cette méthode ne se bloque pas tant que l’opération se termine. Pour bloquer jusqu’à la fin de l’opération, utilisez l’une AuthenticateAsClient des surcharges de méthode.
Pour plus d’informations sur l’utilisation du modèle de programmation asynchrone, consultez Appel de méthodes synchrones de manière asynchrone
Si vous recevez un AuthenticationException, cela 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.
S’applique à
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Appelé par les clients pour lancer une opération asynchrone d’authentification du serveur et éventuellement du client à l’aide des certificats spécifiés et du protocole de sécurité par défaut du système.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParamètres
- clientCertificates
- X509CertificateCollection
X509CertificateCollection contenant les certificats clients.
- checkCertificateRevocation
- Boolean
Valeur Boolean qui spécifie si la liste de révocation des certificats est vérifiée pendant l’authentification.
- asyncCallback
- AsyncCallback
Délégué AsyncCallback qui fait référence à la méthode à appeler quand l’authentification est terminée.
- asyncState
- Object
Objet défini par l'utilisateur qui comporte des informations sur l'opération. Cet objet est passé au délégué asyncCallback quand l'opération se termine.
Retours
Objet IAsyncResult qui indique l'état de l'opération asynchrone.
Exceptions
targetHost 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 serveur avec cette 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).
La valeur spécifiée pour targetHost doit correspondre au nom sur le certificat du serveur.
L’opération d’authentification asynchrone doit être effectuée en appelant la EndAuthenticateAsClient méthode . En règle générale, la méthode est appelée par le asyncCallback délégué.
Cette méthode ne se bloque pas tant que l’opération se termine. Pour bloquer jusqu’à la fin de l’opération, utilisez l’une AuthenticateAsClient des surcharges de méthode.
Pour plus d’informations sur l’utilisation du modèle de programmation asynchrone, consultez Appel de méthodes synchrones de manière asynchrone
Si vous recevez un AuthenticationException, cela 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.
Notes
Les certificats clients ne sont pas pris en charge dans le protocole SSL version 2.
S’applique à
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- Source:
- SslStream.cs
Appelé par les clients pour commencer une opération asynchrone pour authentifier le serveur et éventuellement le client à l'aide des certificats spécifiés et du protocole de sécurité.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParamètres
- clientCertificates
- X509CertificateCollection
X509CertificateCollection contenant les certificats clients.
- 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.
- asyncCallback
- AsyncCallback
Délégué AsyncCallback qui fait référence à la méthode à appeler quand l’authentification est terminée.
- asyncState
- Object
Objet défini par l'utilisateur qui comporte des informations sur l'opération. Cet objet est passé au délégué asyncCallback quand l'opération se termine.
Retours
Objet IAsyncResult qui indique l'état de l'opération asynchrone.
Exceptions
targetHost a la valeur null.
enabledSslProtocols n’est pas une valeur de SslProtocols valide.
L’authentification a échoué et a laissé cet objet dans un état inutilisable.
L’authentification a déjà eu lieu.
- ou -
L’authentification du serveur avec cette 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).
La valeur spécifiée pour targetHost doit correspondre au nom sur le certificat du serveur.
L’opération d’authentification asynchrone doit être effectuée en appelant la EndAuthenticateAsClient méthode . En règle générale, la méthode est appelée par le asyncCallback délégué.
Cette méthode ne se bloque pas tant que l’opération se termine. Pour bloquer jusqu’à la fin de l’opération, utilisez l’une AuthenticateAsClient des surcharges de méthode.
Pour plus d’informations sur l’utilisation du modèle de programmation asynchrone, consultez Appel de méthodes synchrones de manière asynchrone
Si vous recevez un AuthenticationException, cela 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.
Notes
Les certificats clients ne sont pas pris en charge dans le protocole SSL version 2.
S’applique à
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour