通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

TokenCachePersistenceOptions 类

  • 参考

用于持久令牌缓存的选项。

大多数凭据接受此类的实例来配置永久性令牌缓存。 默认值将凭据配置为使用与 Microsoft 开发人员工具和 SharedTokenCacheCredential共享的缓存。 若要将凭据的数据与其他应用程序隔离，请指定缓存 的名称 。

默认情况下，缓存使用当前平台的用户数据保护 API 进行加密，当它不可用时将引发错误。 若要将缓存配置为回退到未加密的文件而不是引发错误，请指定 allow_unencrypted_storage=True。

警告

缓存包含身份验证机密。 如果缓存未加密，则保护缓存是

应用程序的责任。 违反其内容将完全入侵帐户。

继承
builtins.object
TokenCachePersistenceOptions

构造函数

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

仅限关键字的参数

名称 说明
name
str

缓存的前缀名称，用于将其数据与其他应用程序隔离。 默认为 Microsoft 开发工具和 共享的缓存的名称。SharedTokenCacheCredential 可将其他字符串追加到名称中，以便进一步隔离。

默认值: msal.cache
allow_unencrypted_storage
bool

当无法加密时，缓存是否应回退到以纯文本形式存储数据。 默认值为 False。 将其设置为 True 不会禁用加密。 缓存将始终尝试加密其数据。

示例

为永久性缓存配置凭据


   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)