Inicializar o objeto da aplicação cliente pública no MSAL Node

Neste artigo, vai aprender como inicializar o PublicClientApplication objeto no MSAL Node e como configurar a autoridade.

Pré-requisitos

Antes de inicializar uma aplicação, precisa primeiro de a registar no centro de administração Microsoft Entra, estabelecendo uma relação de confiança entre a sua aplicação e a plataforma de identidades da Microsoft.

Depois de registar a sua aplicação, precisará de alguns ou todos os valores seguintes que podem ser encontrados no centro de administração Microsoft Entra.

Value Obrigatório Description
ID do aplicativo (cliente) Obrigatório Um GUID que identifica de forma única a sua aplicação dentro da plataforma de identidades da Microsoft.
Autoridade Optional O URL do fornecedor de identidade (a instância) e o público de início de sessão da sua aplicação. A instância e o público de iniciação de sessão, quando concatenados, constituem a autoridade.
ID da diretoria (tenant) Optional Especifique o ID do diretório (locatário) se estiver a criar uma aplicação empresarial exclusivamente para a sua organização, frequentemente designada por uma aplicação de locatário único.
Redirecionar URL Optional Se estiver a criar uma aplicação Web, o redirectUri especifica onde o fornecedor de identidade (a plataforma de identidade da Microsoft) deve devolver os tokens de segurança que emitiu.

Inicialização do objeto PublicClientApplication

Para usar o MSAL Node, é necessário instanciar um objeto PublicClientApplication . Apoiamos e recomendamos fortemente o uso do PKCE (Proof Key for Code Exchange) para qualquer PublicClientApplication. O padrão de utilização é demonstrado na Amostra PKCE.

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

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

Noções básicas de configuração

As opções de configuração para nó têm common parâmetros e specific parâmetros por fluxo de autenticação.

  • client_id é obrigatório para inicializar uma aplicação pública de cliente
  • authority assume por defeito o valor de https://login.microsoftonline.com/common/ se o utilizador não o definir durante a configuração

Para mais opções sobre Configuração , consulte Configuração no Nó MSAL.

Configurar Autoridade

Por predefinição, o MSAL é configurado com o inquilino common, que é utilizado para aplicações multi-inquilino e aplicações que permitem contas pessoais (não B2C).

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

Se o seu público de candidatura for um único inquilino, deve fornecer uma autoridade com o seu ID de inquilino, como segue:

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

Se a sua aplicação estiver a usar uma autoridade separada compatível com OIDC, como "https://login.live.com" ou um IdentityServer, terá de a fornecer no knownAuthorities campo e definir o seu protocolMode para "OIDC".

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

Próximas Etapas

Adquirir tokens no MSAL Node

  • Last updated on