MSAL Node’da ortak istemci uygulaması nesnesini başlatma

Bu makalede, MSAL Node'da nesneyi başlatmayı PublicClientApplication ve yetkiliyi yapılandırmayı öğreneceksiniz.

Prerequisites

Bir uygulamayı başlatmadan önce, uygulamanızla Microsoft kimlik platformu arasında bir güven ilişkisi kurarak uygulamayı Microsoft Entra yönetim merkezi kaydetmeniz gerekir.

Uygulamanızı kaydettikten sonra, Microsoft Entra yönetim merkezi bulunabilecek aşağıdaki değerlerin bir kısmına veya tümüne ihtiyacınız olacaktır.

Değer Zorunlu Description
Uygulama (istemci) kimliği Zorunlu uygulamanızı Microsoft kimlik platformu içinde benzersiz olarak tanımlayan bir GUID.
Yetkili Optional Uygulamanızın kimlik sağlayıcısı URL'si ( örnek) ve oturum açma hedef kitlesi . Örnek ve oturum açma hedef kitlesi, birleştirilirken yetkiliyi oluşturur.
Dizin (kullanıcı) kimliği Optional Yalnızca kuruluşunuz için bir iş kolu uygulaması oluşturuyorsanız (genellikle tek kiracılı uygulama olarak adlandırılır) Dizin (kiracı) kimliğini belirtin.
Yeniden yönlendirme URI'si Optional Bir web uygulaması oluşturuyorsanız, redirectUri kimlik sağlayıcısının (Microsoft kimlik platformu) verilen güvenlik belirteçlerini nereye döndüreceği belirtir.

PublicClientApplication nesnesini başlatma

MSAL Düğümünü kullanmak için bir PublicClientApplication nesnesi örneği oluşturmanız gerekir. Tüm PublicClientApplication için PKCE (Kod Exchange için Proof Key) kullanımını destekliyor ve kesinlikle öneririz. Kullanım düzeni PKCE Örneğinde gösterilmiştir.

import * as msal from "@azure/msal-node";

const clientConfig = {
    auth: {
        clientId: "your_client_id",
        authority: "your_authority",
    }
};
const pca = new msal.PublicClientApplication(clientConfig);

Yapılandırma Temelleri

Düğüm için Yapılandırma seçeneklerinde, kimlik doğrulama akışı başına common parametre ve specific parametre bulunur.

  • client_id genel istemci uygulamasını başlatmak için zorunludur
  • authority https://login.microsoftonline.com/common/ kullanıcı yapılandırma sırasında ayarlamazsa varsayılan olarak ayarlanır

Yapılandırma hakkında daha fazla seçenek için bkz. MSAL Düğümünde Yapılandırma.

Yetkiliyi Yapılandırma

Varsayılan olarak MSAL, çok kiracılı uygulamalar ve kişisel hesaplara (B2C değil) izin veren uygulamalar için kullanılan kiracı ile common yapılandırılır.

const msalConfig = {
    auth: {
        clientId: 'your_client_id',
        authority: 'https://login.microsoftonline.com/common/'
    }
};

Uygulamanızın hedef kitlesi tek kiracılıysa, aşağıdaki gibi kiracı kimliğinizle bir yetki belirtmeniz gerekir:

const msalConfig = {
    auth: {
        clientId: 'your_client_id',
        authority: 'https://login.microsoftonline.com/{your_tenant_id}'
    }
};

Uygulamanız, "https://login.live.com" veya IdentityServer gibi ayrı bir OIDC uyumlu yetkilendirme sunucusu kullanıyorsa, bunu knownAuthorities alanında belirtmeniz ve protocolMode değerini "OIDC" olarak ayarlamanız gerekir.

const msalConfig = {
    auth: {
        clientId: 'your_client_id',
        authority: 'https://login.live.com',
        knownAuthorities: ["login.live.com"],
        protocolMode: "OIDC"
    }
};

Sonraki Adımlar

MSAL Node'da belirteç alma

  • Last updated on