TokenCachePersistenceOptions Klasse

Definition

Namespace:

Azure.Identity

Assembly:

Azure.Identity.dll

Paket:

Azure.Identity v1.12.0

Quelle:

TokenCachePersistenceOptions.cs

Optionen, die die Speicherung des Tokencaches steuern.

public class TokenCachePersistenceOptions

type TokenCachePersistenceOptions = class

Public Class TokenCachePersistenceOptions

Vererbung

Object

TokenCachePersistenceOptions

Abgeleitet

Azure.Identity.UnsafeTokenCacheOptions

Beispiele

Dies ist ein Beispiel, das zeigt, wie TokenCachePersistenceOptions und ein AuthenticationRecord zusammen verwendet werden können, um die automatische Authentifizierung über die Ausführungen einer Clientanwendung hinweg zu aktivieren.

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);

Konstruktoren

TokenCachePersistenceOptions()

Optionen, die die Speicherung des Tokencaches steuern.

Eigenschaften

Name	Benennen Sie eindeutig, um die TokenCachePersistenceOptionszu identifizieren.
UnsafeAllowUnencryptedStorage	Wenn true festgelegt ist, wird der Tokencache möglicherweise als unverschlüsselte Datei beibehalten, wenn keine Benutzerverschlüsselung auf Betriebssystemebene verfügbar ist. Wenn dieser Wert auf false festgelegt ist, löst der Tokencache eine aus CredentialUnavailableException , falls keine Benutzerverschlüsselung auf Betriebssystemebene verfügbar ist.