Lingua

TokenAcquisitionOptions Classe

Definizione

Opzioni passate per creare l'oggetto acquisizione token che chiama in MSAL .NET.

public class TokenAcquisitionOptions : Microsoft.Identity.Abstractions.AcquireTokenOptions
type TokenAcquisitionOptions = class
    inherit AcquireTokenOptions
Public Class TokenAcquisitionOptions
Inherits AcquireTokenOptions
Ereditarietà
TokenAcquisitionOptions

Costruttori

Nome Descrizione
TokenAcquisitionOptions()

Opzioni passate per creare l'oggetto acquisizione token che chiama in MSAL .NET.

Proprietà

Nome Descrizione
AuthenticationOptionsName

Ottiene il nome delle opzioni che descrivono l'applicazione client riservata (ClientID, Area, Autorità, credenziali client). In ASP.NET Core il nome delle opzioni di autenticazione corrisponde allo schema di autenticazione.

(Ereditato da AcquireTokenOptions)
CancellationToken

Token di annullamento da usare quando si chiamano i metodi di acquisizione del token.

Claims

Stringa con una o più attestazioni da richiedere. Si tratta di un BLOB JSON (codificato o meno) normalmente usato con l'accesso condizionale. Riceve il membro Claims di UiRequiredException. Può anche essere usato per richiedere attestazioni facoltative specifiche e per Contesto di autenticazione DELLA CA

(Ereditato da AcquireTokenOptions)
CorrelationId

Imposta l'ID di correlazione da usare nella richiesta all'endpoint "/token" del servizio token di sicurezza.

(Ereditato da AcquireTokenOptions)
ExtraHeadersParameters

Opzioni passate per creare l'oggetto acquisizione token che chiama in MSAL .NET.

(Ereditato da AcquireTokenOptions)
ExtraParameters

Contenitore delle proprietà utilizzato per l'estendibilità.

(Ereditato da AcquireTokenOptions)
ExtraQueryParameters

Imposta i parametri di query per la stringa di query nella richiesta HTTP all'endpoint "/token".

(Ereditato da AcquireTokenOptions)
FmiPath

Percorso secondario dell'identità gestita federata (FMI).

(Ereditato da AcquireTokenOptions)
ForceRefresh

Specifica se la richiesta di token ignorerà il token di accesso nella cache dei token e tenterà di acquisire un nuovo token di accesso. Se true, la richiesta ignorerà la cache dei token. Il valore predefinito è false. Usare questa opzione con attenzione e solo quando necessario, ad esempio, se si sa che i criteri di accesso condizionale sono stati modificati, per causare una riduzione delle prestazioni, perché la cache dei token non viene usata e il servizio token di sicurezza potrebbe limitare l'app.

(Ereditato da AcquireTokenOptions)
LongRunningWebApiSessionKey

Chiave usata per LE API Web a esecuzione prolungata che devono chiamare LE API Web downstream per conto dell'utente. Può essere Null, se non si sviluppa un'API Web a esecuzione prolungata, LongRunningWebApiSessionKeyAuto se si vuole che l'acquisizione del token alloca automaticamente una chiave di sessione o la propria stringa se si desidera associare la sessione ad alcune informazioni esterne, ad esempio un identificatore hook Microsoft Graph.

(Ereditato da AcquireTokenOptions)
ManagedIdentity

Quando ManagedIdentity è impostata, l'applicazione usa un'identità gestita anziché le credenziali client per acquisire un token dell'app. Per usare un'identità assegnata dal sistema, è sufficiente lasciare UserAssignedClientId Null. Per usare un'identità assegnata dall'utente, impostare su UserAssignedClientId ClientID dell'identità assegnata dall'utente che si vuole usare. L'uso di una delle due forme di identità gestita richiede la distribuzione dell'applicazione in Azure e l'identità gestita da configurare. Per altri dettagli, vedere la documentazione relativa alle identità gestite per Azure.

(Ereditato da AcquireTokenOptions)
PopClaim

Oltre a PopPublicKey, specificare PopClaim quando necessario in protocolli POP specifici.

(Ereditato da AcquireTokenOptions)
PoPConfiguration

Modifica la richiesta di acquisizione del token in modo che il token acquisito sia un token di verifica del possesso (PoP), anziché un token di connessione. I token PoP sono simili ai token di connessione, ma sono associati alla richiesta HTTP e a una chiave crittografica, che MSAL può gestire. Vedete https://aka.ms/msal-net-pop.

PopPublicKey

Modifica la richiesta di acquisizione del token in modo che il token acquisito sia un token di verifica del possesso (PoP), anziché un token di connessione. I token PoP sono simili ai token di connessione, ma sono associati alla richiesta HTTP e a una chiave crittografica, che MSAL può gestire. Vedete https://aka.ms/msal-net-pop.

(Ereditato da AcquireTokenOptions)
Tenant

(Microsoft identità specifica) Consente di eseguire l'override del tenant o dell'account per cui ottenere un token. Ciò è utile nelle app multi-tenant nei casi in cui un determinato account utente è un guest in altri tenant e si vogliono acquisire token per un tenant specifico.

(Ereditato da AcquireTokenOptions)
UserFlow

(Microsoft identità specifica) Nel caso di AzureAD B2C, usa un flusso utente specifico.

(Ereditato da AcquireTokenOptions)

Metodi

Nome Descrizione
Clone()

Clonare le opzioni (per poter eseguirne l'override).

Metodi di estensione

Nome Descrizione
GetHttpRequestMessage(AcquireTokenOptions)

Ottiene l'oggetto in uscita HttpRequestMessage archiviato in precedenza da SetHttpRequestMessage(AcquireTokenOptions, HttpRequestMessage)o null se non è stato impostato nessuno. Il lettore non possiede la richiesta; l'SDK che lo ha creato rimane responsabile dell'eliminazione.

SetHttpRequestMessage(AcquireTokenOptions, HttpRequestMessage)

Archivia l'oggetto in uscita HttpRequestMessage in modo che un provider di intestazioni di autorizzazione in grado di essere associato a tale provider. Il contenuto della richiesta deve essere già impostato in modo che l'associazione del corpo sia accurata.

WithCachePartitionKeys(TokenAcquisitionOptions, IDictionary<String,String>)

Imposta le coppie chiave-valore della partizione della cache nelle opzioni. Quando impostata, la ricerca e l'archiviazione della cache dei token includeranno questi componenti, isolando i token memorizzati nella cache dalle voci con chiavi di partizione diverse (o nessuna).

WithClientAssertion(AcquireTokenOptions, String)

Si consideri l'asserzione client per la richiesta di token.

WithExtraBodyParameters(AcquireTokenOptions, IDictionary<String,String>)

Aggiunge parametri corpo aggiuntivi alla richiesta di acquisizione del token. I parametri vengono uniti in qualsiasi dizionario di parametri del corpo aggiuntivo esistenti, quindi questo può essere composto con altre estensioni che aggiungono anche parametri del corpo.

Si applica a