Partilhar via

TokenCachePersistenceOptions Classe

  • Referência

Opções para colocação em cache de tokens persistentes.

A maioria das credenciais aceita uma instância desta classe para configurar a colocação em cache de tokens persistentes. Os valores predefinidos configuram uma credencial para utilizar uma cache partilhada com as ferramentas de programador da Microsoft e SharedTokenCacheCredential. Para isolar os dados de uma credencial de outras aplicações, especifique um nome para a cache.

Por predefinição, a cache é encriptada com a API de proteção de dados do utilizador da plataforma atual e gerará um erro quando esta não estiver disponível. Para configurar a cache para reverter para um ficheiro não encriptado em vez de gerar um erro, especifique allow_unencrypted_storage=Verdadeiro.

Aviso

A cache contém segredos de autenticação. Se a cache não estiver encriptada, protegê-la é a

responsabilidade da aplicação. Uma violação do seu conteúdo comprometerá totalmente as contas.

Herança
builtins.object
TokenCachePersistenceOptions

Construtor

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

Parâmetros Só de Palavra-Chave

Name Description
name
str

nome do prefixo da cache, utilizado para isolar os respetivos dados de outras aplicações. A predefinição é o nome da cache partilhada pelas ferramentas de desenvolvimento da Microsoft e SharedTokenCacheCredential. As cadeias adicionais podem ser anexadas ao nome para isolamento adicional.

valor predefinido: msal.cache
allow_unencrypted_storage
bool

se a cache deve reverter para armazenar os respetivos dados em texto simples quando a encriptação não for possível. Falso por predefinição. Definir isto como Verdadeiro não desativa a encriptação. A cache tentará sempre encriptar os respetivos dados.

Exemplos

Configurar uma credencial para colocação em 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)