Azure AD B2C .NET Web App 和 Web API 开源项目指南

该项目位于 GitHub，旨在演示如何使用 Azure Active Directory B2C (AAD B2C) 安全地保护一个 .NET Web 应用程序以及它所调用的 .NET Web API。

1. 目录结构及介绍

本项目的目录结构布局清晰，主要包含了两个核心组件：

• TaskWebApp：这是一个ASP.NET MVC Web应用程序，作为前端展示给用户，并与后端Web API交互处理待办事项的CRUD操作。
• TaskService：是后端的ASP.NET Web API服务，负责存储和管理每个用户的待办事项列表。

以下是关键文件和目录的概览：

• TaskWebApp:

  • Controllers：包含了处理用户请求的控制器类。
  • Views：视图文件，用于展示数据给用户。
  • Web.config：前端应用的配置文件，包括了与AAD B2C相关的设置。

• TaskService:

  • 类似地，有自己的控制器和配置文件，服务于API请求。
  • Web.config：包含API的配置信息，如AAD B2C的客户端ID等。

• 根目录下有.gitignore, README.md, LICENSE等标准GitHub项目文件。

• B2C-WebAPI-DotNet.sln是Visual Studio解决方案文件，便于同时打开和管理这两个项目。

2. 启动文件介绍

TaskWebApp 启动文件

项目的核心启动逻辑在Startup.cs（尽管没有直接提供该文件路径，但通常是asp.net应用的标准实践）。这个文件初始化中间件和服务，包括AAD B2C的身份验证配置。它确保应用启动时正确集成到AAD B2C中。

TaskService 启动文件

对于Web API部分，其启动逻辑也可能位于类似的Startup.cs或通过Global.asax或其他配置方式启动，重点在于配置路由和任何特定于API的服务。

3. 项目的配置文件介绍

• Web.config
  • 在TaskWebApp和TaskService中都存在，是.NET框架传统上用来存储应用程序配置的地方。
  • 重要键值举例：
    • ida:Tenant, ida:AadInstance: 指定了AAD B2C租户的名称和登录URL。
    • ida:ClientId, ida:ClientSecret: 分别为前端应用和API的客户端ID与机密，需替换为你自己的注册信息。
    • ida:SignUpSignInPolicyId, ida:ProfileEditPolicyId, ida:PasswordResetPolicyId: AAD B2C身份策略ID，按需自定义创建。
    • api:ApiIdentifier: 指定API的标识符，确保Web应用正确请求访问权限。

配置这些值是运行项目前的关键步骤，以确保它们指向你的AAD B2C租户以及正确的应用注册信息。

为了部署并运行此项目，开发者需要遵循官方提供的详细步骤，包括在Azure门户中的AAD B2C租户配置、政策创建、应用注册等。务必留意替换示例代码中的占位符变量以匹配你的实际配置。