JavaScript için Microsoft Kimlik Doğrulama Kitaplığı (MSAL.js)

JavaScript için Microsoft Kimlik Doğrulama Kitaplığı, hem istemci tarafı hem de sunucu tarafı JavaScript uygulamalarının iş ve okul hesapları, Microsoft kişisel hesaplar (MSA) ve sosyal kimlik sağlayıcıları için Microsoft Entra ID kullanarak kullanıcıların kimliğini doğrulamasını sağlar Azure AD B2C hizmeti aracılığıyla Facebook, Google, LinkedIn, Microsoft hesapları vb. Ayrıca uygulamanızın Microsoft Graph gibiMicrosoft Cloud hizmetlere erişmek için belirteçler almasına da olanak tanır.

Çekirdek ve sarmalayıcı kitaplıkları

klasör, lib etkin geliştirmedeki MSAL.js kitaplıklarının kaynak kodunu içerir. Kitaplıkları yükleme hakkındaki tüm ayrıntıları ilgili README.md dosyalarında da bulabilirsiniz.

• Node.js için Microsoft Kimlik Doğrulama Kitaplığı (v5.0.6): JavaScript uygulamalarında Microsoft Kimlik platformuyla kimlik doğrulaması ve belirteç almayı sağlayan bir Node.js kitaplığıdır. Aşağıdaki OAuth 2.0 protokollerini uygular ve OpenID ile uyumludur. GitHub'da kaynağa bakın.

  • PKCE ile Yetkilendirme Kodu Verme
  • Cihaz Kodu Verme
  • Yenileme Jetonu Yetkilendirmesi
  • İstemci Kimlik Bilgisi Verme
  • Sessiz Akış
  • Flow adına
  • Etkileşimli Akış
  • Yönetilen Kimlik

• JavaScript için Microsoft Kimlik Doğrulama Kitaplığı (v5.4.0): JavaScript uygulamalarında Microsoft Kimlik platformuyla kimlik doğrulaması ve belirteç almayı etkinleştiren tarayıcı tabanlı, çerçeveden bağımsız bir tarayıcı kitaplığı. PKCE ile OAuth 2.0 Yetkilendirme Kodu Akışını uygular ve OpenID ile uyumludur. GitHub'da kaynağa bakın.

• MSAL'de yerel kimlik doğrulama desteği: MSAL JS, uygulamaların web uygulamalarında uçtan uca özelleştirilebilir akışlarla yerel bir deneyim uygulamasına olanak sağlayan yerel kimlik doğrulama API'leri sağlar. Yerel kimlik doğrulaması ile kullanıcı, tasarım öğeleri, logo yerleşimi ve düzen dahil olmak üzere kullanıcı arabirimini tamamen özelleştirerek tutarlı ve markalı bir görünüm elde edebilir. Yerel kimlik doğrulama özelliği, Müşteriler için External ID üzerindeki SPA'larda kullanılabilir.

• React için Microsoft Kimlik Doğrulama Kitaplığı (v5.0.6): React kullanan uygulamalar için msal-browser kitaplığının sarmalayıcısı. GitHub'da kaynağa bakın.

• Angular için Microsoft Kimlik Doğrulama Kitaplığı (v5.1.1): Angular çerçevesini kullanan uygulamalar için msal-browser kitaplığının sarmalayıcısı. GitHub'da kaynağa bakın.

• Node için Microsoft Kimlik Doğrulama Uzantıları: Node için Microsoft Kimlik Doğrulama Uzantıları, istemci uygulamalarının platformlar arası belirteç önbelleğinin serileştirilmesi ve kalıcı olarak depolanması için güvenli mekanizmalar sunar. Node için Microsoft Kimlik Doğrulama Kitaplığı (MSAL) için ek destek sağlar.

v5'teki yenilikler

MSAL.js v5 birkaç temel özellik sunar:

• Cross-Origin-Opener-Policy (COOP) desteği: Katı COOP başlıklarına sahip ortamlarda açılır pencere kimlik doğrulama akışlarını etkinleştirir.
• Model Bağlam Protokolü (MCP) kimlik doğrulaması: Yapay zeka aracısı ve araç tümleştirmeleri için kimlik doğrulama akışlarını destekler.
• İç İçe Uygulama Kimlik Doğrulaması (NAA): kullanarak createNestablePublicClientApplicationMicrosoft 365 konak uygulamaları içinde çalışan uygulamalar için kimlik doğrulamasını etkinleştirir.
• localStorage AES-GCM şifreleme: Gelişmiş güvenlik için AES-GCM kullanarak localStorage'daki belirteç önbelleğini şifreler.
• Fabrika fonksiyonları: MSAL'yi eşzamansız yapılandırmayla başlatmak için createStandardPublicClientApplication veya createNestablePublicClientApplication kullanın.
• Platform aracısı (WAM) tümleştirmesi: Yapılandırma seçeneği aracılığıyla Windows Authentication Manager (WAM) aracılı kimlik doğrulamasını allowPlatformBroker etkinleştirin.

MSAL JavaScript v5.x'e geçiş kılavuzları için bkz:

• MSAL Browser v4'e v5 geçişi
• MSAL Düğümü v3'e v5 geçişi
• MSAL Angular v4'e v5 yükseltmesi
• MSAL React geçiş kılavuzu

Uzun Vadeli Destekteki (LTS) Kitaplıklar

Aşağıdaki tabloda, her MSAL.js kitaplığı için etkin ve LTS sürümleri gösterilmektedir:

Dalda barındırılan msal-ltsLTS kitaplıkları artık etkin geliştirme aşamasında değildir ancak kritik güvenlik hata düzeltme desteği almaya devam eder.

• JavaScript için Microsoft Kimlik Doğrulama Kitaplığı v2.x
• Node.js v1.x için Microsoft Kimlik Doğrulama Kitaplığı
• React için Microsoft Kimlik Doğrulama Kitaplığı v1.x
• Angular için Microsoft Kimlik Doğrulama Kitaplığı v2.x

Paket yapısı

Farklı platformlar için bir dizi farklı paket vardır. Aşağıdaki paket yapısında paketler ve uyguladıkları farklı kimlik doğrulama akışları arasındaki ilişkiyi görebilirsiniz.

Samples

, code samples kimlik platformuyla JavaScript için Microsoft kimlik doğrulama kitaplıklarının kullanımını gösterir. Her kod örneği, projenin nasıl derleneceğini (uygunsa) ve örnek uygulamanın nasıl çalıştırılacağını açıklayan bir README.md dosyası içerir.

JavaScript'i ve diğer dilleri, çerçeveleri ve platformları hedefleyen örneklerin tam listesi için lütfen Microsoft kimlik platformu kod örneklerine bakın.

Yerel kimlik doğrulama özellikleri için örnek uygulamalar React ve Angular web uygulamalarında yerel kimlik doğrulamasının nasıl kullanılacağını gösterir. Her kod örneği, projenin nasıl derlenip örnek uygulamayı çalıştıracaklarını açıklayan bir README.md dosya içerir. Geçerli yerel kimlik doğrulama API'si Çıkış Noktaları Arası Kaynak Paylaşımı'nı (CORS) desteklemez; örnek uygulama yerel ara sunucu kullanılarak çalıştırılır.

Paket sürümleme

Tüm kitaplıklarımız anlamsal sürüm oluşturma işlemini izler. En son güvenlik düzeltme eklerine ve hata düzeltmelerine sahip olduğunuzdan emin olmak için her kitaplığın en son sürümünü kullanmanızı öneririz.

Güvenlik raporlaması

Kitaplıklarımız veya hizmetlerimizle ilgili bir güvenlik sorunu bulursanız lütfen mümkün olduğunca ayrıntılı bir şekilde Microsoft Güvenlik Yanıt Merkezi (MSRC) bölümüne bildirin.