Inicializace objektu veřejné klientské aplikace v uzlu MSAL

V tomto článku se dozvíte, jak inicializovat PublicClientApplication objekt v uzlu MSAL a jak nakonfigurovat autoritu.

Předpoklady

Před inicializací aplikace ji nejprve musíte zaregistrovat v Centrum pro správu Microsoft Entra a vytvořit vztah důvěryhodnosti mezi vaší aplikací a Microsoft identity platform.

Po registraci aplikace budete potřebovat některé nebo všechny následující hodnoty, které najdete v Centrum pro správu Microsoft Entra.

Value Povinné Description
ID aplikace (klienta) Povinné Identifikátor GUID, který jednoznačně identifikuje vaši aplikaci v rámci Microsoft identity platform.
Autorita Optional Adresa URL zprostředkovatele identity ( instance) a cílová skupina přihlašování pro vaši aplikaci. Instance a okruh uživatelů pro přihlášení po zřetězení tvoří autoritu.
ID adresáře (klienta) Optional Zadejte ID adresáře (tenanta), pokud vytváříte obchodní aplikaci výhradně pro vaši organizaci, často označovanou jako aplikace s jedním tenantem.
Přesměrování URI Optional Pokud vytváříte webovou aplikaci, redirectUri určuje, kam má poskytovatel identity (platforma Microsoft identity) vracet bezpečnostní tokeny, které vydal.

Inicializace objektu PublicClientApplication

Pokud chcete použít uzel MSAL, musíte vytvořit instanci objektu PublicClientApplication . Podporujeme a důrazně doporučujeme používat pkCE (proof key for Code Exchange) pro libovolnou aplikaci PublicClientApplication. Vzor použití je ukázaný v ukázce PKCE.

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

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

Základy konfigurace

Možnosti konfigurace uzlu mají common parametry a specific parametry pro každý tok ověřování.

  • client_id je povinné pro inicializaci veřejné klientské aplikace.
  • authority má výchozí hodnotu https://login.microsoftonline.com/common/, pokud ji uživatel při konfiguraci nenastaví

Další možnosti konfigurace najdetev tématu Konfigurace v uzlu MSAL.

Nakonfigurovat autoritu

Ve výchozím nastavení je služba MSAL nakonfigurovaná s tenantem common , který se používá pro aplikace a aplikace s více tenanty, které povolují osobní účty (ne B2C).

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

Pokud je cílová skupina vaší aplikace jedním tenantem, musíte zadat autoritu s ID vašeho tenanta, například níže:

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

Pokud vaše aplikace používá samostatnou autoritu kompatibilní s OIDC, například "https://login.live.com" nebo IdentityServer, budete ji muset zadat do pole knownAuthorities a nastavit protocolMode na "OIDC".

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

Další kroky

Získání tokenů v uzlu MSAL

  • Last updated on