Condividi tramite

TokenCachePersistenceOptions Classe

  • Riferimento

Opzioni per la memorizzazione nella cache dei token persistenti.

La maggior parte delle credenziali accetta un'istanza di questa classe per configurare la memorizzazione nella cache dei token persistenti. I valori predefiniti configurano una credenziale per usare una cache condivisa con gli strumenti di sviluppo Microsoft e SharedTokenCacheCredential. Per isolare i dati di una credenziale da altre applicazioni, specificare un nome per la cache.

Per impostazione predefinita, la cache viene crittografata con l'API protezione dei dati utente della piattaforma corrente e genererà un errore quando non è disponibile. Per configurare la cache per il fallback in un file non crittografato anziché generare un errore, specificare allow_unencrypted_storage=True.

Avviso

La cache contiene segreti di autenticazione. Se la cache non è crittografata, la protezione è

responsabilità dell'applicazione. Una violazione del contenuto comprometterà completamente gli account.

Ereditarietà
builtins.object
TokenCachePersistenceOptions

Costruttore

TokenCachePersistenceOptions(*, allow_unencrypted_storage: bool = False, name: str = 'msal.cache', **kwargs: Any)

Parametri di sole parole chiave

Nome Descrizione
name
str

nome prefisso della cache, usato per isolare i dati da altre applicazioni. Per impostazione predefinita, il nome della cache condivisa dagli strumenti di sviluppo Microsoft e SharedTokenCacheCredential. È possibile aggiungere stringhe aggiuntive al nome per un ulteriore isolamento.

valore predefinito: msal.cache
allow_unencrypted_storage
bool

se la cache deve tornare all'archiviazione dei dati in testo normale quando la crittografia non è possibile. False per impostazione predefinita. L'impostazione di questa opzione su True non disabilita la crittografia. La cache tenterà sempre di crittografare i dati.

Esempio

Configurazione di una credenziale per la memorizzazione nella cache persistente


   cache_options = TokenCachePersistenceOptions()
   credential = InteractiveBrowserCredential(cache_persistence_options=cache_options)

   # specify a cache name to isolate the cache from other applications
   TokenCachePersistenceOptions(name="my_application")

   # configure the cache to fall back to unencrypted storage when encryption isn't available
   TokenCachePersistenceOptions(allow_unencrypted_storage=True)