Partager via


TokenCachePersistenceOptions Classe

Options pour la mise en cache des jetons persistants.

La plupart des informations d’identification acceptent une instance de cette classe pour configurer la mise en cache persistante des jetons. Les valeurs par défaut configurent des informations d’identification pour utiliser un cache partagé avec les outils de développement Microsoft et SharedTokenCacheCredential. Pour isoler les données d’informations d’identification des autres applications, spécifiez un nom pour le cache.

Par défaut, le cache est chiffré avec l’API de protection des données utilisateur de la plateforme actuelle et génère une erreur lorsque celle-ci n’est pas disponible. Pour configurer le cache pour qu’il revient à un fichier non chiffré au lieu de générer une erreur, spécifiez allow_unencrypted_storage=True.

Avertissement

Le cache contient des secrets d’authentification. Si le cache n’est pas chiffré, sa protection est

responsabilité de l’application. Une violation de son contenu compromettra entièrement les comptes.

Héritage
builtins.object
TokenCachePersistenceOptions

Constructeur

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

Paramètres de mot clé uniquement

Nom Description
name
str

préfixe nom du cache, utilisé pour isoler ses données des autres applications. Par défaut, le nom du cache partagé par les outils de développement Microsoft et SharedTokenCacheCredential. Des chaînes supplémentaires peuvent être ajoutées au nom pour une isolation supplémentaire.

valeur par défaut: msal.cache
allow_unencrypted_storage

si le cache doit revenir au stockage de ses données en texte brut quand le chiffrement n’est pas possible. False par défaut. La définition de cette valeur sur True ne désactive pas le chiffrement. Le cache essaiera toujours de chiffrer ses données.

Exemples

Configuration d’informations d’identification pour la mise en cache permanente


   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)