ClientApplicationBase.AcquireTokenSilent Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| AcquireTokenSilent(IEnumerable<String>, IAccount) |
[API V3] Tenta di acquisire un token di accesso per |
| AcquireTokenSilent(IEnumerable<String>, String) |
[API V3] Tenta di acquisire un token di accesso per avere IAccount la corrispondenza con l'oggetto Username specificato |
AcquireTokenSilent(IEnumerable<String>, IAccount)
[API V3] Tenta di acquisire un token di accesso per account dalla cache dei token utente.
Per altri dettagli, vedere 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 AcquireTokenSilentParameterBuilderParametri
- scopes
- IEnumerable<String>
Ambiti richiesti per accedere a un'API protetta
- account
- IAccount
Account per il quale viene richiesto il token.
Valori restituiti
Oggetto AcquireTokenSilentParameterBuilder usato per compilare la richiesta di token, aggiungendo parametri facoltativi
Implementazioni
Eccezioni
verrà generata nel caso in cui sia necessaria un'interazione con l'utente finale dell'applicazione, ad esempio se non è presente alcun token di aggiornamento nella cache o se l'utente deve fornire il consenso o ripetere l'accesso (ad esempio se la password è scaduta) o l'utente deve eseguire l'autenticazione a due fattori
Commenti
Il token di accesso viene considerato una corrispondenza se contiene almeno tutti gli ambiti richiesti. Ciò significa che è possibile restituire un token di accesso con più ambiti di quelli richiesti. Se il token di accesso è scaduto o vicino alla scadenza, entro un intervallo di 5 minuti, il token di aggiornamento memorizzato nella cache (se disponibile) viene usato per acquisire un nuovo token di accesso effettuando una chiamata di rete invisibile all'utente.
È possibile impostare parametri aggiuntivi concatenando il generatore con: WithTenantId(String) per richiedere un token per un'autorità diversa da quella impostata nella costruzione WithForceRefresh(Boolean) dell'applicazione per ignorare la cache dei token utente e forzare l'aggiornamento del token, nonché Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) per specificare parametri di query aggiuntivi
Si applica a
AcquireTokenSilent(IEnumerable<String>, String)
[API V3] Tenta di acquisire un token di accesso per avere IAccount la corrispondenza con l'oggetto Username specificato loginHintdalla cache dei token utente.
Per altri dettagli, vedere 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 AcquireTokenSilentParameterBuilderParametri
- scopes
- IEnumerable<String>
Ambiti richiesti per accedere a un'API protetta
- loginHint
- String
In genere il nome utente, in formato UPN, ad esempio johnd@contoso.com
Valori restituiti
Oggetto AcquireTokenSilentParameterBuilder usato per compilare la richiesta di token, aggiungendo parametri facoltativi
Implementazioni
Eccezioni
verrà generata nel caso in cui sia necessaria un'interazione con l'utente finale dell'applicazione, ad esempio se non è presente alcun token di aggiornamento nella cache o se l'utente deve fornire il consenso o ripetere l'accesso (ad esempio se la password è scaduta) o l'utente deve eseguire l'autenticazione a due fattori
Commenti
Se più IAccount corrisponde a loginHinto se non sono presenti corrispondenze, viene generata un'eccezione.
Il token di accesso viene considerato una corrispondenza se contiene almeno tutti gli ambiti richiesti. Ciò significa che è possibile restituire un token di accesso con più ambiti di quelli richiesti. Se il token di accesso è scaduto o vicino alla scadenza, entro un intervallo di 5 minuti, il token di aggiornamento memorizzato nella cache (se disponibile) viene usato per acquisire un nuovo token di accesso effettuando una chiamata di rete invisibile all'utente.
È possibile impostare parametri aggiuntivi concatenando il generatore con: WithTenantId(String) per richiedere un token per un'autorità diversa da quella impostata nella costruzione WithForceRefresh(Boolean) dell'applicazione per ignorare la cache dei token utente e forzare l'aggiornamento del token, nonché Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) per specificare parametri di query aggiuntivi