Share via


TokenCachePersistenceOptions Klasse

Optionen für die persistente Tokenzwischenspeicherung.

Die meisten Anmeldeinformationen akzeptieren eine instance dieser Klasse zum Konfigurieren der persistenten Tokenzwischenspeicherung. Die Standardwerte konfigurieren Anmeldeinformationen für die Verwendung eines Caches, der mit Microsoft-Entwicklertools und SharedTokenCacheCredentialfreigegeben wurde. Um die Daten einer Anmeldeinformation von anderen Anwendungen zu isolieren, geben Sie einen Namen für den Cache an.

Standardmäßig wird der Cache mit der Benutzerdatenschutz-API der aktuellen Plattform verschlüsselt und löst einen Fehler aus, wenn dieser nicht verfügbar ist. Um den Cache so zu konfigurieren, dass er auf eine unverschlüsselte Datei zurückfällt, anstatt einen Fehler auszuwerfen, geben Sie allow_unencrypted_storage=True an.

Warnung

Der Cache enthält Authentifizierungsgeheimnisse. Wenn der Cache nicht verschlüsselt ist, wird er geschützt.

Die Verantwortung der Anwendung. Eine Verletzung seiner Inhalte gefährdet Konten vollständig.

Vererbung
builtins.object
TokenCachePersistenceOptions

Konstruktor

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

Nur Schlüsselwortparameter

Name Beschreibung
name
str

Präfixname des Caches, der verwendet wird, um seine Daten von anderen Anwendungen zu isolieren. Standardmäßig wird der Name des Caches verwendet, der von Microsoft-Entwicklungstools und SharedTokenCacheCredentialfreigegeben wird. Für die weitere Isolation können zusätzliche Zeichenfolgen an den Namen angefügt werden.

Standardwert: msal.cache
allow_unencrypted_storage

gibt an, ob der Cache auf das Speichern seiner Daten in Nur-Text zurückgreifen soll, wenn die Verschlüsselung nicht möglich ist. Der Standardwert ist gleich „False“. Wenn Sie diesen Wert auf True festlegen, wird die Verschlüsselung nicht deaktiviert. Der Cache versucht immer, seine Daten zu verschlüsseln.

Beispiele

Konfigurieren von Anmeldeinformationen für die persistente Zwischenspeicherung


   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)