国内クラウド環境で MSAL を使用する

MSAL.NET を使用して、ユーザーのサインイン、トークンの取得、国内クラウドでの Microsoft Graph API の呼び出しを行うことができます。

次のチュートリアルでは、ASP.NET Core Web アプリを構築する方法を示します。 このアプリでは、OpenID Connect を使用して、国内クラウドに属する組織の職場および学校アカウントでユーザーをサインインさせます。

• ユーザーをサインインさせ、トークンを取得するには、次のチュートリアルに従います。 Microsoft ID プラットフォームを使用してソブリン クラウド内の ASP.NET Core Web アプリのサインイン ユーザーを構築します。
• Microsoft Graph API を呼び出すには、次のチュートリアルに従います。 Microsoft Id プラットフォームを使用して、Microsoft National Cloud の職場および学校アカウントを使用してユーザーのサインインに代わって、ASP.NET Core Web アプリから Microsoft Graph API を呼び出します。

ソブリンクラウドに対して MSAL.js アプリケーションを有効化するには:

• クラウドに応じて、特定のポータルにアプリケーションを登録します。 ポータルを選択する方法の詳細については、「アプリ登録エンドポイント」を参照してください
• 次に説明するクラウドに応じて、構成にいくつかの変更を加えて、リポジトリの サンプル のいずれかを使用します。
• アプリケーションを登録したクラウドに応じて、特定の機関を使用します。 さまざまなクラウドの機関の詳細については、 Microsoft Entra 認証エンドポイントを参照してください。
• Microsoft Graph API を呼び出すには、使用しているクラウドに固有のエンドポイント 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"
  

• Microsoft Graph API を呼び出すには、使用しているクラウドに固有のエンドポイント URL が必要です。 すべての国内クラウドの Microsoft Graph エンドポイントを検索するには、 Microsoft Graph と Graph Explorer サービスのルート エンドポイントを参照してください。

  スコープを持つ Microsoft Graph エンドポイントの例を次に示します。

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

ソブリン クラウドに対して MSAL for Java アプリケーションを有効にするには:

• クラウドに応じて、特定のポータルにアプリケーションを登録します。 ポータルを選択する方法の詳細については、「アプリ登録エンドポイント」を参照してください
• 次に説明するクラウドに応じて、構成にいくつかの変更を加えて、リポジトリの サンプル のいずれかを使用します。
• アプリケーションを登録したクラウドに応じて、特定の機関を使用します。 さまざまなクラウドの機関の詳細については、 Microsoft Entra 認証エンドポイントを参照してください。

権限の例を次に示します。

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

• Microsoft Graph API を呼び出すには、使用しているクラウドに固有のエンドポイント URL が必要です。 すべての国内クラウドの Microsoft Graph エンドポイントを検索するには、 Microsoft Graph と Graph Explorer サービスのルート エンドポイントを参照してください。

スコープを持つグラフ エンドポイントの例を次に示します。

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

iOS および macOS 用の MSAL を使用して各国のクラウドでトークンを取得できますが、 MSALPublicClientApplicationの作成時に追加の構成が必要です。

たとえば、アプリケーションを国内クラウド (米国政府) のマルチテナント アプリケーションにする場合は、次のように記述できます。

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];

iOS および macOS 用の MSAL を使用して各国のクラウドでトークンを取得できますが、 MSALPublicClientApplicationの作成時に追加の構成が必要です。

たとえば、アプリケーションを国内クラウド (米国政府) のマルチテナント アプリケーションにする場合は、次のように記述できます。

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 */}