チュートリアル: 認証のための ASP.NET Core プロジェクトを作成して構成する

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

このチュートリアルでは、IDE を使用して ASP.NET Core プロジェクトを作成し、認証と認可を構成する方法について説明します。このチュートリアルは、Microsoft ID プラットフォームを使って Web API をセキュリティで保護する方法を示すシリーズの第 2 部です。前の記事では、Microsoft Entra ID テナントにアプリケーションを登録しました。この記事では、次のことを行います。

IDE で ASP.NET Core (空) のプロジェクトを作成する
アプリケーションの設定を構成する
必須の NuGet パッケージを見つけてインストールする

前提条件

「チュートリアル: Web API を Microsoft ID プラットフォームに登録する」の前提条件と手順を完了していること。
このチュートリアルで使用する IDE は、[ダウンロード] ページからダウンロードできます。
- Visual Studio 2022
- Visual Studio Code
- Visual Studio 2022 for Mac

.NET 6.0 SDK の最小要件。

ASP.NET Core プロジェクトを作成する

IDE 内で ASP.NET Core プロジェクトを作成するには、次のタブを使用します。

Visual Studio を開き、 [新しいプロジェクトの作成] を選択します。
ASP.NET Core (空) テンプレートを探して選択し、[次へ] を選択します。
プロジェクトの名前 (NewWebAPILocal など) を入力します。
プロジェクトの場所を選択するか既定のオプションをそのまま使用して、[次へ] を選択します。
[フレームワーク] と [HTTPS 用の構成] で既定値をそのまま使用します。
[作成] を選択します。

Visual Studio Code を開き、[ファイル] > [フォルダーを開く...] の順に選択します。プロジェクトを作成する場所に移動して選択します。
上部のバーで [ターミナル] を選択してから [新しいターミナル] を選択して、新しいターミナルを開きます。
[エクスプローラー] ペインの [新しいフォルダー...] アイコンを使用して、新しいフォルダーを作成します。以前に登録した名前と同様の名前、たとえば NewWebAPILocal を指定します。
[ターミナル] > [新しいターミナル] を選択して、新しいターミナルを開きます。
ASP.NET Core (空) のテンプレートを作成するには、ターミナルで次のコマンドを実行してディレクトリに移動し、プロジェクトを作成します。
```
cd NewWebAPILocal
dotnet new web
```

ASP.NET Core プロジェクトを構成する

前に記録した値は、アプリケーションを認証用に構成するために appsettings.json で使用されます。 appsettings.json は、実行時に使用されるアプリケーション設定を格納するために使用される構成ファイルです。

appsettings.json を開き、ファイルの内容を次のコードスニペットに置き換えます。
```
{
  "AzureAd": {
    "Instance": "https://login.microsoftonline.com/",
    "ClientId": "Enter the client ID here",
    "TenantId": "Enter the tenant ID here",
    "Scopes": "Forecast.Read"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*"
} 
```
- Instance - クラウドプロバイダーのエンドポイント。各国のクラウドの利用可能なさまざまなエンドポイントで確認します。
- TenantId - アプリケーションが登録されているテナントの識別子。引用符で囲まれた文字を、登録したアプリケーションの概要ページから先ほど記録した ディレクトリ (テナント) ID の値に置き換えます。
- ClientId - クライアントとも呼ばれる、アプリケーションの識別子。引用符で囲まれた文字を、登録したアプリケーションの概要ページから先ほど記録した アプリケーション (クライアント) ID の値に置き換えます。
- Scopes - アプリケーションへのアクセスを要求するために使用されるスコープ。このチュートリアルでは、スコープは Forecast.Read です。
変更をファイルに保存します。

ID パッケージをインストールする

ユーザーの認証を有効にするためには、ID 関連の NuGet パッケージがプロジェクトにインストールされている必要があります。

トップメニューで、[ツール]>[NuGet パッケージマネージャー]>[ソリューションの NuGet パッケージの管理] の順に選択します。
[参照] タブを選択した状態で、Microsoft.Identity.Web を検索し、Microsoft.Identity.Web パッケージを選択し、[プロジェクト] チェックボックスをオンにして、[インストール] を選択します。
表示される可能性がある他のウィンドウについては、[OK] または [同意する] を選択します。

トップメニューで、[ツール]>[NuGet パッケージの管理] の順に選択します。
Microsoft.Identity.Web を検索し、Microsoft.Identity.Web パッケージを選択し、[プロジェクト] を選択して [パッケージの追加] を選択します。
ポップアップで、正しいプロジェクトが選択されていることを確認し、[OK] を選択します。
他の [ライセンスの同意] ウィンドウが表示される場合は、[承諾] を選択します。

次の手順

チュートリアル: API に保護されたエンドポイントを実装する

次の方法で共有