TokenCachePersistenceOptions Classe

  • Referência

Opções para cache de token persistente.

A maioria das credenciais aceita uma instância dessa classe para configurar o cache de token persistente. Os valores padrão configuram uma credencial para usar um cache compartilhado com ferramentas de desenvolvedor da Microsoft e SharedTokenCacheCredential. Para isolar os dados de uma credencial de outros aplicativos, especifique um nome para o cache.

Por padrão, o cache é criptografado com a API de proteção de dados do usuário da plataforma atual e gerará um erro quando isso não estiver disponível. Para configurar o cache para fazer fallback para um arquivo não criptografado em vez de gerar um erro, especifique allow_unencrypted_storage=True.

Aviso

O cache contém segredos de autenticação. Se o cache não estiver criptografado, protegê-lo será o

responsabilidade do aplicativo. Uma violação de 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 somente de palavra-chave

Nome Description
name
str

nome do prefixo do cache, usado para isolar seus dados de outros aplicativos. O padrão é o nome do cache compartilhado pelas ferramentas de desenvolvimento da Microsoft e SharedTokenCacheCredential. Cadeias de caracteres adicionais podem ser acrescentadas ao nome para isolamento adicional.

valor padrão: msal.cache
allow_unencrypted_storage
bool

se o cache deve fazer fallback para armazenar seus dados em texto sem formatação quando a criptografia não for possível. Falso por padrão. Definir isso como True não desabilitar a criptografia. O cache sempre tentará criptografar seus dados.

Exemplos

Configurando uma credencial para 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)