Partager via


SslStream.BeginAuthenticateAsClient Méthode

Définition

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 -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Paramètres

targetHost
String

Le nom du serveur qui partage ce SslStream.

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 -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Paramètres

targetHost
String

Le nom du serveur qui partage ce SslStream.

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 -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Paramètres

targetHost
String

Le nom du serveur qui partage ce SslStream.

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 à