Azure Identity Plugin for Token Cache Persistence

Bu paket, JavaScript için Azure Identity kütüphanesine (@azure/identity) kalıcı token önbellekleme imkanı sağlayan bir eklenti sağlar. Token önbellek kalıcılığı, yerleşik token önbelleğinin yerel işletim sistemi tarafından sağlanan güvenli depolama sistemi kullanılarak oturumlar arasında devam etmesini sağlar.

Kaynak kodu | Örnekler

Başlangıç Yapmak

Önkoşullar

Paketi yükle

Bu paket, JavaScript için Azure Identity ile kullanılmak üzere tasarlanmıştır. @azure/identitykullanarak hem npm hem de bu paketi yükleyin:

$ npm install --save @azure/identity
$ npm install --save @azure/identity-cache-persistence

Desteklenen Ortamlar

Azure JavaScript için Identity eklentileri, v12'den itibaren stabil (çift numaralı) Node.js sürümlerini destekler. Eklentiler diğer Node sürümlerinde çalışabilir, ancak destek garanti değildir. @azure/identity-cache-persistence tarayıcı ortamlarını desteklemez.

Temel kavramlar

Eğer veya Microsoft Entra ID kullanıyorsanız, önce ile Microsoft Entra ID okumanızı öneririz. Bu belge, platformu daha derinlemesine anlamanızı ve Azure hesabınızı nasıl doğru şekilde yapılandırmanızı sağlayacak.

Azure Identity Plugins

@azure/identity sürüm 2.0.0'dan itibaren JavaScript için Kimlik istemci kitaplığı bir eklenti API'sini içerir. Bu paket (@azure/identity-cache-persistence), bağımsız değişken olarak geçirmeniz gereken eklenti nesnesini useIdentityPlugin paketinden üst düzey @azure/identity işlevine aktarır. Programınızda token önbellek kalıcılığını aşağıdaki gibi etkinleştirin:

import { useIdentityPlugin } from "@azure/identity";
import { cachePersistencePlugin } from "@azure/identity-cache-persistence";

useIdentityPlugin(cachePersistencePlugin);

Çağrıldıktan useIdentityPluginsonra, kalıcı token önbellek eklentisi pakete @azure/identity kaydedilir ve kalıcı token önbelleklemeyi destekleyen tüm kimlik bilgilerinde (yapıcı seçeneklerinde olanlar tokenCachePersistenceOptions ) kullanılabilir olur.

Örnekler

Eklenti kaydedildikten sonra, bir özellik ayarıyla true bir kimlik tanımı oluşturucuya aktararak tokenCachePersistenceOptionsenabled token önbellek kalıcılığını etkinleştirebilirsiniz. Aşağıdaki örnekte, belirteçlerinin sürekli önbelleğe kaydedilmesi, önbelleklenmiş bir token varsa etkileşimli cihaz-kod kimlik doğrulama akışını atlamanıza olanak DeviceCodeCredentialtanır.

import { DeviceCodeCredential } from "@azure/identity";

const credential = new DeviceCodeCredential({
  tokenCachePersistenceOptions: {
    enabled: true,
  },
});

// We'll use the Microsoft Graph scope as an example
const scope = "https://graph.microsoft.com/.default";

// Print out part of the access token
console.log((await credential.getToken(scope)).token.substring(0, 10), "...");

Sorun giderme

Ağaç kesimi

Loglamayı etkinleştirmek, hatalarla ilgili yararlı bilgilerin ortaya çıkmasına yardımcı olabilir. HTTP isteklerinin ve yanıtlarının günlüğünü görmek için ortam değişkenini AZURE_LOG_LEVEL olarak infoayarlayın. Alternatif olarak, çalışma zamanında setLogLevel@azure/logger çağrılarak günlük tutma etkinleştirilebilir.

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Sonraki Adımlar

Geri Bildirim Sağla

Hata ile karşılaşırsanız veya önerileriniz varsa, lütfen bir sorunu açın.

Contributing

Bu kütüphaneye katkıda bulunmak isterseniz, kodun nasıl oluşturulacağı ve test edileceği hakkında daha fazla bilgi edinmek için lütfen katkı rehberi adresini okuyun.