TokenCachePersistenceOptions Clase

Definición

Espacio de nombres:

Azure.Identity

Ensamblado:

Azure.Identity.dll

Paquete:

Azure.Identity v1.11.4

Source:

TokenCachePersistenceOptions.cs

Opciones que controlan el almacenamiento de la caché de tokens.

public class TokenCachePersistenceOptions

type TokenCachePersistenceOptions = class

Public Class TokenCachePersistenceOptions

Herencia

Object

TokenCachePersistenceOptions

Derivado

Azure.Identity.UnsafeTokenCacheOptions

Ejemplos

Este es un ejemplo que muestra cómo se puede usar TokenCachePersistenceOptions y AuthenticationRecord juntos para habilitar la autenticación silenciosa en las ejecuciones de una aplicación cliente.

const string TOKEN_CACHE_NAME = "MyTokenCache";
InteractiveBrowserCredential credential;
AuthenticationRecord authRecord;

// Check if an AuthenticationRecord exists on disk.
// If it does not exist, get one and serialize it to disk.
// If it does exist, load it from disk and deserialize it.
if (!File.Exists(AUTH_RECORD_PATH))
{
    // Construct a credential with TokenCachePersistenceOptions specified to ensure that the token cache is persisted to disk.
    // We can also optionally specify a name for the cache to avoid having it cleared by other applications.
    credential = new InteractiveBrowserCredential(
        new InteractiveBrowserCredentialOptions { TokenCachePersistenceOptions = new TokenCachePersistenceOptions { Name = TOKEN_CACHE_NAME } });

    // Call AuthenticateAsync to fetch a new AuthenticationRecord.
    authRecord = await credential.AuthenticateAsync();

    // Serialize the AuthenticationRecord to disk so that it can be re-used across executions of this initialization code.
    using var authRecordStream = new FileStream(AUTH_RECORD_PATH, FileMode.Create, FileAccess.Write);
    await authRecord.SerializeAsync(authRecordStream);
}
else
{
    // Load the previously serialized AuthenticationRecord from disk and deserialize it.
    using var authRecordStream = new FileStream(AUTH_RECORD_PATH, FileMode.Open, FileAccess.Read);
    authRecord = await AuthenticationRecord.DeserializeAsync(authRecordStream);

    // Construct a new client with our TokenCachePersistenceOptions with the addition of the AuthenticationRecord property.
    // This tells the credential to use the same token cache in addition to which account to try and fetch from cache when GetToken is called.
    credential = new InteractiveBrowserCredential(
        new InteractiveBrowserCredentialOptions
        {
            TokenCachePersistenceOptions = new TokenCachePersistenceOptions { Name = TOKEN_CACHE_NAME },
            AuthenticationRecord = authRecord
        });
}

// Construct our client with the credential which is connected to the token cache
// with the capability of silent authentication for the account specified in the AuthenticationRecord.
var client = new SecretClient(new Uri("https://myvault.vault.azure.net/"), credential);

Constructores

TokenCachePersistenceOptions()

Opciones que controlan el almacenamiento de la caché de tokens.

Propiedades

Name	Nombre que identifica de forma única el TokenCachePersistenceOptionsobjeto .
UnsafeAllowUnencryptedStorage	Si se establece en true, la caché de tokens se puede conservar como un archivo sin cifrar si no hay ningún cifrado de usuario de nivel de sistema operativo disponible. Cuando se establece en false, la caché de tokens producirá un CredentialUnavailableException en caso de que no haya ningún cifrado de usuario de nivel de sistema operativo disponible.