Belirteç Önbelleği Kalıcılığı için Azure Kimlik Eklentisi

Makale
04/05/2023

Bu paket, JavaScript (@azure/identity) için Azure Identity kitaplığına kalıcı belirteç önbelleğe almayı etkinleştiren bir eklenti sağlar. Belirteç önbelleği kalıcılığı, yerleşik belirteç önbelleğinin yerel işletim sistemi tarafından sağlanan güvenli bir depolama sistemi kullanarak oturumlar arasında kalıcı olmasını sağlar.

Kaynak kodu | Örnekleri

Başlarken

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

useIdentityPlugin(cachePersistencePlugin);

Önkoşullar

Bir Azure aboneliği.

Paketi yükleme

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

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

Desteklenen Ortamlar

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

Önemli kavramlar

veya Microsoft kimlik platformu (Azure Active Directory) ilk kez kullanıyorsanız@azure/identity, önce Microsoft Identity Platform ile kullanma @azure/identity makalesini okumanızı öneririz. Bu belge size platformu ve Azure hesabınızı doğru yapılandırmayı daha iyi anlamanızı sağlayacaktır.

Azure Kimlik Eklentileri

@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), paketten @azure/identity en üst düzey useIdentityPlugin işleve bağımsız değişken olarak geçirmeniz gereken bir eklenti nesnesini dışarı aktarır. Programınızda belirteç önbelleği 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ısından useIdentityPluginsonra, kalıcı belirteç önbelleği eklentisi pakete @azure/identity kaydedilir ve kalıcı belirteç önbelleğe almayı destekleyen tüm kimlik bilgileri (oluşturucu seçeneklerinde olanlar tokenCachePersistenceOptions ) kullanılabilir.

Örnekler

Eklenti kaydedildikten sonra, kimlik bilgisi oluşturucuya ayarlanmış true bir enabled özellik ile geçirerek tokenCachePersistenceOptions belirteç önbelleği kalıcılığını etkinleştirebilirsiniz. Aşağıdaki örnekte, belirteçlerinin kalıcı olarak önbelleğe alınmasının, önbelleğe alınmış bir belirteç varsa etkileşimli cihaz kodu kimlik doğrulama akışını atlamanıza olanak sağladığından, değerini kullanırız DeviceCodeCredential.

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

useIdentityPlugin(cachePersistencePlugin);

async function main() {
  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.substr(0, 10), "...");
}

main().catch((error) => {
  console.error("An error occurred:", error);
  process.exit(1);
});

Sorun giderme

Günlüğe Kaydetme

Günlüğe kaydetmenin etkinleştirilmesi hatalarla ilgili yararlı bilgilerin ortaya çıkarılması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, günlüğü çalışma zamanında içinde çağrılarak setLogLevel@azure/loggeretkinleştirilebilir:

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

setLogLevel("info");

Sonraki adımlar

Geri Bildirim Sağlama

Hatalarla karşılaşırsanız veya önerileriniz varsa lütfen bir sorun açın.

Katkıda bulunma

Bu kitaplığa katkıda bulunmak isterseniz, kodu derleme ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzunu okuyun.

İzlenimler

Aracılığıyla paylaş