ITokenCacheSerializer.DeserializeAdalV3(Byte[]) Method

Definition

Deserializes a part of the token cache - the refresh tokens - to the ADAL.NET 3.x cache format.
This API should only be used to maintain SSO between an application using ADAL 3.x and this application using MSAL 3.x or later. Use SerializeAdalV3()/DeserializeAdalV3(Byte[]) in addition to SerializeMsalV3()/DeserializeMsalV3(Byte[], Boolean).

See https://aka.ms/adal-to-msal-net/cache for details on how to use this advanced API correctly.

public void DeserializeAdalV3 (byte[] adalV3State);
abstract member DeserializeAdalV3 : byte[] -> unit
Public Sub DeserializeAdalV3 (adalV3State As Byte())

Parameters

adalV3State
Byte[]

Byte stream representation of the cache

Remarks

Do not use SerializeAdalV3()/DeserializeAdalV3(Byte[]) without also using SerializeMsalV3()/DeserializeMsalV3(Byte[], Boolean), because only refresh tokens are exported in this format. Your applications will not cache access token and id tokens, and will instead need to get them from the identity provider (AAD), which will eventually throttle you. Later versions of ADAL (4.x and 5.x) use the same cache format as MSAL. Only SerializeMsalV3()/DeserializeMsalV3(Byte[], Boolean) is compatible with other MSAL libraries such as MSAL for Python and MSAL for Java. ADAL to MSAL cache interop is only available for public client scenarios and for web site scenario.

Applies to