BeginAuthenticateAsServer, méthode (NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)
Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

NegotiateStream.BeginAuthenticateAsServer, méthode (NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)

Appelé par les serveurs pour commencer une opération asynchrone d'authentification du client, et éventuellement du serveur, dans une connexion client-serveur. Le processus d'authentification utilise les informations d'identification du serveur, les options d'authentification et la stratégie de protection étendue spécifiées. Cette méthode ne provoque pas de blocage.

Espace de noms :  System.Net.Security
Assembly :  System (dans System.dll)

[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public virtual IAsyncResult BeginAuthenticateAsServer(
	NetworkCredential credential,
	ExtendedProtectionPolicy policy,
	ProtectionLevel requiredProtectionLevel,
	TokenImpersonationLevel requiredImpersonationLevel,
	AsyncCallback asyncCallback,
	Object asyncState
)

Paramètres

credential
Type : System.Net.NetworkCredential
NetworkCredential utilisé pour établir l'identité du client.
policy
Type : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy
ExtendedProtectionPolicy qui est utilisé comme protection étendue.
requiredProtectionLevel
Type : System.Net.Security.ProtectionLevel
L'une des valeurs ProtectionLevel, indiquant les services de sécurité pour le flux.
requiredImpersonationLevel
Type : System.Security.Principal.TokenImpersonationLevel
L'une des valeurs TokenImpersonationLevel, indiquant comment le serveur peut utiliser les informations d'identification du client pour accéder aux ressources.
asyncCallback
Type : System.AsyncCallback
Délégué AsyncCallback qui fait référence à la méthode à appeler lorsque l'authentification est terminée.
asyncState
Type : System.Object
Objet défini par l'utilisateur comportant des informations sur l'opération d'écriture. Cet objet est passé au délégué asyncCallback lorsque l'opération se termine.

Valeur de retour

Type : System.IAsyncResult
Objet IAsyncResult indiquant l'état de l'opération asynchrone.

ExceptionCondition
ArgumentException

Le CustomChannelBinding et le CustomServiceNames sur la stratégie de protection étendue passée dans le paramètre policy sont tous les deux null.

ArgumentNullException

credential est null.

ArgumentOutOfRangeException

requiredImpersonationLevel doit être Identification, Impersonation ou Delegation

AuthenticationException

L'authentification a échoué. Vous pouvez utiliser cet objet pour faire une nouvelle tentative d'authentification.

InvalidCredentialException

L'authentification a échoué. Vous pouvez utiliser cet objet pour faire une nouvelle tentative d'authentification.

InvalidOperationException

L'authentification a déjà été effectuée.

- ou -

Ce flux a été utilisé précédemment pour tenter d'effectuer l'authentification en tant que client. Vous ne pouvez pas utiliser le flux pour faire une nouvelle tentative d'authentification en tant que serveur.

NotSupportedException

Windows 95 et Windows 98 ne sont pas pris en charge.

ObjectDisposedException

Cet objet a été fermé.

PlatformNotSupportedException

Le paramètre policy avait la valeur Always sur une plateforme qui ne prend pas en charge protection étendue.

Utilisez le paramètre requiredProtectionLevel pour demander des services de sécurité pour les données transmises à l'aide du flux authentifié. Par exemple, pour que les données soient chiffrées et signées, spécifiez la valeur EncryptAndSign. Une authentification réussie ne garantit pas que le ProtectionLevel demandé a été accordé. Vous devez vérifier les propriétés IsEncrypted et IsSigned pour identifier les services de sécurité utilisés par NegotiateStream.

Si le paramètre policy est null, une stratégie de protection étendue dont le PolicyEnforcement a la valeur Never est utilisée.

Cette méthode est asynchrone et ne provoque pas de blocage pendant la réalisation de l'opération. Pour que le blocage soit maintenu jusqu'à la fin de l'opération, utilisez l'une des surcharges de la méthode AuthenticateAsServer.

L'opération d'authentification asynchrone doit se terminer par un appel à la méthode EndAuthenticateAsServer. La méthode est généralement appelée par le délégué asyncCallback. Pour plus d'informations sur l'utilisation du modèle de programmation asynchrone, consultez Appel de méthodes synchrones de façon asynchrone.

Si l'authentification échoue, vous recevez une exception AuthenticationException ou InvalidCredentialException. Dans ce cas, vous pouvez recommencer l'authentification en utilisant des informations d'identification différentes.

RemarqueRemarque

L'attribut HostProtectionAttribute appliqué à ce type ou membre a la valeur de propriété Resources suivante : ExternalThreading. HostProtectionAttribute n'affecte pas les applications bureautiques (qui sont généralement démarrées en double-cliquant sur une icône, en tapant une commande ou en entrant une URL dans un navigateur). Pour plus d'informations, consultez la classe HostProtectionAttribute ou Attributs de programmation et de protection des hôtes SQL Server.

.NET Framework

Pris en charge dans : 4

.NET Framework Client Profile

Pris en charge dans : 4

Windows 7, Windows Vista SP1 ou ultérieur, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Afficher:
© 2016 Microsoft