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
| Nom | Description |
|---|---|
| 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 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é 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 et du protocole de sécurité spécifiés. |
Remarques
Les surcharges de cette méthode ne bloquent pas pendant que l’authentification est en cours. Pour bloquer en attendant la fin de l’authentification, utilisez l’une des AuthenticateAsClient méthodes.
BeginAuthenticateAsClient(String, AsyncCallback, Object)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- 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 une fois l’authentification terminée.
- asyncState
- Object
Objet défini par l’utilisateur qui contient des informations sur l’opération. Cet objet est transmis au asyncCallback délégué une fois l’opération terminée.
Retours
Objet IAsyncResult qui indique l’état de l’opération asynchrone.
Exceptions
targetHost 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 serveur à 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). 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.
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 bloque pas pendant la fin de l’opération. 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 asynchrone de méthodes synchrones
Si vous recevez un AuthenticationException, 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.
S’applique à
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- 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é 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
Certificats X509CertificateCollection clients contenant.
- checkCertificateRevocation
- Boolean
Valeur Boolean qui spécifie si la liste de révocation de certificats est vérifiée pendant l’authentification.
- asyncCallback
- AsyncCallback
Délégué AsyncCallback qui fait référence à la méthode à appeler une fois l’authentification terminée.
- asyncState
- Object
Objet défini par l’utilisateur qui contient des informations sur l’opération. Cet objet est transmis au asyncCallback délégué une fois l’opération terminée.
Retours
Objet IAsyncResult qui indique l’état de l’opération asynchrone.
Exceptions
targetHost 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 serveur à 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).
La valeur spécifiée targetHost pour doit correspondre au nom du 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 bloque pas pendant la fin de l’opération. 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 asynchrone de méthodes synchrones
Si vous recevez un AuthenticationException, 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.
S’applique à
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)
- Source:
- SslStream.cs
- Source:
- SslStream.cs
- 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 et du protocole de sécurité spécifiés.
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
Certificats X509CertificateCollection clients contenant.
- 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.
- asyncCallback
- AsyncCallback
Délégué AsyncCallback qui fait référence à la méthode à appeler une fois l’authentification terminée.
- asyncState
- Object
Objet défini par l’utilisateur qui contient des informations sur l’opération. Cet objet est transmis au asyncCallback délégué une fois l’opération terminée.
Retours
Objet IAsyncResult qui indique l’état de l’opération asynchrone.
Exceptions
targetHost a la valeur null.
enabledSslProtocols n’est pas une valeur valide SslProtocols .
L’authentification a échoué et laissé cet objet dans un état inutilisable.
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.
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).
La valeur spécifiée targetHost pour doit correspondre au nom du 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 bloque pas pendant la fin de l’opération. 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 asynchrone de méthodes synchrones
Si vous recevez un AuthenticationException, 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.
