Inicialización del objeto de aplicación cliente público en el nodo MSAL

En este artículo, aprenderá a inicializar el objeto PublicClientApplication en MSAL Node y a configurar la autoridad.

Prerequisites

Antes de inicializar una aplicación, primero debe registrarla en el Centro de administración Microsoft Entra, estableciendo una relación de confianza entre la aplicación y la Plataforma de identidad de Microsoft.

Después de registrar la aplicación, necesitará algunos o todos los valores siguientes que se pueden encontrar en el Centro de administración Microsoft Entra.

Value Obligatorio Description
Id. de aplicación (cliente) Obligatorio Un GUID que identifica de forma única su aplicación en la plataforma de identidad de Microsoft.
Autoridad Optional La dirección URL del proveedor de identidades (la instancia) y la audiencia de inicio de sesión de la aplicación. La instancia y la audiencia de inicio de sesión, cuando se concatenan, constituyen la autoridad.
Id. de directorio (inquilino) Optional Especifique el identificador de directorio (inquilino) si va a compilar una aplicación de línea de negocio exclusivamente para su organización, en ocasiones denominada aplicación de un único inquilino.
URI de redirección Optional Si va a crear una aplicación web, redirectUri especifica dónde debe devolver el proveedor de identidades (la plataforma de identidad de Microsoft) los tokens de seguridad que ha emitido.

Inicialización del objeto PublicClientApplication

Para usar el nodo MSAL, debe crear una instancia de un objeto PublicClientApplication . Se admite y se recomienda encarecidamente el uso de PKCE (clave de prueba para código Exchange) para cualquier publicClientApplication. El patrón de uso se muestra en el ejemplo PKCE.

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

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

Conceptos básicos de configuración

Las opciones de configuración para el nodo tienen common parámetros y specific parámetros por flujo de autenticación.

  • client_id es obligatorio inicializar una aplicación cliente pública.
  • authority el valor predeterminado es https://login.microsoftonline.com/common/ si el usuario no lo establece durante la configuración.

Para obtener más opciones en Configuración , consulte Configuración en el nodo MSAL.

Configurar autoridad

De forma predeterminada, MSAL está configurado con el tenant common, que se usa para aplicaciones multi-tenant y aplicaciones que permiten cuentas personales (no B2C).

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

Si el público de su aplicación es un único inquilino, debe proporcionar una autoridad con su ID de inquilino como se muestra a continuación:

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

Si la aplicación usa una autoridad independiente compatible con OIDC, como "https://login.live.com" o IdentityServer, deberá proporcionarla en el campo knownAuthorities y establecer protocolMode en "OIDC".

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

Pasos siguientes

Adquisición de tokens en el nodo MSAL

  • Last updated on