ITokenCache Schnittstelle

Definition

Namespace:: Microsoft.Identity.Client

Assembly:: Microsoft.Identity.Client.dll

Paket:: Microsoft.Identity.Client v4.91.0

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Dies ist die Schnittstelle, die den öffentlichen Zugriff auf Cachevorgänge implementiert. Bei CacheV2 sollte dies nur erforderlich sein, wenn der Aufrufer den Cache in ihrem eigenen Speicher speichert, da dies die Serialisierung/Deserialisierung und vor/nach Benachrichtigungen bereitstellt, die in diesem Szenario verwendet werden. Siehe https://aka.ms/aka.ms/msal-net-token-cache-serialization.

public interface ITokenCache

type ITokenCache = interface

Public Interface ITokenCache

Abgeleitet: Microsoft.Identity.Client.TokenCache

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. Wenn Sie asynchrone/taskbasierte Rückrufe benötigen, verwenden Sie stattdessen SetAfterAccessAsync.
SetAfterAccessAsync(Func<TokenCacheNotificationArgs,Task>)	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. Dies bietet die gleiche Funktionalität wie SetAfterAccess, bietet aber einen asynchronen/taskbasierten Rückruf.
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. Wenn Sie asynchrone/taskbasierte Rückrufe benötigen, verwenden Sie stattdessen SetBeforeAccessAsync.
SetBeforeAccessAsync(Func<TokenCacheNotificationArgs,Task>)	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. Dies bietet die gleiche Funktionalität wie SetBeforeAccess, bietet aber einen asynchronen/taskbasierten Rückruf.
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 asynchronen/taskbasierten Rückrufen registrierten SetAfterAccess(TokenCacheCallback) Stellvertretung entsperrt werden, verwenden Sie stattdessen SetBeforeWriteAsync.
SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>)	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 mit dieser registrierten SetAfterAccess(TokenCacheCallback) Stellvertretung entsperrt werden, bietet die gleiche Funktionalität wie SetBeforeWrite, bietet aber einen asynchronen/taskbasierten Rückruf.

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

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:

Feedback

War diese Seite hilfreich?