Partager via


SslStream.AuthenticateAsServerAsync Méthode

Définition

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

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

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.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Paramè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.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As Task

Paramè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.Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As Task

Paramè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

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.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As Task

Paramè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.Task
Public Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As Task

Paramè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

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.

S’applique à