TokenCachePersistenceOptions 類別

  • 參考

永續性權杖快取的選項。

大部分認證都會接受這個類別的實例，以設定持續性權杖快取。 預設值會設定認證，以使用與 Microsoft 開發人員工具和 SharedTokenCacheCredential 共用的快取。 若要隔離認證的資料與其他應用程式，請指定快取 的名稱 。

根據預設，快取會使用目前平臺的使用者資料保護 API 進行加密，並在無法使用時引發錯誤。 若要將快取設定為回復至未加密的檔案，而不是引發錯誤，請指定 allow_unencrypted_storage=True。

警告

快取包含驗證秘密。 如果快取未加密，則保護快取是

應用程式的責任。 其內容的缺口將會完全危害帳戶。

繼承
builtins.object
TokenCachePersistenceOptions

建構函式

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

僅限關鍵字的參數

名稱 Description
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)