TokenCache Klasse

Definition

Namespace:
Microsoft.Identity.Client
Assembly:
Microsoft.Identity.Client.dll
Paket:
Microsoft.Identity.Client v4.84.2

Tokencache zum Speichern von Zugriffs- und Aktualisierungstoken für Konten Diese Klasse wird in den Konstruktoren von PublicClientApplication und .ConfidentialClientApplication Bei "ConfidentialClientApplication" werden zwei Instanzen verwendet, eine für den Benutzertokencache und eine für den Anwendungstokencache (bei Anwendungen, die die Clientanmeldeinformationsflüsse verwenden).

public sealed class TokenCache
type TokenCache = class
    interface ITokenCache
    interface ITokenCacheSerializer
Public NotInheritable Class TokenCache
Vererbung
Object
TokenCache
Implementiert
ITokenCache ITokenCacheSerializer

Konstruktoren

Name Beschreibung
TokenCache()
Veraltet.

Konstruktor eines Tokencaches. Dieser Konstruktor bleibt aus Gründen der Kompatibilität mit MSAL 2.x übrig. Die empfohlene Methode zum Abrufen eines Caches ist die Verwendung UserTokenCache und IConfidentialClientApplication.AppTokenCache nach der Erstellung der App.

Methoden

Name Beschreibung
SetAfterAccess(TokenCacheCallback)

Legt fest, dass ein Delegat benachrichtigt wird, nachdem eine Bibliotheksmethode auf den Cache zugreift. Dadurch erhält der Delegat eine Option zum Serialisieren eines Cacheeintrags für die Anwendung und Konten, die in TokenCacheNotificationArgs angegeben sind. Siehe https://aka.ms/msal-net-token-cache-serialization.
SetAfterAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Tokencache zum Speichern von Zugriffs- und Aktualisierungstoken für Konten Diese Klasse wird in den Konstruktoren von PublicClientApplication und .ConfidentialClientApplication Bei "ConfidentialClientApplication" werden zwei Instanzen verwendet, eine für den Benutzertokencache und eine für den Anwendungstokencache (bei Anwendungen, die die Clientanmeldeinformationsflüsse verwenden).
SetBeforeAccess(TokenCacheCallback)

Legt fest, dass ein Delegat benachrichtigt wird, bevor eine Bibliotheksmethode auf den Cache zugreift. Dadurch erhält der Delegat eine Option zum Deserialisieren eines Cacheeintrags für die Anwendung und Konten, die in TokenCacheNotificationArgs angegeben sind. Siehe https://aka.ms/msal-net-token-cache-serialization.
SetBeforeAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Tokencache zum Speichern von Zugriffs- und Aktualisierungstoken für Konten Diese Klasse wird in den Konstruktoren von PublicClientApplication und .ConfidentialClientApplication Bei "ConfidentialClientApplication" werden zwei Instanzen verwendet, eine für den Benutzertokencache und eine für den Anwendungstokencache (bei Anwendungen, die die Clientanmeldeinformationsflüsse verwenden).
SetBeforeWrite(TokenCacheCallback)

Legt einen Delegaten fest, der aufgerufen wird, bevor eine Bibliotheksmethode in den Cache schreibt. Dadurch kann der Delegat den Cachestatus aus einer Zeile in der Datenbank neu laden und diese Zeile sperren. Diese Datenbankzeile kann dann in der bei der Stellvertretung registrierten Stellvertretung entsperrt werden. SetAfterAccess(TokenCacheCallback)
SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>)

Tokencache zum Speichern von Zugriffs- und Aktualisierungstoken für Konten Diese Klasse wird in den Konstruktoren von PublicClientApplication und .ConfidentialClientApplication Bei "ConfidentialClientApplication" werden zwei Instanzen verwendet, eine für den Benutzertokencache und eine für den Anwendungstokencache (bei Anwendungen, die die Clientanmeldeinformationsflüsse verwenden).
SetIosKeychainSecurityGroup(String)

Legt die Sicherheitsgruppe fest, die mit dem iOS-Schlüsselbund verwendet werden soll. Diese Funktion sollte nicht von externen Kunden verwendet werden. Sie wird in einer zukünftigen Version von MSAL entfernt.

Explizite Schnittstellenimplementierungen

Name Beschreibung
ITokenCacheSerializer.DeserializeAdalV3(Byte[])

Tokencache zum Speichern von Zugriffs- und Aktualisierungstoken für Konten Diese Klasse wird in den Konstruktoren von PublicClientApplication und .ConfidentialClientApplication Bei "ConfidentialClientApplication" werden zwei Instanzen verwendet, eine für den Benutzertokencache und eine für den Anwendungstokencache (bei Anwendungen, die die Clientanmeldeinformationsflüsse verwenden).
ITokenCacheSerializer.DeserializeMsalV2(Byte[])

Tokencache zum Speichern von Zugriffs- und Aktualisierungstoken für Konten Diese Klasse wird in den Konstruktoren von PublicClientApplication und .ConfidentialClientApplication Bei "ConfidentialClientApplication" werden zwei Instanzen verwendet, eine für den Benutzertokencache und eine für den Anwendungstokencache (bei Anwendungen, die die Clientanmeldeinformationsflüsse verwenden).
ITokenCacheSerializer.DeserializeMsalV3(Byte[], Boolean)

Tokencache zum Speichern von Zugriffs- und Aktualisierungstoken für Konten Diese Klasse wird in den Konstruktoren von PublicClientApplication und .ConfidentialClientApplication Bei "ConfidentialClientApplication" werden zwei Instanzen verwendet, eine für den Benutzertokencache und eine für den Anwendungstokencache (bei Anwendungen, die die Clientanmeldeinformationsflüsse verwenden).
ITokenCacheSerializer.SerializeAdalV3()

Tokencache zum Speichern von Zugriffs- und Aktualisierungstoken für Konten Diese Klasse wird in den Konstruktoren von PublicClientApplication und .ConfidentialClientApplication Bei "ConfidentialClientApplication" werden zwei Instanzen verwendet, eine für den Benutzertokencache und eine für den Anwendungstokencache (bei Anwendungen, die die Clientanmeldeinformationsflüsse verwenden).
ITokenCacheSerializer.SerializeMsalV2()

Tokencache zum Speichern von Zugriffs- und Aktualisierungstoken für Konten Diese Klasse wird in den Konstruktoren von PublicClientApplication und .ConfidentialClientApplication Bei "ConfidentialClientApplication" werden zwei Instanzen verwendet, eine für den Benutzertokencache und eine für den Anwendungstokencache (bei Anwendungen, die die Clientanmeldeinformationsflüsse verwenden).
ITokenCacheSerializer.SerializeMsalV3()

Tokencache zum Speichern von Zugriffs- und Aktualisierungstoken für Konten Diese Klasse wird in den Konstruktoren von PublicClientApplication und .ConfidentialClientApplication Bei "ConfidentialClientApplication" werden zwei Instanzen verwendet, eine für den Benutzertokencache und eine für den Anwendungstokencache (bei Anwendungen, die die Clientanmeldeinformationsflüsse verwenden).

Erweiterungsmethoden

Name Beschreibung
SetCacheOptions(ITokenCache, CacheOptions)

Optionen für MSAL-Tokencaches.

MSAL verwaltet einen Tokencache intern im Arbeitsspeicher. Standardmäßig ist dieses Cacheobjekt Teil jeder Instanz von PublicClientApplication oder ConfidentialClientApplication. Diese Methode ermöglicht die Anpassung des Speichertokencaches von MSAL.

Der Speichercache von MSAL unterscheidet sich von der Tokencache-Serialisierung. Die Cache-Serialisierung ruft die Token aus einem Cache ab (z. B. Redis, Cosmos oder eine Datei auf einem Datenträger), wo sie im JSON-Format gespeichert sind, in den internen Speichercache von MSAL. Speichercachevorgänge umfassen keine JSON-Vorgänge.

Die Serialisierung des externen Caches bleibt die empfohlene Methode zum Behandeln von Desktop-Apps, Websites und Web-APIs, da sie Persistenz bietet. Diese Optionen steuern derzeit keine serialisierung des externen Caches.

Detaillierte Anleitungen für jeden Anwendungstyp und jede Plattform: https://aka.ms/msal-net-token-cache-serialization

Gilt für: