Краткое руководство: Получение токена и вызов API Microsoft Graph из настольного приложения Windows

В этом кратком руководстве вы скачаете и запустите пример кода, демонстрирующий, как приложение Windows Presentation Foundation (WPF) может войти в систему и получить маркер доступа для вызова API Microsoft Graph.

Иллюстрацию см. в разделе Как работает этот пример.

Шаг 1. Настройка приложения на портале Azure

Чтобы пример кода в этом кратком руководстве работал, добавьте URI перенаправленияhttps://login.microsoftonline.com/common/oauth2/nativeclient и ms-appx-web://microsoft.aad.brokerplugin/{client_id}.

Шаг 2. Загрузка проекта Visual Studio

Запустите проект с помощью Visual Studio 2019.

Шаг 3. Приложение настроено и готово к выполнению

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

Дополнительные сведения

Как работает этот пример

MSAL.NET

MSAL (Microsoft.Identity.Client) — это библиотека, используемая для входа в систему пользователей и запроса токенов, используемых для доступа к API, защищенному платформой удостоверений Microsoft. MSAL можно установить, выполнив в консоли диспетчера пакетов Visual Studio следующую команду.

Install-Package Microsoft.Identity.Client -IncludePrerelease

Инициализация MSAL

Вы можете добавить ссылку для MSAL, добавив следующий код:

using Microsoft.Identity.Client;

Затем выполните инициализацию MSAL с помощью следующего кода.

IPublicClientApplication publicClientApp = PublicClientApplicationBuilder.Create(ClientId)
                .WithRedirectUri("https://login.microsoftonline.com/common/oauth2/nativeclient")
                .WithAuthority(AzureCloudInstance.AzurePublic, Tenant)
                .Build();

Запрос токенов

MSAL имеет два метода получения маркеров: AcquireTokenInteractive и AcquireTokenSilent.

Интерактивное получение пользовательского токена

В некоторых ситуациях требуется принудительное взаимодействие пользователей с платформой удостоверений Майкрософт через всплывающее окно для проверки учетных данных или предоставления согласия. Ниже приведены некоторые примеры:

• При первом входе пользователей в приложение
• когда пользователям может потребоваться повторно ввести учетные данные, так как истек срок действия пароля;
• Когда приложение запрашивает доступ к ресурсу, которому пользователь должен предоставить согласие
• Если требуется двухфакторная проверка подлинности

authResult = await App.PublicClientApp.AcquireTokenInteractive(_scopes)
                                      .ExecuteAsync();

Незаметное получение токена пользователя

Вам не нужно, чтобы пользователь проверял свои учетные данные каждый раз, когда им нужен доступ к ресурсу. Большую часть времени требуется получение и продление маркеров без участия пользователя. Метод AcquireTokenSilent можно использовать для получения маркеров для доступа к защищенным ресурсам после первоначального метода AcquireTokenInteractive:

var accounts = await App.PublicClientApp.GetAccountsAsync();
var firstAccount = accounts.FirstOrDefault();
authResult = await App.PublicClientApp.AcquireTokenSilent(scopes, firstAccount)
                                      .ExecuteAsync();

Помощь и поддержка

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

Дальнейшие шаги

Попробуйте учебник для рабочего стола Windows, чтобы получить полное пошаговое руководство по созданию приложений и новых функций, включая полное объяснение этого быстрого старта.