Использование MSAL Browser в приложениях JavaScript

Библиотека MSAL для JavaScript позволяет клиентским приложениям JavaScript выполнять аутентификацию пользователей с помощью рабочих и учебных учетных записей Microsoft Entra ID, личных учетных записей Microsoft (MSA) и поставщиков удостоверений социальных сетей, таких как Facebook, Google, LinkedIn, учетные записи Microsoft и т. д., через службу Azure AD B2C. Это также позволяет приложению получать маркеры для доступа к службам Microsoft Cloud, таким как Microsoft Graph.

Пакет @azure/msal-browser включает проверку подлинности в одностраничных приложениях JavaScript с помощью потока кода авторизации OAuth 2.0 с PKCE. Он не поддерживает неявный поток. Текущая версия — MSAL.js v5.x. Если вы используете более раннюю версию, ознакомьтесь с руководствами по миграции для обновления.

Необходимые условия

• @azure/msal-browser предназначено для использования в сценариях одностраничных приложений.

• Прежде чем использовать @azure/msal-browser, необходимо зарегистрировать одностраничное приложение в Microsoft Entra ID, чтобы получить допустимый clientId для настройки, а также зарегистрировать URI перенаправления, которые будет принимать ваше приложение.

Ключевые особенности

MSAL Browser предоставляет следующие возможности для одностраничных приложений:

• Вход пользователей с помощью всплывающих или перенаправленийных потоков
• Получение токенов без вмешательства пользователя из кэша или путём обновления
• Поддержка сценариев всплывающих окон для политики Cross-Origin-Opener-Policy (COOP)
• Проверка подлинности протокола контекста модели (MCP)
• Токены, привязанные к устройству, через брокер платформы (WAM)
• Кэш токенов в localStorage, зашифрованный с помощью AES-GCM
• Подтверждение владения (PoP) токенов
• Единый вход на вкладках и приложениях
• Вложенная проверка подлинности приложений (NAA) для приложений Microsoft 365

Installation

Через NPM

npm install @azure/msal-browser

Samples

Папка msal-browser-samples содержит примеры приложений для наших библиотек.

Дополнительные инструкции по выполнению примеров можно найти в README.md файле папки VanillaJSTestApp2.0.

Более сложные примеры, поддерживаемые руководством, можно найти в пространстве примеров Azure на GitHub:

• Вызов веб-API Express.js из JavaScript SPA
• Вызов Microsoft Graph из JavaScript SPA через веб-API Express.js с использованием потока on-behalf-of
• Руководство по развертыванию Служба приложений Azure и служба хранилища Azure

Обёртки фреймворка

Если вы используете платформу, например Angular или React, вам может потребоваться использовать одну из наших библиотек оболочки:

• Angular: @azure/msal-angular (текущая версия: v5.1.1)
• React: @azure/msal-react (current: v5.0.6)

Дальнейшие действия

• Инициализация приложения
• Настройка браузера MSAL
• Вход пользователей