教程:创建和配置 ASP.NET Core 项目以进行身份验证

在本教程中,你将学习如何使用 IDE 创建 ASP.NET Core 项目并配置身份验证和授权。 本教程是一系列教程的第二部分,演示如何使用 Microsoft 标识平台保护 Web API。 在上一篇文章中,你在 Microsoft Entra ID 租户中注册了应用程序。 本文内容:

  • 在 IDE 中创建 ASP.NET Core Empty 项目
  • 配置应用程序的设置
  • 识别并安装所需 NuGet 包

先决条件

创建 ASP.NET Core 项目

使用以下选项卡在 IDE 中创建 ASP.NET Core 项目。

  1. 打开 Visual Studio,然后选择“创建新项目”。
  2. 搜索并选择“ASP.NET Core Empty”模板,然后选择“下一步”。
  3. 输入项目的名称,例如 NewWebAPILocal
  4. 选择项目位置或者接受默认选项,然后选择“下一步”。
  5. 接受“框架”的默认设置,并“配置 HTTPS”。
  6. 选择“创建” 。

配置 ASP.NET Core 项目

将在 appsettings.json 中使用之前记录的值来配置用于身份验证的应用程序。 appsettings.json 为配置文件,用于存储运行时使用的应用程序设置。

  1. 打开 appsettings.json 并用以下代码片段替换文件内容:

    {
      "AzureAd": {
        "Instance": "https://login.partner.microsoftonline.cn/",
        "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
  2. 保存对文件所做的更改。

安装标识包

必须在项目中安装与标识相关的“NuGet 包”,才能启用用户身份验证。

  1. 在顶部菜单中,选择“工具”>“NuGet 包管理器”>“管理解决方案的 NuGet 包”。
  2. 选中“浏览”选项卡后,搜索 Microsoft.Identity.Web,选择 Microsoft.Identity.Web 包,选中“项目”复选框,然后选择“安装”。
  3. 对于可能出现的其他窗口,请选择“确定”或“我接受”。

后续步骤