AcquireTokenInteractiveParameterBuilder Classe
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.
Générateur pour une demande de jeton interactif. Voir https://aka.ms/msal-net-acquire-token-interactively
public sealed class AcquireTokenInteractiveParameterBuilder : Microsoft.Identity.Client.AbstractPublicClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenInteractiveParameterBuilder>
type AcquireTokenInteractiveParameterBuilder = class
inherit AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenInteractiveParameterBuilder>
Public NotInheritable Class AcquireTokenInteractiveParameterBuilder
Inherits AbstractPublicClientAcquireTokenParameterBuilder(Of AcquireTokenInteractiveParameterBuilder)
- Héritage
-
AcquireTokenInteractiveParameterBuilder
Méthodes
| Nom | Description |
|---|---|
| ExecuteAsync() |
Exécute la demande de jeton de façon asynchrone. (Hérité de BaseAbstractAcquireTokenParameterBuilder<T>) |
| ExecuteAsync(CancellationToken) |
Exécute la demande de jeton de manière asynchrone, avec une possibilité d’annulation de la méthode asynchrone. (Hérité de AbstractPublicClientAcquireTokenParameterBuilder<T>) |
| Validate() |
Valide les paramètres de l’opération AcquireToken. (Hérité de BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithAccount(IAccount) |
Définit le compte pour lequel le jeton sera récupéré. Cette méthode s’exclue mutuellement avec WithLoginHint(String). Si les deux sont utilisés, une exception est levée |
| WithAdfsAuthority(String, Boolean) |
Ajoute une autorité connue correspondant à un serveur ADFS. Voir https://aka.ms/msal-net-adfs. (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AadAuthorityAudience, Boolean) |
Obsolète.
Important : Utilisez WithTenantId ou WithTenantIdFromAuthority à la place, ou WithB2CAuthority pour les autorités B2C. Ajoute une autorité AZURE AD connue à l’application pour connecter les utilisateurs spécifiant l’audience de connexion (le cloud étant le cloud Azure cloud public). Voir https://aka.ms/msal-net-application-configuration. (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) |
Obsolète.
Ajoute une autorité AZURE AD connue à l’application pour connecter des utilisateurs spécifiant l’instance cloud et l’audience de connexion. Voir https://aka.ms/msal-net-application-configuration. (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, Guid, Boolean) |
Obsolète.
Important : Utilisez WithTenantId ou WithTenantIdFromAuthority à la place, ou WithB2CAuthority pour les autorités B2C. Ajoute une autorité Azure AD connue à l’application pour connecter des utilisateurs à partir d’une seule organisation (application monolocataire) décrite par son instance cloud et son ID de locataire. Voir https://aka.ms/msal-net-application-configuration. (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, String, Boolean) |
Obsolète.
Important : Utilisez WithTenantId ou WithTenantIdFromAuthority à la place, ou WithB2CAuthority pour les autorités B2C. Ajoute une autorité AZURE AD connue à l’application pour connecter des utilisateurs à partir d’une seule organisation (application à locataire unique) décrite par son instance cloud et son nom de domaine ou son ID de locataire. Voir https://aka.ms/msal-net-application-configuration. (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Boolean) |
Obsolète.
Important : Utilisez WithTenantId ou WithTenantIdFromAuthority à la place, ou WithB2CAuthority pour les autorités B2C. Autorité spécifique pour laquelle le jeton est demandé. La transmission d’une valeur différente de celle configurée au niveau du constructeur d’application limite la sélection à un locataire spécifique. Cela ne modifie pas la valeur configurée dans l’application. Il s’agit d’applications qui gèrent plusieurs comptes (comme un client de messagerie avec plusieurs boîtes aux lettres). Voir https://aka.ms/msal-net-application-configuration. (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Guid, Boolean) |
Obsolète.
Important : Utilisez WithTenantId ou WithTenantIdFromAuthority à la place, ou WithB2CAuthority pour les autorités B2C. Ajoute une autorité AD connue Azure à l’application pour connecter des utilisateurs à partir d’une seule organisation (application à locataire unique) spécifiée par son ID de locataire. Voir https://aka.ms/msal-net-application-configuration. (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, String, Boolean) |
Obsolète.
Important : Utilisez WithTenantId ou WithTenantIdFromAuthority à la place, ou WithB2CAuthority pour les autorités B2C. Ajoute une autorité Azure AD connue à l’application pour connecter des utilisateurs à partir d’une seule organisation (application à locataire unique) décrite par son nom de domaine. Voir https://aka.ms/msal-net-application-configuration. (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithB2CAuthority(String) |
Ajoute une autorité connue correspondant à une stratégie AD B2C Azure. Voir https://aka.ms/msal-net-b2c-specificities (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithClaims(String) |
Définit les revendications dans la requête. Utiliser lorsque l’administrateur AAD a activé l’accès conditionnel. L’acquisition du jeton entraîne normalement un MsalUiRequiredException jeu de Claims propriétés. Réessayez l’acquisition de jetons et utilisez cette valeur dans la WithClaims(String) méthode. Pour https://aka.ms/msal-exceptions plus d’informations et pour plus d’informations, voir https://aka.ms/msal-net-claim-challenge. (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithCorrelationId(Guid) |
Définit l’ID de corrélation à utiliser dans la demande d’authentification. Permet de suivre une demande dans les journaux du Kit de développement logiciel (SDK) et du service Identity Provider. S’il n’est pas défini, un aléatoire est généré. (Hérité de BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithEmbeddedWebViewOptions(EmbeddedWebViewOptions) |
Spécifie les options d’utilisation de la vue web incorporée pour l’authentification interactive. |
| WithExtraQueryParameters(Dictionary<String,String>) |
Obsolète.
Définit des paramètres de requête supplémentaires pour la chaîne de requête dans la demande d’authentification HTTP. (Hérité de BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>) |
Définit des paramètres de requête supplémentaires pour la chaîne de requête dans la demande d’authentification HTTP avec le contrôle sur les paramètres inclus dans la clé de cache (Hérité de BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(String) |
Obsolète.
Définit des paramètres de requête supplémentaires pour la chaîne de requête dans la demande d’authentification HTTP. (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithExtraScopesToConsent(IEnumerable<String>) |
Générateur pour une demande de jeton interactif. Voir https://aka.ms/msal-net-acquire-token-interactively |
| WithLoginHint(String) |
Définit le |
| WithParentActivityOrWindow(IntPtr) |
Définit une référence à IntPtr sur une fenêtre qui déclenche l’affichage du navigateur. Utilisé pour centrer le navigateur qui s’affiche sur cette fenêtre. Centre de l’écran ou de l’application de premier plan si une valeur est configurée. |
| WithParentActivityOrWindow(Object) |
Définit une référence à ViewController (si vous utilisez iOS), Activité (si vous utilisez Android) IWin32Window ou IntPtr (si vous utilisez .Net Framework). Utilisé pour appeler le navigateur. |
| WithPrompt(Prompt) |
Spécifie l’expérience interactive pour l’utilisateur. |
| WithProofOfPossession(String, HttpMethod, Uri) |
Modifie la demande d’acquisition de jeton afin que le jeton acquis soit un jeton de preuve de possession (POP) plutôt qu’un jeton porteur. Les jetons PoP sont similaires aux jetons du porteur, mais sont liés à la requête HTTP et à une clé de chiffrement, que MSAL peut gérer sur Windows. Notez que seules les parties hôte et chemin d’accès de l’URI de requête sont liées. Voir https://aka.ms/msal-net-pop |
| WithScopes(IEnumerable<String>) |
Spécifie les étendues à demander. Cette méthode est utilisée lorsque votre application doit spécifier les étendues nécessaires pour appeler une API protégée. >https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent<Voir</voir> pour en savoir plus sur les étendues, les autorisations et le consentement, et <voir/voir>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes<> comment créer des étendues pour les applications héritées utilisées pour exposer des autorisations OAuth2. (Hérité de AbstractAcquireTokenParameterBuilder<T>) |
| WithSystemWebViewOptions(SystemWebViewOptions) |
Spécifie les options d’utilisation du navigateur système de système d’exploitation pour gérer l’authentification interactive. |
| WithTenantId(String) |
Remplace l’ID de locataire spécifié dans l’autorité au niveau de l’application. Cette opération conserve l’hôte d’autorité (environnement). Si une autorité n’a pas été spécifiée au niveau de l’application, la valeur par défaut utilisée est |
| WithTenantIdFromAuthority(Uri) |
Extrait l’ID de locataire de l’URI d’autorité fourni et remplace l’ID de locataire spécifié dans l’autorité au niveau de l’application. Cette opération conserve l’hôte d’autorité (environnement) fourni au générateur d’applications.
Si une autorité n’a pas été fournie au générateur d’applications, cette méthode remplace l’ID de locataire dans l’autorité par défaut . |
| WithUseEmbeddedWebView(Boolean) |
Spécifie si l’application cliente publique doit utiliser un navigateur web incorporé ou le navigateur système par défaut. Si le répartiteur (WAM, Authenticator, Portail d'entreprise) est configuré, ce paramètre est utilisé uniquement lorsque le répartiteur n’est pas installé. Sur .NET, y compris net8-windows, les développeurs d’applications doivent référencer Microsoft. Identity.Client.Desktop et appelez PublicClientApplicationBuilder.WithDesktopFeatures() pour activer le navigateur web incorporé. |
Méthodes d’extension
| Nom | Description |
|---|---|
| OnBeforeTokenRequest<T>(AbstractAcquireTokenParameterBuilder<T>, Func<OnBeforeTokenRequestData,Task>) |
Intervient dans le pipeline de requête, en exécutant un délégué fourni par l’utilisateur avant que MSAL effectue la demande de jeton. Le délégué peut modifier la charge utile de la requête en ajoutant ou en supprimant des paramètres de corps et des en-têtes. OnBeforeTokenRequestData |
| WithAdditionalCacheParameters<T>(AbstractAcquireTokenParameterBuilder<T>, IEnumerable<String>) |
Spécifie des paramètres supplémentaires acquis à partir des réponses d’authentification à mettre en cache avec le jeton d’accès qui ne sont normalement pas inclus dans l’objet cache. ces valeurs peuvent être lues à partir du AdditionalResponseParameters paramètre. |
| WithAuthenticationExtension<T>(AbstractAcquireTokenParameterBuilder<T>, MsalAuthenticationExtension) |
Permet aux applications clientes de fournir une opération d’authentification personnalisée à utiliser dans la demande d’acquisition de jeton. |
| WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String) |
Ajoute une paire clé-valeur à la clé de cache de jeton sans l’envoyer en tant que paramètre de requête.
Utilisez-le pour partitionner des jetons mis en cache (par exemple, isoler les sessions à courte durée de vie des sessions régulières pour le même utilisateur). Les deux |
| WithCustomWebUi(AcquireTokenInteractiveParameterBuilder, ICustomWebUi) |
Méthode d’extension permettant MSAL.NET extendeurs pour les applications clientes publiques de définir une interface utilisateur web personnalisée qui permet à l’utilisateur de se connecter avec Azure AD, de présenter le consentement si nécessaire et de récupérer le code d’autorisation |
| WithExtraClientAssertionClaims<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Spécifie les revendications supplémentaires à inclure dans l’assertion du client. Ces revendications sont fusionnées avec les revendications par défaut lorsque l’assertion cliente est générée. Cela permet aux API de niveau supérieur comme Microsoft. Identity.Web fournit des revendications supplémentaires pour l’assertion du client. Important : les jetons sont associés aux revendications d’assertion de client supplémentaires, ce qui affecte les recherches de cache. Il s’agit d’une API d’extensibilité qui ne doit pas être utilisée directement par les applications. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Obsolète.
Ajoute des en-têtes Http supplémentaires à la demande de jeton. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Ajoute des en-têtes HTTP supplémentaires à la demande de jeton. |
| WithFmiPathForClientAssertion<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Spécifie un chemin d’accès FMI à utiliser pour l’assertion du client. Cela permet aux API de niveau supérieur, telles que Id.Web, de fournir des informations d’identification sensibles au FMI. Important : les jetons sont associés au chemin d’identification FMI, ce qui affecte les recherches de cache : il s’agit d’une API d’extensibilité et ne doit pas être utilisée par les applications. |
| WithProofOfPosessionKeyId<T>(AbstractAcquireTokenParameterBuilder<T>, String, String) |
Lie le jeton à une clé dans le cache. Aucune opération de chiffrement n’est effectuée sur le jeton. |
| WithSSHCertificateAuthenticationScheme(AcquireTokenInteractiveParameterBuilder, String, String) |
Indique à AAD de retourner un certificat SSH au lieu d’un jeton porteur. Le certificat SSH (pas identique à la paire de clés publique/privée utilisée par SSH) peut être utilisé pour déployer en toute sécurité une clé SSH publique sur un ordinateur. Pour plus d’informations, consultez https://aka.ms/msal-net-ssh. |