Web API を呼び出すモバイルアプリを構成する

2025-07-07

適用対象: 白いチェックマーク記号が付いた緑の円。従業員テナント灰色の X 記号が付いた白い円。外部テナント (詳細はこちら)

アプリケーションを作成した後、アプリ登録パラメーターを使用してコードを構成する方法を確認します。モバイルアプリケーションには、作成フレームワークへの適合に関連する複雑な部分が存在します。

モバイルアプリをサポートする Microsoft ライブラリ

次の Microsoft ライブラリはモバイルアプリをサポートしています。

プラットフォーム	プロジェクト GitHub	Package	取得 started	一般提供 (GA) またはパブリックプレビュー¹
Android (Java)	MSAL アンドロイド	MSAL	クイックスタート	ジョージア州 (GA)
Android (Kotlin)	MSAL アンドロイド	MSAL	—	ジョージア州 (GA)
iOS (Swift/Obj-C)	iOS および macOS 用の MSAL	MSAL	チュートリアル	ジョージア州 (GA)

¹オンラインサービスのユニバーサルライセンス条項は、パブリックプレビューのライブラリに適用されます。

アプリケーションをインスタンス化する

アンドロイド

モバイルアプリケーションでは PublicClientApplication クラスが使用されます。これをインスタンス化する方法を次に示します。

PublicClientApplication sampleApp = new PublicClientApplication(
                    this.getApplicationContext(),
                    R.raw.auth_config);

iOS

iOS 上のモバイルアプリケーションは、MSALPublicClientApplication クラスをインスタンス化する必要があります。このクラスをインスタンス化するには、次のコードを使用します。

NSError *msalError = nil;

MSALPublicClientApplicationConfig *config = [[MSALPublicClientApplicationConfig alloc] initWithClientId:@"<your-client-id-here>"];
MSALPublicClientApplication *application = [[MSALPublicClientApplication alloc] initWithConfiguration:config error:&msalError];

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

追加の MSALPublicClientApplicationConfig プロパティで、既定の機関のオーバーライド、リダイレクト URI の指定、または MSAL トークンのキャッシュ動作の変更を行うことができます。

ユニバーサル Windows プラットフォーム (UWP)

このセクションでは、UWP アプリのアプリケーションをインスタンス化する方法について説明します。

アプリケーションをインスタンス化する

UWP では、アプリケーションをインスタンス化する最も簡単な方法は、次のコードを使用することです。このコードの ClientId は、登録済みアプリの GUID です。

var app = PublicClientApplicationBuilder.Create(clientId)
                                        .Build();

追加の With<Parameter> メソッドを使用して、親 UI の設定、既定の機関のオーバーライド、クライアント名とバージョンの指定 (テレメトリ用)、リダイレクト URI の指定、および使用する HTTP ファクトリの指定を実行します。たとえば、HTTP ファクトリを使用して、プロキシの処理とテレメトリとログの指定を行います。

次のセクションで、アプリケーションのインスタンス化について詳しく説明します。

親 UI、ウィンドウ、またはアクティビティを指定する

Android では、対話型認証を行う前に親アクティビティを渡します。 iOS でブローカーを使用する場合は、ViewController を渡します。 UWP の場合と同じように、親ウィンドウを渡すことができます。トークンを取得するときに、それを渡します。ただし、アプリを作成するときに、コールバックを UIParent を返すデリゲートとして指定することもできます。

IPublicClientApplication application = PublicClientApplicationBuilder.Create(clientId)
  .ParentActivityOrWindowFunc(() => parentUi)
  .Build();

Android では、CurrentActivityPlugin の使用をお勧めします。結果の PublicClientApplication ビルダーコードは、次の例のようになります。

// Requires MSAL.NET 4.2 or above
var pca = PublicClientApplicationBuilder
  .Create("<your-client-id-here>")
  .WithParentActivityOrWindow(() => CrossCurrentActivity.Current)
  .Build();

他のアプリビルドパラメーターを見つける

PublicClientApplicationBuilder で使用できるすべてのメソッドの一覧については、メソッドの一覧を参照してください。

PublicClientApplicationOptions で公開されるすべてのオプションの説明については、リファレンスドキュメントを参照してください。

iOS と macOS 用の MSAL のタスク

iOS と macOS 用の MSAL を使用する場合は、次のタスクが必要です。

UWP のタスク

UWP では企業ネットワークを使用できます。次のセクションで、企業のシナリオで完了する必要があるタスクについて説明します。

詳細については、MSAL.NET での UWP 固有の考慮事項に関する記事を参照してください。

ブローカーを使用するようにアプリケーションを構成する

Android と iOS では、ブローカーによって次のことが可能になります。

シングルサインオン (SSO): Microsoft Entra ID に登録されているデバイスに SSO を使用できます。 SSO を使用すると、ユーザーはアプリケーションごとにサインインする必要がなくなります。
デバイスの識別: この設定により、Microsoft Entra デバイスに関連する条件付きアクセスポリシーが有効になります。認証プロセスでは、デバイスがワークプレースに参加したときに作成されたデバイス証明書が使用されます。
アプリケーション ID の検証: アプリケーションでは、ブローカーを呼び出すときにそのリダイレクト URL を渡します。ブローカーによってそれが検証されます。

Android 向け MSAL に対するブローカーの有効化

Android でブローカーを有効にする方法の詳細については、「Android のブローカー認証」を参照してください。

iOS および macOS 用の MSAL に対するブローカーの有効化

iOS および macOS 用の MSAL を使用する Microsoft Entra シナリオでは、ブローカー認証が既定で有効化されています。

以降のセクションでは、iOS および macOS のブローカー認証サポート用にアプリケーションを構成する手順について説明します。この 2 つの手順セットでは、一部の手順が異なります。

iOS および macOS 用の MSAL のブローカー認証

Microsoft Entra シナリオでは、ブローカー認証が既定で有効化されています。

手順 1:コールバックを処理するように AppDelegate を更新する

iOS および macOS 用の MSAL でブローカーが呼び出されると、ブローカーは openURL メソッドを使用してアプリケーションにコールバックします。 MSAL がブローカーからの応答を待っているため、アプリケーションが協力して MSAL をコールバックする必要があります。次のコード例に示すように、メソッドをオーバーライドするように AppDelegate.m ファイルを更新することで、この機能を設定します。

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
    return [MSALPublicClientApplication handleMSALResponse:url
                                         sourceApplication:options[UIApplicationOpenURLOptionsSourceApplicationKey]];
}

    func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {

        guard let sourceApplication = options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String else {
            return false
        }

        return MSALPublicClientApplication.handleMSALResponse(url, sourceApplication: sourceApplication)
    }

iOS 13 以降で UISceneDelegate を採用した場合は、代わりに UISceneDelegate の scene:openURLContexts: に MSAL のコールバックを配置します。 MSAL handleMSALResponse:sourceApplication: の呼び出しは URL ごとに 1 回のみにする必要があります。

詳しくは、Apple のドキュメントをご覧ください。

手順 2:URL スキームを登録する

iOS および macOS 用の MSAL では、URL を使用してブローカーが呼び出され、ブローカーの応答がアプリに返されます。ラウンドトリップを終了するには、Info.plist ファイルにアプリの URL スキームを登録します。

アプリのスキームを登録するには:

カスタム URL スキームの前に msauth を付けます。
バンドル ID をスキーマの末尾に追加します。次のパターンに従います。

$"msauth.(BundleId)"

ここでは、BundleId によってデバイスが一意に識別されます。たとえば、BundleId が yourcompany.xforms の場合、URL スキームは msauth.com.yourcompany.xforms になります。

この URL スキームは、ブローカーから応答を受け取るときにアプリを一意に識別するリダイレクト URI の一部になります。 msauth.(BundleId)://auth 形式のリダイレクト URI がアプリケーションに対して登録されていることを確認してください。
```
<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>msauth.[BUNDLE_ID]</string>
        </array>
    </dict>
</array>
```

手順 3:LSApplicationQueriesSchemes を追加する

Microsoft Authenticator アプリがインストールされている場合にその呼び出しを許可するために、LSApplicationQueriesSchemes を追加します。

注

アプリが Xcode 11 以降を使用してコンパイルされている場合は、msauthv3 スキームが必要です。

LSApplicationQueriesSchemes を追加する方法の例を次に示します。

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>msauthv2</string>
  <string>msauthv3</string>
</array>

次のステップ

このシナリオの次のトークンを取得するに関する記事に進みます。

次の方法で共有

Web API を呼び出すモバイル アプリを構成する

モバイル アプリをサポートする Microsoft ライブラリ

アプリケーションをインスタンス化する

アンドロイド

iOS

ユニバーサル Windows プラットフォーム (UWP)

アプリケーションをインスタンス化する

親 UI、ウィンドウ、またはアクティビティを指定する

他のアプリ ビルド パラメーターを見つける

iOS と macOS 用の MSAL のタスク

UWP のタスク

ブローカーを使用するようにアプリケーションを構成する

Android 向け MSAL に対するブローカーの有効化

iOS および macOS 用の MSAL に対するブローカーの有効化

iOS および macOS 用の MSAL のブローカー認証

手順 1:コールバックを処理するように AppDelegate を更新する

手順 2:URL スキームを登録する

手順 3:LSApplicationQueriesSchemes を追加する

次のステップ

フィードバック

その他のリソース

Web API を呼び出すモバイルアプリを構成する

モバイルアプリをサポートする Microsoft ライブラリ

他のアプリビルドパラメーターを見つける