Lingua

TokenCache Classe

Definizione

Spazio dei nomi:
Microsoft.Identity.Client
Assembly:
Microsoft.Identity.Client.dll
Pacchetto:
Microsoft.Identity.Client v4.84.2

Cache dei token che archivia i token di accesso e di aggiornamento per gli account Questa classe viene usata nei costruttori di PublicClientApplication e ConfidentialClientApplication. Nel caso di ConfidentialClientApplication, vengono usate due istanze, una per la cache dei token utente e una per la cache dei token dell'applicazione (nel caso delle applicazioni che usano i flussi di credenziali client).

public sealed class TokenCache
type TokenCache = class
    interface ITokenCache
    interface ITokenCacheSerializer
Public NotInheritable Class TokenCache
Ereditarietà
Object
TokenCache
Implementazioni
ITokenCache ITokenCacheSerializer

Costruttori

Nome Descrizione
TokenCache()
Obsoleti.

Costruttore di una cache dei token. Questo costruttore viene lasciato per la compatibilità con MSAL 2.x. Il modo consigliato per ottenere una cache consiste nell'usare UserTokenCache e IConfidentialClientApplication.AppTokenCache dopo la creazione dell'app.

Metodi

Nome Descrizione
SetAfterAccess(TokenCacheCallback)

Imposta un delegato che deve ricevere una notifica dopo che qualsiasi metodo di libreria accede alla cache. Ciò consente al delegato di serializzare una voce della cache per l'applicazione e gli account specificati in TokenCacheNotificationArgs. Fare riferimento a https://aka.ms/msal-net-token-cache-serialization
SetAfterAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Cache dei token che archivia i token di accesso e di aggiornamento per gli account Questa classe viene usata nei costruttori di PublicClientApplication e ConfidentialClientApplication. Nel caso di ConfidentialClientApplication, vengono usate due istanze, una per la cache dei token utente e una per la cache dei token dell'applicazione (nel caso delle applicazioni che usano i flussi di credenziali client).
SetBeforeAccess(TokenCacheCallback)

Imposta un delegato che deve ricevere una notifica prima che qualsiasi metodo di libreria acceda alla cache. Ciò consente al delegato di deserializzare una voce della cache per l'applicazione e gli account specificati in TokenCacheNotificationArgs. Fare riferimento a https://aka.ms/msal-net-token-cache-serialization
SetBeforeAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Cache dei token che archivia i token di accesso e di aggiornamento per gli account Questa classe viene usata nei costruttori di PublicClientApplication e ConfidentialClientApplication. Nel caso di ConfidentialClientApplication, vengono usate due istanze, una per la cache dei token utente e una per la cache dei token dell'applicazione (nel caso delle applicazioni che usano i flussi di credenziali client).
SetBeforeWrite(TokenCacheCallback)

Imposta un delegato chiamato prima che qualsiasi metodo di libreria scriva nella cache. In questo modo, il delegato può ricaricare lo stato della cache da una riga nel database e bloccare tale riga. La riga del database può quindi essere sbloccata nel delegato registrato con SetAfterAccess(TokenCacheCallback)
SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>)

Cache dei token che archivia i token di accesso e di aggiornamento per gli account Questa classe viene usata nei costruttori di PublicClientApplication e ConfidentialClientApplication. Nel caso di ConfidentialClientApplication, vengono usate due istanze, una per la cache dei token utente e una per la cache dei token dell'applicazione (nel caso delle applicazioni che usano i flussi di credenziali client).
SetIosKeychainSecurityGroup(String)

Imposta il gruppo di sicurezza da usare con il Keychain iOS. Questa funzione non deve essere usata dai clienti esterni. Verrà rimosso in una versione futura di MSAL.

Implementazioni dell'interfaccia esplicita

Nome Descrizione
ITokenCacheSerializer.DeserializeAdalV3(Byte[])

Cache dei token che archivia i token di accesso e di aggiornamento per gli account Questa classe viene usata nei costruttori di PublicClientApplication e ConfidentialClientApplication. Nel caso di ConfidentialClientApplication, vengono usate due istanze, una per la cache dei token utente e una per la cache dei token dell'applicazione (nel caso delle applicazioni che usano i flussi di credenziali client).
ITokenCacheSerializer.DeserializeMsalV2(Byte[])

Cache dei token che archivia i token di accesso e di aggiornamento per gli account Questa classe viene usata nei costruttori di PublicClientApplication e ConfidentialClientApplication. Nel caso di ConfidentialClientApplication, vengono usate due istanze, una per la cache dei token utente e una per la cache dei token dell'applicazione (nel caso delle applicazioni che usano i flussi di credenziali client).
ITokenCacheSerializer.DeserializeMsalV3(Byte[], Boolean)

Cache dei token che archivia i token di accesso e di aggiornamento per gli account Questa classe viene usata nei costruttori di PublicClientApplication e ConfidentialClientApplication. Nel caso di ConfidentialClientApplication, vengono usate due istanze, una per la cache dei token utente e una per la cache dei token dell'applicazione (nel caso delle applicazioni che usano i flussi di credenziali client).
ITokenCacheSerializer.SerializeAdalV3()

Cache dei token che archivia i token di accesso e di aggiornamento per gli account Questa classe viene usata nei costruttori di PublicClientApplication e ConfidentialClientApplication. Nel caso di ConfidentialClientApplication, vengono usate due istanze, una per la cache dei token utente e una per la cache dei token dell'applicazione (nel caso delle applicazioni che usano i flussi di credenziali client).
ITokenCacheSerializer.SerializeMsalV2()

Cache dei token che archivia i token di accesso e di aggiornamento per gli account Questa classe viene usata nei costruttori di PublicClientApplication e ConfidentialClientApplication. Nel caso di ConfidentialClientApplication, vengono usate due istanze, una per la cache dei token utente e una per la cache dei token dell'applicazione (nel caso delle applicazioni che usano i flussi di credenziali client).
ITokenCacheSerializer.SerializeMsalV3()

Cache dei token che archivia i token di accesso e di aggiornamento per gli account Questa classe viene usata nei costruttori di PublicClientApplication e ConfidentialClientApplication. Nel caso di ConfidentialClientApplication, vengono usate due istanze, una per la cache dei token utente e una per la cache dei token dell'applicazione (nel caso delle applicazioni che usano i flussi di credenziali client).

Metodi di estensione

Nome Descrizione
SetCacheOptions(ITokenCache, CacheOptions)

Opzioni per le cache dei token MSAL.

MSAL gestisce una cache dei token internamente in memoria. Per impostazione predefinita, questo oggetto cache fa parte di ogni istanza di PublicClientApplication o ConfidentialClientApplication. Questo metodo consente la personalizzazione della cache dei token in memoria di MSAL.

La cache di memoria di MSAL è diversa dalla serializzazione della cache dei token. La serializzazione della cache esegue il pull dei token da una cache (ad esempio Redis, Cosmos o un file su disco), in cui vengono archiviati in formato JSON, nella cache di memoria interna di MSAL. Le operazioni della cache di memoria non comportano operazioni JSON.

La serializzazione della cache esterna rimane il modo consigliato per gestire app desktop, siti Web e API Web, in quanto fornisce la persistenza. Queste opzioni non controllano attualmente la serializzazione della cache esterna.

Indicazioni dettagliate per ogni tipo di applicazione e piattaforma: https://aka.ms/msal-net-token-cache-serialization

Si applica a