Использование MSAL в национальной облачной среде

Вы можете использовать MSAL.NET для входа пользователей, получения маркеров и вызова API Microsoft Graph в национальных облаках.

В следующих руководствах показано, как создать веб-приложение ASP.NET Core. Приложение использует OpenID Connect для входа пользователей с рабочей и учебной учетной записью в организации, которая принадлежит национальному облаку.

• Чтобы авторизовать пользователей и получить токены, воспользуйтесь этим руководством: Создайте веб-приложение ASP.NET Core для входа пользователей в независимые облака с помощью платформы идентификации Microsoft.
• Чтобы вызвать API Microsoft Graph, следуйте инструкциям из этого руководства. Использование платформы удостоверений Майкрософт для вызова API Microsoft Graph из веб-приложения ASP.NET Core от имени пользователя, выполнив вход с помощью рабочей и учебной учетной записи в Microsoft National Cloud.

Чтобы настроить приложение MSAL.js для суверенных облаков:

• Зарегистрируйте приложение на определенном портале в зависимости от облака. Дополнительные сведения о выборе портала см. в конечных точках регистрации приложений
• Используйте любой из примеров из репозитория с несколькими изменениями в конфигурации в зависимости от облака, который упоминается далее.
• Используйте определенный авторизующий орган в зависимости от облака, в котором вы зарегистрировали приложение. Дополнительные сведения о центрах для различных облаков см. в конечных точках проверки подлинности Microsoft Entra.
• Для вызова API Microsoft Graph требуется URL-адрес конечной точки, относящийся к используемому облаку. Чтобы найти конечные точки Microsoft Graph для всех национальных облаков, обратитесь к корневым конечным точкам службы Microsoft Graph и Graph Explorer.

Вот пример авторитета:

"authority": "https://login.microsoftonline.us/Enter_the_Tenant_Info_Here"

Ниже приведен пример конечной точки Microsoft Graph с областью действия:

"endpoint" : "https://graph.microsoft.us/v1.0/me"
"scope": "User.Read"

Ниже приведен минимальный код для проверки подлинности пользователя с помощью суверенного облака и вызова Microsoft Graph:

const msalConfig = {
    auth: {
        clientId: "Enter_the_Application_Id_Here",
        authority: "https://login.microsoftonline.us/Enter_the_Tenant_Info_Here",
        redirectUri: "/",
    }
};

// Initialize MSAL
const msalObj = new PublicClientApplication(msalConfig);

// Get token using popup experience
try {
    const graphToken = await msalObj.acquireTokenPopup({
        scopes: ["User.Read"]
    });
} catch(error) {
    console.log(error)
}

// Call the Graph API
const headers = new Headers();
const bearer = `Bearer ${graphToken}`;

headers.append("Authorization", bearer);

fetch("https://graph.microsoft.us/v1.0/me", {
    method: "GET",
    headers: headers
})

Чтобы включить приложение MSAL Python для национальных облаков, выполните следующие действия.

• Зарегистрируйте приложение на определенном портале в зависимости от облака. Дополнительные сведения о выборе портала см. в конечных точках регистрации приложений

• Используйте любой из примеров из репозитория с несколькими изменениями в конфигурации в зависимости от облака, который упоминается далее.

• Используйте определенный авторизующий орган в зависимости от облака, в котором вы зарегистрировали приложение. Дополнительную информацию об уполномоченных органах для различных облачных сервисов см. в конечных точках аутентификации Microsoft Entra.

  Вот пример авторитета:

  "authority": "https://login.microsoftonline.us/Enter_the_Tenant_Info_Here"
  

• Для вызова API Microsoft Graph требуется URL-адрес конечной точки, относящийся к используемому облаку. Чтобы найти конечные точки Microsoft Graph для всех национальных облаков, обратитесь к корневым конечным точкам службы Microsoft Graph и Graph Explorer.

  Ниже приведен пример конечной точки Microsoft Graph с областью действия:

  "endpoint" : "https://graph.microsoft.us/v1.0/me"
  "scope": "User.Read"
  

Чтобы активировать приложение MSAL для Java для суверенных облаков:

• Зарегистрируйте приложение на определенном портале в зависимости от облака. Дополнительные сведения о выборе портала см. в конечных точках регистрации приложений
• Используйте любой из примеров из репозитория с несколькими изменениями в конфигурации в зависимости от облака, которые упоминаются далее.
• Используйте определенный авторизующий орган в зависимости от облака, в котором вы зарегистрировали приложение. Дополнительную информацию об уполномоченных органах для различных облачных сервисов см. в конечных точках аутентификации Microsoft Entra.

Вот пример авторитета:

"authority": "https://login.microsoftonline.us/Enter_the_Tenant_Info_Here"

• Для вызова API Microsoft Graph требуется URL-адрес конечной точки, относящийся к используемому облаку. Чтобы найти конечные точки Microsoft Graph для всех национальных облаков, обратитесь к корневым конечным точкам службы Microsoft Graph и Graph Explorer.

Ниже приведен пример конечной точки графа с областью действия:

"endpoint" : "https://graph.microsoft.us/v1.0/me"
"scope": "User.Read"

MSAL для iOS и macOS можно использовать для получения маркеров в национальных облаках, но при создании MSALPublicClientApplicationтребуется дополнительная конфигурация.

Например, если вы хотите, чтобы ваше приложение было мультитенантным приложением в национальном облаке (здесь US Government), вы могли бы написать:

MSALAADAuthority *aadAuthority =
                [[MSALAADAuthority alloc] initWithCloudInstance:MSALAzureUsGovernmentCloudInstance
                                                   audienceType:MSALAzureADMultipleOrgsAudience
                                                      rawTenant:nil
                                                          error:nil];

MSALPublicClientApplicationConfig *config =
                [[MSALPublicClientApplicationConfig alloc] initWithClientId:@"<your-client-id-here>"
                                                                redirectUri:@"<your-redirect-uri-here>"
                                                                  authority:aadAuthority];

NSError *applicationError = nil;
MSALPublicClientApplication *application =
                [[MSALPublicClientApplication alloc] initWithConfiguration:config error:&applicationError];

MSAL для iOS и macOS можно использовать для получения маркеров в национальных облаках, но при создании MSALPublicClientApplicationтребуется дополнительная конфигурация.

Например, если вы хотите, чтобы ваше приложение было мультитенантным приложением в национальном облаке (здесь US Government), вы могли бы написать:

let authority = try? MSALAADAuthority(cloudInstance: .usGovernmentCloudInstance, audienceType: .azureADMultipleOrgsAudience, rawTenant: nil)

let config = MSALPublicClientApplicationConfig(clientId: "<your-client-id-here>", redirectUri: "<your-redirect-uri-here>", authority: authority)
if let application = try? MSALPublicClientApplication(configuration: config) { /* Use application */}