教學課程：建立和設定 ASP.NET Core 專案以進行驗證

在本教學課程中，您將了解如何使用 IDE 建立 ASP.NET Core 專案，並設定它進行驗證和授權。 本教學課程是系列的第二個部分，會示範如何使用 Microsoft 身分識別平台保護 Web API。 在上一篇文章中，您已在 Microsoft Entra ID 租用戶中註冊應用程式。 在本文章中，您將：

• 在 IDE 中建立 ASP.NET Core 空白專案
• 設定應用程式設定
• 識別和安裝必要的 NuGet 套件

必要條件

• 完成 教學課程：使用 Microsoft 身分識別平台註冊 Web API 中的必要條件和步驟。
• 您可以從 [下載] 頁面下載本教學課程中使用的 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

1. 開啟 Visual Studio，然後選取 [建立新專案]。
2. 搜尋並選擇 [ASP.NET Core 空白] 範本，然後選取 [下一步]。
3. 輸入專案名稱，例如 NewWebAPILocal。
4. 選擇專案的位置或接受預設選項，然後選取 [下一步]。
5. 接受 Framework 的預設值，並設定 HTTPS。
6. 選取 建立。

Visual Studio Code

1. 開啟 Visual Studio Code，選取 [檔案]>[開啟資料夾...]。瀏覽至並選取您要在其中建立專案的位置。

2. 選取頂端列中的 [終端機]，然後 [新終端機] 來開啟新的終端機。

3. 在 [總管] 窗格中，使用 [新資料夾...] 圖示建立新資料夾。 提供類似先前註冊的名稱，例如，NewWebAPILocal。

4. 選取 [終端機]>[新增終端機] 來開啟新的終端機。

5. 若要建立 ASP.NET Core 空白範本，請在終端機中執行下列命令，以變更至目錄並建立專案：

   cd NewWebAPILocal
   dotnet new web
   

Visual Studio for Mac

1. 開啟 Visual Studio，然後選取 [新]。
2. 在左側導覽列中的 [Web 和控制台] 下，選取 [應用程式]。
3. 在 [ASP.NET Core] 下，選取 [API]，並確定下拉功能表中已選取 [C#]，然後 選取 [繼續]。
4. 接受 Target Framework 的預設值並 進階，然後選取 [繼續]。
5. 輸入 [專案名稱] 的名稱，這會反映在 [方案名稱] 中。 提供與 Microsoft Entra 管理中心註冊的名稱相似的名稱，例如 NewAPI1。
6. 接受專案的預設位置，或選擇不同的位置，然後選取 [建立]。

注意

根據 Microsoft 的新式生命週期原則，Visual Studio for Mac 計畫於 2024 年 8 月 31 日前淘汰。 Visual Studio for Mac 17.6 會在 2024 年 8 月 31 日前繼續受到支援，可取得安全性問題的服務更新以及 Apple 的更新平台。 如需詳細資訊，請參閱 Visual Studio for Mac 發生的情況。

設定 ASP.NET Core 專案

稍早記錄的值將會用於 appsettings.json ，以設定應用程式進行驗證。 appsettings.json 是設定檔，用來儲存執行階段期間使用的應用程式設定。

1. 開啟 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 - 註冊應用程式的租用戶識別碼。 將引號中的文字取代為先前從已註冊應用程式 [概觀] 頁面記錄的 [目錄 (租用戶) 識別碼]。
   • ClientId - 應用程式的識別碼，也稱為用戶端。 將引號中的文字取代為先前從已註冊應用程式 [概觀] 頁面記錄的 [應用程式 (用戶端) 識別碼]。
   • Scopes - 用來要求應用程式存取的範圍。 在本教學課程中，範圍是 Forecast.Read。

2. 儲存對檔案所做的變更。

安裝身分識別套件

身分識別相關的 NuGet 套件 必須安裝在專案中，才能啟用使用者的驗證。

Visual Studio

1. 在頂端功能表中，選取 [工具]>[NuGet 套件管理員]>[管理解決方案的 NuGet 套件]。
2. 選取 [瀏覽] 索引標籤，搜尋 Microsoft.Identity.Web、選取 Microsoft.Identity.Web 套件、選取 [專案] 核取方塊，然後選取 [安裝]。
3. 針對可能顯示的其他視窗，選取 [確定] 或 [我接受]。

Visual Studio Code

1. 在上一區段開啟的終端機中，輸入下列命令：

   dotnet add package Microsoft.Identity.Web
   

Visual Studio for Mac

1. 在頂端功能表中，選取 [工具]>[管理 NuGet 套件]。
2. 搜尋 Microsoft.Identity.Web、選取 Microsoft.Identity.Web 套件、選取 [專案]，然後選取 [新增套件]。
3. 在快顯中，確定已選取正確的專案，然後選取 [確定]。
4. 如果出現其他 [授權接受] 視窗，請選取 [接受]。

下一步

教學課程：將受保護的端點實作至 API