クイックスタート: iOS または macOS アプリに "Microsoft アカウントでサインイン" を追加する - Microsoft identity platform

[アーティクル]
10/25/2023

ようこそ。ご要望のページを表示できません。問題の修正に取り組んでいますが、次のリンクから目的の記事にアクセスできるかお試しください。

クイックスタート: iOS または macOS アプリからユーザーのサインインを行い、Microsoft Graph を呼び出す

ご不便をおかけして申し訳ありませんが、問題が解決するまで今しばらくお待ちください。

このクイックスタートでは、ネイティブの iOS または macOS アプリケーションでユーザーをサインインし、アクセストークンを取得して Microsoft Graph API を呼び出す方法を示すコードサンプルをダウンロードして実行します。

このクイックスタートは、iOS アプリと macOS アプリの両方に適用されます。一部の手順は iOS アプリにのみ必要であり、そのように示されます。

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
XCode 10 以降
iOS 10 以降
macOS 10.12 以降

このサンプルのしくみ

このクイックスタートで生成されたサンプルアプリの動作の紹介

手順 1:アプリケーションの作成

このクイックスタートのコードサンプルを動作させるには、Auth ブローカーと互換性のあるリダイレクト URI を追加します。

この変更を行う

構成済みアプリケーションはこれらの属性で構成されています

手順 2:サンプルプロジェクトのダウンロード

iOS 用のコードサンプルをダウンロードする

macOS 用のコードサンプルをダウンロードする

手順 3:依存関係のインストール

zip ファイルを解凍します。
ターミナルウィンドウで、ダウンロードしたコードサンプルが含まれるフォルダーに移動し、pod install を実行して、最新の MSAL ライブラリをインストールします。

手順 4:アプリが構成され、実行準備ができる

アプリのプロパティの値を使用してプロジェクトを構成したら、実行する準備は完了です。

Note

Enter_the_Supported_Account_Info_Here

Microsoft Entra ID 国内クラウド向けのアプリを構築している場合は、"let kGraphEndpoint" および "let kAuthority" で始まる行を適切なエンドポイントに置き換えます。グローバルアクセスの場合は、既定値を使用してください。
```
let kGraphEndpoint = "https://graph.microsoft.com/"
let kAuthority = "https://login.microsoftonline.com/common"
```
その他のエンドポイントは、こちらに記載されています。たとえば、このクイックスタートを Microsoft Entra Germany で実行するには、以下を使用します。
```
let kGraphEndpoint = "https://graph.microsoft.de/"
let kAuthority = "https://login.microsoftonline.de/common"
```
プロジェクトの設定を開きます。 [ID] セクションに、ポータルに入力したバンドル ID を入力します。
Info.plist を右クリックし、 [形式を指定して開く]>[ソースコード] を選択します。

dict ルートノードの下の Enter_the_bundle_Id_Here を、ポータルで使用した Bundle Id に置き換えます。文字列の msauth. プレフィックスに注目します。

<key>CFBundleURLTypes</key>
<array>
   <dict>
      <key>CFBundleURLSchemes</key>
      <array>
         <string>msauth.Enter_the_Bundle_Id_Here</string>
      </array>
   </dict>
</array>

アプリをビルドして実行します。

詳細情報

このクイックスタートの詳細については、以下のセクションをお読みください。

MSAL の取得

MSAL (MSAL.framework) はユーザーをサインインし、Microsoft ID プラットフォームによって保護されている API にアクセスするトークンを要求するために使用するライブラリです。 MSAL は、次のプロセスを使用してアプリケーションに追加できます。

$ vi Podfile

次の内容を (プロジェクトのターゲットと共に) この podfile に追加します。

use_frameworks!

target 'MSALiOS' do
   pod 'MSAL'
end

CocoaPods インストールコマンドを実行します。

pod install

MSAL の初期化

MSAL への参照を追加するには、次のコードを追加します。

import MSAL

続いて、次のコードを使用して MSAL を初期化します。

let authority = try MSALAADAuthority(url: URL(string: kAuthority)!)

let msalConfiguration = MSALPublicClientApplicationConfig(clientId: kClientID, redirectUri: nil, authority: authority)
self.applicationContext = try MSALPublicClientApplication(configuration: msalConfiguration)

各値の説明: 説明

clientId portal.azure.com に登録されているアプリケーションの Application ID

authority Microsoft ID プラットフォーム。ほとんどの場合、これは https://login.microsoftonline.com/common> になります

redirectUri アプリケーションのリダイレクト URI。 'nil' を渡すと、既定値またはカスタムのリダイレクト URI を使用できます。

各値の説明:	説明
`clientId`	portal.azure.com に登録されているアプリケーションの Application ID
`authority`	Microsoft ID プラットフォーム。ほとんどの場合、これは `https://login.microsoftonline.com/common`> になります
`redirectUri`	アプリケーションのリダイレクト URI。 'nil' を渡すと、既定値またはカスタムのリダイレクト URI を使用できます。

iOS のみ: アプリの追加要件

アプリでは、AppDelegate 内に次の内容も必要です。これにより、認証を実行するときに MSAL SDK による Auth ブローカーアプリからのトークン応答の処理が可能になります。

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

    return MSALPublicClientApplication.handleMSALResponse(url, sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String)
}

注意

iOS 13 以降では、UIApplicationDelegate ではなく UISceneDelegate を採用する場合は、代わりに scene:openURLContexts: のコールバックにこのコードを配置します (Apple のドキュメントを参照してください)。以前の iOS との互換性を保持するために UISceneDelegate と UIApplicationDelegate の両方をサポートしている場合は、MSAL コールバックを両方の場所に配置する必要があります。

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {

   guard let urlContext = URLContexts.first else {
      return
   }

   let url = urlContext.url
   let sourceApp = urlContext.options.sourceApplication

   MSALPublicClientApplication.handleMSALResponse(url, sourceApplication: sourceApp)
}

最後に、アプリでは、LSApplicationQueriesSchemes エントリが Info.plist に CFBundleURLTypes と並んで存在している必要があります。サンプルにはこれが含まれています。

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

MSAL には、トークンの取得に使用する 2 つのメソッド acquireToken、acquireTokenSilent があります。

acquireToken: 対話形式でのユーザートークンの取得

状況によっては、ユーザーが Microsoft ID プラットフォームと対話する必要があります。このような場合、エンドユーザーは自分のアカウントを選択する、自分の資格情報を入力する、またはアプリのアクセス許可に同意することを要求される可能性があります。たとえば、次のように入力します。

ユーザーが初めてアプリケーションにサインインした場合
ユーザーが自分のパスワードをリセットした場合、ユーザーは自分の資格情報を入力する必要がある
アプリケーションがリソースへのアクセスを初めて要求している場合
MFA またはその他の条件付きアクセスポリシーが必要な場合

let parameters = MSALInteractiveTokenParameters(scopes: kScopes, webviewParameters: self.webViewParamaters!)
self.applicationContext!.acquireToken(with: parameters) { (result, error) in /* Add your handling logic */}

各値の説明: 説明

scopes 要求するスコープを含む (つまり、Microsoft Graph 用の [ "user.read" ] またはカスタム Web API 用の [ "<Application ID URL>/scope" ] (api://<Application ID>/access_as_user))

各値の説明:	説明
`scopes`	要求するスコープを含む (つまり、Microsoft Graph 用の `[ "user.read" ]` またはカスタム Web API 用の `[ "<Application ID URL>/scope" ]` (`api://<Application ID>/access_as_user`))

acquireTokenSilent: アクセストークンを自動的に取得する

アプリは、トークンを要求するたびに、ユーザーにサインインを要求するべきではありません。ユーザーが既にサインインしている場合は、この方法により、アプリはトークンを暗黙的に要求できます。

self.applicationContext!.getCurrentAccount(with: nil) { (currentAccount, previousAccount, error) in

   guard let account = currentAccount else {
      return
   }

   let silentParams = MSALSilentTokenParameters(scopes: self.kScopes, account: account)
   self.applicationContext!.acquireTokenSilent(with: silentParams) { (result, error) in /* Add your handling logic */}
}

各値の説明: 説明

scopes 要求するスコープを含む (つまり、Microsoft Graph 用の [ "user.read" ] またはカスタム Web API 用の [ "<Application ID URL>/scope" ]) (api://<Application ID>/access_as_user)

account トークンが要求されているアカウント。このクイックスタートでは、単一アカウントのアプリケーションを取り扱います。複数アカウントのアプリを構築する場合は、accountsFromDeviceForParameters:completionBlock: を使用し、正しい accountIdentifier を渡して、どのアカウントをトークン要求に使用するかを識別するためのロジックを定義する必要があります

各値の説明:	説明
`scopes`	要求するスコープを含む (つまり、Microsoft Graph 用の `[ "user.read" ]` またはカスタム Web API 用の `[ "<Application ID URL>/scope" ]`) (`api://<Application ID>/access_as_user`)
`account`	トークンが要求されているアカウント。このクイックスタートでは、単一アカウントのアプリケーションを取り扱います。複数アカウントのアプリを構築する場合は、`accountsFromDeviceForParameters:completionBlock:` を使用し、正しい `accountIdentifier` を渡して、どのアカウントをトークン要求に使用するかを識別するためのロジックを定義する必要があります

ヘルプとサポート

サポートが必要な場合、問題をレポートする場合、またはサポートオプションについて知りたい場合は、開発者向けのヘルプとサポートに関するページを参照してください。

次のステップ

Microsoft ID プラットフォームからアクセストークンを取得し、これを使用して Microsoft Graph API を呼び出す iOS または macOS アプリを作成するステップバイステップのチュートリアルに進みます。

チュートリアル: iOS または macOS アプリからユーザーのサインインを行い、Microsoft Graph を呼び出す

クイック スタート:iOS または macOS アプリからユーザーのサインインを行い、Microsoft Graph API を呼び出す