TokenCache Klas

Definitie

Naamruimte:

Microsoft.Identity.Client

Assembly:

Microsoft.Identity.Client.dll

Pakket:

Microsoft.Identity.Client v4.84.2

Tokencache voor het opslaan van toegangs- en vernieuwingstokens voor accounts Deze klasse wordt gebruikt in de constructors van PublicClientApplication en ConfidentialClientApplication. In het geval van ConfidentialClientApplication worden twee exemplaren gebruikt, één voor de gebruikerstokencache en één voor de toepassingstokencache (in het geval van toepassingen die gebruikmaken van de clientreferentiestromen).

public sealed class TokenCache

type TokenCache = class
    interface ITokenCache
    interface ITokenCacheSerializer

Public NotInheritable Class TokenCache

Overname

Object

TokenCache

Implementeringen

ITokenCache ITokenCacheSerializer

Constructors

Name	Description
TokenCache()	Verouderd. Constructor van een tokencache. Deze constructor blijft compatibel met MSAL 2.x. De aanbevolen manier om een cache op te halen, is door gebruik te maken UserTokenCache van en IConfidentialClientApplication.AppTokenCache zodra de app is gemaakt.

Methoden

Name	Description
SetAfterAccess(TokenCacheCallback)	Hiermee stelt u een gemachtigde in om een melding te ontvangen nadat een bibliotheekmethode toegang heeft tot de cache. Dit biedt de gedelegeerde de mogelijkheid om een cachevermelding te serialiseren voor de toepassing en accounts die zijn opgegeven in de TokenCacheNotificationArgs. Zie https://aka.ms/msal-net-token-cache-serialization
SetAfterAccessAsync(Func<TokenCacheNotificationArgs,Task>)	Tokencache voor het opslaan van toegangs- en vernieuwingstokens voor accounts Deze klasse wordt gebruikt in de constructors van PublicClientApplication en ConfidentialClientApplication. In het geval van ConfidentialClientApplication worden twee exemplaren gebruikt, één voor de gebruikerstokencache en één voor de toepassingstokencache (in het geval van toepassingen die gebruikmaken van de clientreferentiestromen).
SetBeforeAccess(TokenCacheCallback)	Hiermee stelt u een gemachtigde in om een melding te ontvangen voordat een bibliotheekmethode toegang heeft tot de cache. Dit biedt de gedelegeerde de mogelijkheid om een cachevermelding voor de toepassing en accounts die zijn opgegeven in de TokenCacheNotificationArgscache te deserialiseren. Zie https://aka.ms/msal-net-token-cache-serialization
SetBeforeAccessAsync(Func<TokenCacheNotificationArgs,Task>)	Tokencache voor het opslaan van toegangs- en vernieuwingstokens voor accounts Deze klasse wordt gebruikt in de constructors van PublicClientApplication en ConfidentialClientApplication. In het geval van ConfidentialClientApplication worden twee exemplaren gebruikt, één voor de gebruikerstokencache en één voor de toepassingstokencache (in het geval van toepassingen die gebruikmaken van de clientreferentiestromen).
SetBeforeWrite(TokenCacheCallback)	Hiermee stelt u een gemachtigde in die wordt aangeroepen voordat een bibliotheekmethode naar de cache schrijft. Dit biedt de gedelegeerde de mogelijkheid om de cachestatus opnieuw te laden uit een rij in de database en die rij te vergrendelen. Die databaserij kan vervolgens worden ontgrendeld in de gemachtigde die is geregistreerd bij SetAfterAccess(TokenCacheCallback)
SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>)	Tokencache voor het opslaan van toegangs- en vernieuwingstokens voor accounts Deze klasse wordt gebruikt in de constructors van PublicClientApplication en ConfidentialClientApplication. In het geval van ConfidentialClientApplication worden twee exemplaren gebruikt, één voor de gebruikerstokencache en één voor de toepassingstokencache (in het geval van toepassingen die gebruikmaken van de clientreferentiestromen).
SetIosKeychainSecurityGroup(String)	Hiermee stelt u de beveiligingsgroep in die moet worden gebruikt met de iOS-sleutelhanger. Deze functie mag niet worden gebruikt door externe klanten. Deze wordt verwijderd in een toekomstige versie van MSAL.

Expliciete interface-implementaties

Name	Description
ITokenCacheSerializer.DeserializeAdalV3(Byte[])	Tokencache voor het opslaan van toegangs- en vernieuwingstokens voor accounts Deze klasse wordt gebruikt in de constructors van PublicClientApplication en ConfidentialClientApplication. In het geval van ConfidentialClientApplication worden twee exemplaren gebruikt, één voor de gebruikerstokencache en één voor de toepassingstokencache (in het geval van toepassingen die gebruikmaken van de clientreferentiestromen).
ITokenCacheSerializer.DeserializeMsalV2(Byte[])	Tokencache voor het opslaan van toegangs- en vernieuwingstokens voor accounts Deze klasse wordt gebruikt in de constructors van PublicClientApplication en ConfidentialClientApplication. In het geval van ConfidentialClientApplication worden twee exemplaren gebruikt, één voor de gebruikerstokencache en één voor de toepassingstokencache (in het geval van toepassingen die gebruikmaken van de clientreferentiestromen).
ITokenCacheSerializer.DeserializeMsalV3(Byte[], Boolean)	Tokencache voor het opslaan van toegangs- en vernieuwingstokens voor accounts Deze klasse wordt gebruikt in de constructors van PublicClientApplication en ConfidentialClientApplication. In het geval van ConfidentialClientApplication worden twee exemplaren gebruikt, één voor de gebruikerstokencache en één voor de toepassingstokencache (in het geval van toepassingen die gebruikmaken van de clientreferentiestromen).
ITokenCacheSerializer.SerializeAdalV3()	Tokencache voor het opslaan van toegangs- en vernieuwingstokens voor accounts Deze klasse wordt gebruikt in de constructors van PublicClientApplication en ConfidentialClientApplication. In het geval van ConfidentialClientApplication worden twee exemplaren gebruikt, één voor de gebruikerstokencache en één voor de toepassingstokencache (in het geval van toepassingen die gebruikmaken van de clientreferentiestromen).
ITokenCacheSerializer.SerializeMsalV2()	Tokencache voor het opslaan van toegangs- en vernieuwingstokens voor accounts Deze klasse wordt gebruikt in de constructors van PublicClientApplication en ConfidentialClientApplication. In het geval van ConfidentialClientApplication worden twee exemplaren gebruikt, één voor de gebruikerstokencache en één voor de toepassingstokencache (in het geval van toepassingen die gebruikmaken van de clientreferentiestromen).
ITokenCacheSerializer.SerializeMsalV3()	Tokencache voor het opslaan van toegangs- en vernieuwingstokens voor accounts Deze klasse wordt gebruikt in de constructors van PublicClientApplication en ConfidentialClientApplication. In het geval van ConfidentialClientApplication worden twee exemplaren gebruikt, één voor de gebruikerstokencache en één voor de toepassingstokencache (in het geval van toepassingen die gebruikmaken van de clientreferentiestromen).

Extensiemethoden

Name

Description

SetCacheOptions(ITokenCache, CacheOptions)

Opties voor MSAL-tokencaches. MSAL onderhoudt intern een tokencache in het geheugen. Dit cacheobject maakt standaard deel uit van elk exemplaar van PublicClientApplication of ConfidentialClientApplication. Met deze methode kunt u de cache van het in-memory token van MSAL aanpassen. De geheugencache van MSAL verschilt van de serialisatie van tokencaches. Met cacheserialisatie worden de tokens opgehaald uit een cache (bijvoorbeeld Redis, Cosmos of een bestand op schijf), waar ze zijn opgeslagen in JSON-indeling, in de interne geheugencache van MSAL. Geheugencachebewerkingen omvatten geen JSON-bewerkingen. Serialisatie van externe cache blijft de aanbevolen manier om bureaublad-apps, website- en web-API's te verwerken, omdat deze persistentie biedt. Deze opties beheren momenteel geen serialisatie van externe cache. Gedetailleerde richtlijnen voor elk toepassingstype en elk platform: https://aka.ms/msal-net-token-cache-serialization