Поделиться через

Примеры кода платформы удостоверений Майкрософт для проверки подлинности и авторизации

  • Статья

Эти примеры кода создаются и обслуживаются корпорацией Майкрософт для демонстрации использования библиотек проверки подлинности с платформой удостоверений Майкрософт. Распространенные сценарии проверки подлинности и авторизации реализуются в нескольких типах приложений, на различных языках разработки и платформах.

  • Выполните вход пользователей в веб-приложения и предоставьте доступ к защищенным веб-API.
  • Защитите веб-API, запросив маркер доступа для выполнения операций API.

Каждый пример кода включает файл README.md, описывающий, как выполнить сборку проекта (если применимо) и запустить пример приложения. Комментарии в коде помогут понять, как эти библиотеки используются в приложении для выполнения проверки подлинности и авторизации с помощью платформы удостоверений.

Примеры и руководства

Используйте вкладки для сортировки примеров по типу приложения или предпочитаемого языка или платформы.

Одностраничные приложения

В этих примерах показано, как создать одностраничное приложение, защищенное с помощью платформы удостоверений Майкрософт. В этих примерах используется одна из разновидностей MSAL.js.

Язык/
Платформа		 Примеры кода
на GitHub		 Аутентификация
библиотеки		 Поток аутентификации Быстрое начало Учебник
React • Вход пользователей MSAL React Код авторизации с PKCE Краткое руководство Руководство
Angular • Пользователи, вошедшие в систему MSAL Angular Код авторизации с PKCE Краткое руководство Руководство
JavaScript • Вход пользователей
• Вызов Microsoft Graph
• Вызов веб-API Node.js
• Развертывание в службе хранилища Azure и Службе приложений		 MSAL.js Код авторизации с PKCE Краткое руководство
Blazor WebAssembly • Вход пользователей
• Вызов Microsoft Graph
• Развертывание в Службе приложений Azure		 MSAL.js Код авторизации с PKCE Быстрый старт

Веб-приложения

В следующем примере показаны веб-приложения для входа пользователей. В некоторых примерах демонстрируется, как приложение вызывает Microsoft Graph или ваше собственное веб-API с использованием удостоверения пользователя.

Язык и платформа Примеры кода на GitHub Библиотеки проверки подлинности Поток аутентификации Быстрое начало Учебник
ASP.NET • Обучающий пример Microsoft Graph
• Выполнение входа пользователей и вызов Microsoft Graph с разрешениями администратора		 • MSAL.NET
• Microsoft.Identity.Web
• Расширенные сценарии кэша токенов		 • Подключение OpenID
• Код авторизации
• On-Behalf-Of (OBO)		 Краткое руководство
ASP.NET Core • Вход пользователей
• Вызов Microsoft Graph
• Настройка кэша токенов
• Используйте контекст проверки подлинности условного доступа для выполнения поэтапной проверки подлинности
• Граф вызовов (мультитенантный)
• Вызов REST API Azure
• Защита веб-API
• Защита мультитенантного веб-API
• Использование ролей приложений для контроля доступа
• Использование групп безопасности для контроля доступа
• Развертывание в службе хранилища Azure и Службе приложений
• миграция служб федерации Active Directory на Microsoft Entra		 Microsoft.Identity.Web • Подключение OpenID
• Код авторизации
• От имени потока (OBO)		 Краткое руководство Руководство
Blazor • Вход пользователей
• Вызов Microsoft Graph
• Вызов веб-API		 MSAL.NET гибридный поток
Java Spring • Вход пользователей
• Вызов Microsoft Graph
• Использование ролей приложений для контроля доступа
• Использование групп для контроля доступа
• Защита веб-API
• Развертывание в Службе приложений Azure		 MSAL Java Код авторизации Руководство
Сервлеты Java • Вход пользователей
• Вызов Microsoft Graph
• Использование ролей приложений для контроля доступа
• Использование групп безопасности для контроля доступа
• Развертывание в Службе приложений Azure		 MSAL Java Код авторизации Краткое руководство
Node.js Express • Вход пользователей
• Веб-приложение Express, созданное с помощью MSAL Node и платформы удостоверений Microsoft
• Вызов Microsoft Graph
• Вызов Microsoft Graph через прокси-сервер BFF
• Использование ролей приложений для контроля доступа
• Использование групп безопасности для контроля доступа
• Развертывание в Службе приложений Azure		 Узел MSAL • Код авторизации
• Прокси-сервер BFF (Backend-for-Frontend)		 Краткое руководство Руководство
Python Flask • Вход пользователей
• Шаблон для входа в идентификатор Microsoft Entra и при необходимости вызов нижестоящего API (Microsoft Graph)		 MSAL Python Код авторизации Краткое руководство Руководство
Python Django • Войти MSAL Python Код авторизации
Руби • Вход пользователей и вызов Microsoft Graph OmniAuth OAuth2 Код авторизации

Веб-интерфейс API

В следующих примерах показано, как защитить веб-API с помощью платформы удостоверений Майкрософт и как вызывать из веб-API подчиненный API.

Язык/
Платформа		 Примеры кода
на GitHub		 Аутентификация
библиотеки		 Поток аутентификации Быстрое начало Учебник
ASP.NET • Вызов Microsoft Graph MSAL.NET Поток от имени (On-Behalf-Of, OBO) Краткое руководство
ASP.NET Core • Управление доступом (защищенные маршруты) с платформой идентификации Microsoft MSAL.NET От имени (OBO) Краткое руководство Руководство
Java • Защитите ваше веб-API Java Spring Boot с помощью платформы идентификации Microsoft MSAL Java От имени (OBO)
Node.js • Защита веб-API Node.js Узел MSAL Маркер носителя авторизации

Рабочий стол

В следующих примерах показаны общедоступные клиентские приложения, которые обращаются к API Microsoft Graph или веб-API от имени пользователя. Кроме примера классического (консольного) приложения с диспетчером веб-проверки подлинности (WAM), все эти клиентские приложения используют библиотеку проверки подлинности Майкрософт (MSAL).

Язык/
Платформа		 Примеры кода
на GitHub		 Аутентификация
библиотеки		 Поток аутентификации Быстрое начало Учебник
.NET Core • Вызов Microsoft Graph
• Вызов Microsoft Graph с помощью кэша токена
• Вызов Microsoft Graph с помощью пользовательского веб-интерфейса HTML
• Вызов Microsoft Graph с помощью пользовательского браузера HTML
• Вход пользователей с помощью потока кода устройства
• Вызов Microsoft Graph путем входа пользователей с помощью имени пользователя или пароля		 MSAL для .NET • Код авторизации с помощью PKCE
• Код устройства
• Учетные данные пароля владельца ресурса
Java • Вызов Microsoft Graph MSAL Java Встроенная проверка подлинности Windows
Node.js • Вход пользователям Узел MSAL Код авторизации с PKCE Краткое руководство Руководство
Python • Вход пользователей MSAL Python Учетные данные для доступа владельца ресурса
Windows Presentation Foundation (WPF) • Вход пользователей и вызов Microsoft Graph
• Вход пользователя Windows Presentation Foundation (WPF) с защищенным доступом к веб-API (Microsoft Graph)
• Вход пользователей и вызов веб-API ASP.NET Core
• Вход пользователей и вызов Microsoft Graph		 MSAL.NET Код авторизации с PKCE Краткое руководство Руководство

Мобильный

В следующих примерах показаны общедоступные клиентские мобильные приложения, которые обращаются к API Microsoft Graph. Все эти клиентские приложения используют библиотеку проверки подлинности Майкрософт (MSAL).

Язык/
Платформа		 Примеры кода
на GitHub		 Проверка подлинности
библиотеки		 Поток аутентификации Быстрое начало Учебник
.NET Core • Вызов Microsoft Graph с помощью MAUI
• Вызов Microsoft Graph через MAUI с использованием брокера		 MSAL.NET Код авторизации с PKCE
iOS • Вызов встроенного Microsoft Graph MSAL iOS Код авторизации с PKCE Краткое руководство Руководство
Java • Вход пользователей и вызов Microsoft Graph MSAL Android Код авторизации с PKCE Краткое руководство Руководство
Kotlin • Вход пользователей и вызов Microsoft Graph MSAL Android Код авторизации с PKCE
Xamarin • Вход пользователей и вызов Microsoft Graph
• Вход пользователей через брокера и вызов Microsoft Graph		 MSAL.NET Код авторизации с PKCE

Служба / демон

Следующие примеры показывают приложение, которое обращается к API Microsoft Graph с использованием собственного удостоверения (без пользователя).

Язык/
Платформа		 Примеры кода
на GitHub		 Проверка подлинности
библиотеки		 Поток аутентификации Быстрое начало Учебник
.NET • Консольное приложение .NET, которое обращается к защищенному веб-API
• Мультитенант с конечной точкой платформы удостоверений Microsoft		 MSAL для .NET Предоставление учетных данных клиента Краткое руководство Руководство
.NET Core • Вызов Microsoft Graph
• Вызов веб-API
• Использование управляемого удостоверения для вызова MSGraph
• Использование управляемого удостоверения для вызова API
• Рабочая роль, вызывающая API		 Microsoft.Identity.Web Предоставление учетных данных клиента
Java • Вызов Microsoft Graph с помощью секретного ключа
• Вызов Microsoft Graph с помощью сертификата		 MSAL Java Предоставление учетных данных клиента Краткое руководство
Node.js • Вызов Microsoft Graph с помощью секрета Узел MSAL Предоставление учетных данных клиента Краткое руководство Руководство
Python • Вызов Microsoft Graph с помощью секретного ключа
• Вызов Microsoft Graph с помощью сертификата		 MSAL Python Предоставление учетных данных клиента Краткое руководство

Без браузера (без головы)

В следующем примере показано общедоступное клиентское приложение, запущенное на устройстве без веб-браузера. Это приложение может быть программой командной строки или приложением для Linux или Mac либо приложением Интернета вещей. Пример приложения, которое обращается к API Microsoft Graph от имени пользователя, который выполняет интерактивный вход на другом устройстве (например, на мобильном телефоне). Это клиентское приложение использует библиотеку проверки подлинности Майкрософт (MSAL).

Язык/
Платформа		 Примеры кода
на GitHub		 Проверка подлинности
библиотеки		 Поток аутентификации Быстрое начало Учебник
.NET Core • Вызов защищенного API с текстового устройства MSAL.NET Код устройства
Java • Вход пользователей и вызов защищенного API с текстового устройства MSAL Java Код устройства
Python • Обращение к Microsoft Graph MSAL Python Код устройства

Функции Azure в качестве интерфейсов веб-API

В следующих примерах показано, как защитить функцию Azure с использованием HttpTrigger и как обеспечить доступ к веб-API с использованием платформы удостоверений Майкрософт, а также как вызывать из веб-API внешние API.

Язык/
Платформа		 Примеры кода
на GitHub		 Авторизация
библиотеки		 Поток аутентификации Быстрое начало Учебник
Python • Веб-API функций Python, защищенное Microsoft Entra ID MSAL Python Код авторизации

Приложения Microsoft Teams

В следующем примере показано приложение Tab Microsoft Teams, которое осуществляет вход пользователей в систему. Кроме того, в нем показано, как вызвать API Microsoft Graph с удостоверением пользователя с помощью Библиотеки проверки подлинности Майкрософт (MSAL).

Язык/
Платформа		 Примеры кода
на GitHub		 Проверка подлинности
библиотеки		 Поток аутентификации Быстрое начало Учебник
Node.js • Приложение вкладки Teams: единый вход и обращение к Microsoft Graph Узел MSAL Поток On-Behalf-Of (OBO)

Мультитенантный сервис SaaS

В следующих примерах показано, как настроить приложение для приема входов из любого клиента Microsoft Entra. Настройка вашего приложения как мультитенантного типа означает, что вы можете предложить организациям приложение Software as a Service (SaaS), позволяя их пользователям входить в ваше приложение после предоставления согласия.

Язык/
Платформа		 Примеры кода
на GitHub		 Аутентификация
библиотеки		 Поток аутентификации Быстрое начало Учебник
ASP.NET Core • веб-приложение ASP.NET Core MVC вызывает API Microsoft Graph
• веб-приложение ASP.NET Core MVC вызывает веб-API ASP.NET Core		 MSAL.NET • Подключение OpenID
• Код авторизации

Связанный контент

Если вы хотите более подробно изучить примеры кодов, см. следующие ресурсы.