ClientApplicationBase.AcquireTokenSilent 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.
Surcharges
| Nom | Description |
|---|---|
| AcquireTokenSilent(IEnumerable<String>, IAccount) |
[API V3] Tente d’acquérir un jeton d’accès pour le |
| AcquireTokenSilent(IEnumerable<String>, String) |
[API V3] Tente d’acquérir un jeton d’accès pour avoir IAccount la Username correspondance donnée |
AcquireTokenSilent(IEnumerable<String>, IAccount)
[API V3] Tente d’acquérir un jeton d’accès pour le account cache de jetons utilisateur.
Pour plus d’informations, voir https://aka.ms/msal-net-acquiretokensilent
public Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder AcquireTokenSilent(System.Collections.Generic.IEnumerable<string> scopes, Microsoft.Identity.Client.IAccount account);abstract member AcquireTokenSilent : seq<string> * Microsoft.Identity.Client.IAccount -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder
override this.AcquireTokenSilent : seq<string> * Microsoft.Identity.Client.IAccount -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilderPublic Function AcquireTokenSilent (scopes As IEnumerable(Of String), account As IAccount) As AcquireTokenSilentParameterBuilderParamètres
- scopes
- IEnumerable<String>
Étendues demandées pour accéder à une API protégée
- account
- IAccount
Compte pour lequel le jeton est demandé.
Retours
Utilisé AcquireTokenSilentParameterBuilder pour générer la demande de jeton, en ajoutant des paramètres facultatifs
Implémente
Exceptions
sera levée dans le cas où une interaction est requise avec l’utilisateur final de l’application, par exemple, si aucun jeton d’actualisation n’était dans le cache, ou si l’utilisateur doit donner son consentement ou se reconnecter (par exemple, si le mot de passe a expiré), ou que l’utilisateur doit effectuer deux authentifications à deux facteurs
Remarques
Le jeton d’accès est considéré comme une correspondance s’il contient au moins toutes les étendues demandées. Cela signifie qu’un jeton d’accès avec plus d’étendues que demandé peut être retourné. Si le jeton d’accès a expiré ou est proche de l’expiration ( dans une fenêtre de 5 minutes), le jeton d’actualisation mis en cache (le cas échéant) est utilisé pour acquérir un nouveau jeton d’accès en effectuant un appel réseau silencieux.
Vous pouvez définir des paramètres supplémentaires en chaînant le générateur avec : WithTenantId(String) pour demander un jeton pour une autorité différente de celle définie au niveau de la construction WithForceRefresh(Boolean) de l’application pour contourner le cache de jetons utilisateur et forcer l’actualisation du jeton, ainsi que Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) pour spécifier des paramètres de requête supplémentaires
S’applique à
AcquireTokenSilent(IEnumerable<String>, String)
[API V3] Tente d’acquérir un jeton d’accès pour avoir IAccount la Username correspondance donnée loginHint, à partir du cache de jetons utilisateur.
Pour plus d’informations, voir https://aka.ms/msal-net-acquiretokensilent
public Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder AcquireTokenSilent(System.Collections.Generic.IEnumerable<string> scopes, string loginHint);abstract member AcquireTokenSilent : seq<string> * string -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder
override this.AcquireTokenSilent : seq<string> * string -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilderPublic Function AcquireTokenSilent (scopes As IEnumerable(Of String), loginHint As String) As AcquireTokenSilentParameterBuilderParamètres
- scopes
- IEnumerable<String>
Étendues demandées pour accéder à une API protégée
- loginHint
- String
En règle générale, le nom d’utilisateur, au format UPN, par exemple johnd@contoso.com
Retours
Utilisé AcquireTokenSilentParameterBuilder pour générer la demande de jeton, en ajoutant des paramètres facultatifs
Implémente
Exceptions
sera levée dans le cas où une interaction est requise avec l’utilisateur final de l’application, par exemple, si aucun jeton d’actualisation n’était dans le cache, ou si l’utilisateur doit donner son consentement ou se reconnecter (par exemple, si le mot de passe a expiré), ou que l’utilisateur doit effectuer deux authentifications à deux facteurs
Remarques
Si plusieurs IAccount correspondances sont égales loginHintou s’il n’y a pas de correspondance, une exception est levée.
Le jeton d’accès est considéré comme une correspondance s’il contient au moins toutes les étendues demandées. Cela signifie qu’un jeton d’accès avec plus d’étendues que demandé peut être retourné. Si le jeton d’accès a expiré ou est proche de l’expiration ( dans une fenêtre de 5 minutes), le jeton d’actualisation mis en cache (le cas échéant) est utilisé pour acquérir un nouveau jeton d’accès en effectuant un appel réseau silencieux.
Vous pouvez définir des paramètres supplémentaires en chaînant le générateur avec : WithTenantId(String) pour demander un jeton pour une autorité différente de celle définie au niveau de la construction WithForceRefresh(Boolean) de l’application pour contourner le cache de jetons utilisateur et forcer l’actualisation du jeton, ainsi que Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) pour spécifier des paramètres de requête supplémentaires