チュートリアル: .NET MAUI シェル アプリを作成する
このチュートリアルは、.NET マルチプラットフォーム アプリ UI (.NET MAUI) シェル アプリを作成し、Microsoft Entra 管理センターを使用して認証用に準備する方法を示すシリーズのパート 2 です。 このシリーズのパート 1
このチュートリアルでは、次の手順を行います。
- .NET MAUI シェル アプリを作成します。
- MSAL ヘルパー クラスを使用して MSAL SDK のサポートを追加します。
- 必要なパッケージをインストールします。
- イメージ リソースを追加します。
前提 条件
- チュートリアル: 外部テナント に .NET MAUI モバイル アプリを登録して構成する
- .NET SDK
- MAUI ワークロードがインストールされている Visual Studio 2022:
.NET MAUI シェル アプリを作成する
- Visual Studio 2022 のスタート ウィンドウで、[新しいプロジェクト
作成] を選択します。 - [新しいプロジェクト の作成] ウィンドウで、[すべてのプロジェクトの種類] ドロップダウンリストから [MAUI] を選択し、[.NET MAUI App テンプレート] を選択して、[次へ] を選択します。
- [新しいプロジェクトの構成] ウィンドウで、[プロジェクト名] を SignInMaui に設定する必要があります。 [ソリューション名] を sign-in-maui に更新し、[次へ] を選択します。
- [
追加情報 ] ウィンドウで、最新の[.NET SDK ]を選択し、[を作成]を[選択]します。
プロジェクトが作成され、その依存関係が復元されるまで待ちます。
MSAL ヘルパー クラスを使用して MSAL SDK のサポートを追加する
MSAL クライアントを使用すると、開発者は外部テナントからセキュリティ トークンを取得して、セキュリティで保護された Web API を認証してアクセスできます。 このセクションでは、MSALClient を構成するファイルをダウンロードします。
次のファイルをコンピューターのフォルダーにダウンロードします。
- AzureAdConfig.cs - このファイルは、アプリ構成ファイルから Microsoft Entra アプリの一意識別子を取得して設定します。
- DownStreamApiConfig.cs - このファイルは、Microsoft Graph 呼び出しのスコープを取得および設定します。
- DownstreamApiHelper.cs - このファイルは、ダウンストリーム API を呼び出すときに発生する例外を処理します。
- Exception.cs - このファイルには、例外のスローと処理に関連するいくつかの拡張メソッドが用意されています。
- IdentityLogger.cs - このファイル ハンドルは、MSAL.NET ログの使用方法を示します。
- MSALClientHelper.cs - このファイルには、MSAL SDK を初期化するメソッドが含まれています。
- PlatformConfig.cs - このファイルには、特定のプラットフォームを処理するメソッドが含まれています。 たとえば、Windows です。
- PublicClientSingleton.cs - このファイルには、MSALClient と関連するクラスをラップしてプラットフォームの静的初期化モデルをサポートするシングルトン実装が含まれています。
- WindowsHelper.cs - このファイルには、ウィンドウ ハンドルを取得するメソッドが含まれています。
重要
MSALClient ファイルのダウンロードはスキップしないでください。このチュートリアルを完了する必要があります。
Visual Studio を使用して MSALClient ファイルを移動する
ソリューション エクスプローラー ウィンドウで、SignInMaui プロジェクトを右クリックし、[新しいフォルダー追加] 選択します。 MSALClient フォルダーに名前を付けます。 - MSALClient フォルダー
を右クリックし、[追加 既存の項目 ...] を選択 。 - 前にダウンロードしたダウンロードした MSALClient ファイルを含むフォルダーに移動します。
- ダウンロードしたすべての MSALClient ファイルを選択し、[追加] を選択します
必要なパッケージをインストールする
次のパッケージをインストールする必要があります。
- Microsoft.Identity.Client - このパッケージには、Microsoft Authentication Library for .NET (MSAL.NET) のバイナリが含まれています。
- Microsoft.Extensions.Configuration.Json - このパッケージには、Microsoft.Extensions.Configuration の JSON 構成プロバイダーの実装が含まれています。
- Microsoft.Extensions.Configuration.Binder - このパッケージには、Microsoft.Extensions.Configuration の構成プロバイダー内のデータにオブジェクトをバインドする機能が含まれています。
- Microsoft.Extensions.Configuration.Abstractions - このパッケージには、キーと値のペアベースの構成の抽象化が含まれています。
- Microsoft.Identity.Client.Extensions.Msal - このパッケージには、Microsoft Authentication Library for .NET (MSAL.NET) の拡張機能が含まれています。
NuGet パッケージ マネージャー
NuGet パッケージ マネージャー を使用して、Visual Studio に Microsoft.Identity.Client パッケージをインストールするには、次の手順に従います。
- [ツール]>[NuGet パッケージ マネージャー]>[ソリューションの NuGet パッケージの管理] を選択します。
- [参照] タブで、Microsoft.Identity.Client を検索します。
- 一覧から [Microsoft.Identity.Client] を選択します。
- [プロジェクト] リスト ペインで [SignInMaui] を選択します。
- [インストール] を選択します。
- インストールの確認を求めるメッセージが表示されたら、[OK]
選択します。
プロセスを繰り返して、残りの必要なパッケージをインストールします。
イメージ リソースを追加する
このセクションでは、アプリで使用するイメージをダウンロードして、ユーザーが操作する方法を強化します。
次の画像をダウンロードします。
- アイコン: Microsoft Entra ID - この画像はメイン ページのアイコンとして使用されます。
Visual Studio を使用してイメージを移動する
- Visual Studio の ソリューション エクスプローラー ウィンドウで、Resources フォルダーを展開すると、Images フォルダーが表示されます。
- [画像] を右クリックし、[追加]>[既存の項目] の順に選択します。
- ダウンロードしたイメージを含むフォルダーに移動します。
- ファイルの種類フィルターを [画像ファイル] に変更します。
- ダウンロードしたイメージを選択します。
- [を選択しを追加します]
次の手順
パート 3: チュートリアル: 外部テナント を使用して .NET MAUI シェル アプリでユーザーをサインインする