チュートリアル: ネイティブ認証用に iOS アプリを準備する

[アーティクル]
04/08/2024

このチュートリアルでは、Microsoft Authentication Library (MSAL) ネイティブ認証 SDK フレームワークを iOS Swift アプリに追加する方法について説明します。

このチュートリアルでは、次の作業を行う方法について説明します。

MSAL フレームワークを iOS アプリに追加します。
SDK インスタンスを作成します。

前提条件

Xcode
まだ行っていない場合は、「ネイティブ認証を使用してサンプル iOS (Swift) モバイルアプリでユーザーをサインインする」の手順に従い、外部テナントにアプリを登録します。次の手順を完了してください。
- アプリケーションを登録します。
- パブリッククライアントとネイティブ認証フローを有効にします。
- API のアクセス許可を付与する。
- ユーザーフローを作成する。
- アプリをユーザーフローに関連付ける。
iOS プロジェクト

MSAL フレームワークを iOS アプリに追加する

Xcode で iOS プロジェクトを開きます。
[パッケージの依存関係を追加...] を [ファイル] メニューから選択します。
https://github.com/AzureAD/microsoft-authentication-library-for-objc をパッケージ URL として入力し、[パッケージの追加] を選択します

自分のプロジェクトに MSAL を追加するための詳細およびその他のメカニズムについては、本プロジェクトの Readme ファイルを参照してください。

SDK インスタンスを作成する

ViewController クラスの上部に import MSAL を追加して、ビューコントローラーに MSAL ライブラリをインポートします。
viewDidLoad() 関数の直前に次のコードを追加して、 ViewController クラスに nativeAuth メンバー変数を追加します。
```
var nativeAuth: MSALNativeAuthPublicClientApplication!
```

次のコードを viewDidLoad() 関数に追加します。

 do {
    nativeAuth = try MSALNativeAuthPublicClientApplication(
        clientId: "Enter_the_Application_Id_Here",
        tenantSubdomain: "Enter_the_Tenant_Subdomain_Here",
        challengeTypes: [.OOB]
    )

    print("Initialized Native Auth successfully.")
 } catch {
    print("Unable to initialize MSAL \(error)")
 }

次の値を Microsoft Entra 管理センターから取得した値に置き換えます。
1. Enter_the_Application_Id_Here の値を見つけ、前に登録したアプリのアプリケーション (クライアント) ID に置き換えます。
2. Enter_the_Tenant_Subdomain_Here の値を見つけ、ディレクトリ (テナント) サブドメインに置き換えます。たとえば、テナントのプライマリドメインが contoso.onmicrosoft.com の場合は、contoso を使用します。ディレクトリ (テナント) のサブドメイン名がない場合は、テナントの詳細を読み取る方法を確認してください。
ビルドするには、プロジェクトのツールバーで [製品]>[ビルド] を選択します。

省略可能: ログ記録の構成

MSAL には、ログ記録を有効にし構成するために使用できるログ記録 API が用意されています。 MSAL からのすべてのデバッグ出力を表示するには、viewDidLoad() 関数の先頭に次のコードを追加します。

MSALGlobalConfig.loggerConfig.logLevel = .verbose
MSALGlobalConfig.loggerConfig.setLogCallback { logLevel, message, containsPII in
   if !containsPII {
      print("MSAL: \(message ?? "")")
   }
}

これにより、MSAL からすべてのデバッグログが出力されます。これは、問題の診断やネイティブ認証フローのしくみの学習に役立ちます。ログレベルの構成とベストプラクティスの詳細については、「iOS/macOS 用の MSAL でのログ記録」を参照してください。

次のステップ

チュートリアル: 電子メールワンタイムパスコードでのサインアップを追加する

次の方法で共有