ms-identity-aspnet-webapp-openidconnect 的安装和配置教程

1. 项目基础介绍和主要编程语言

ms-identity-aspnet-webapp-openidconnect 是一个开源项目，它旨在展示如何使用 Microsoft 标识平台与 ASP.NET Core Web 应用程序实现 OpenID Connect 身份验证。该项目主要使用 C# 编程语言，基于 .NET Core 或 .NET 5/6 开发。

2. 项目使用的关键技术和框架

本项目使用以下关键技术和框架：

• ASP.NET Core：一个开源的、跨平台的框架，用于构建 Web 应用程序。
• OpenID Connect：一种身份验证协议，允许客户端应用程序通过使用第三方服务进行用户认证。
• Microsoft Identity Platform：一个身份认证和授权服务，允许应用程序安全地访问 Microsoft 云服务资源和外部资源。
• OAuth 2.0：一个授权框架，允许第三方应用代表用户安全地进行 API 访问。

3. 项目安装和配置的准备工作及详细步骤

准备工作

在开始之前，请确保您已经安装以下工具和软件：

• .NET SDK：确保安装了适用于您操作系统的最新 .NET SDK。
• Git：用于从 GitHub 克隆项目。
• Visual Studio 或 Visual Studio Code：用于开发和调试。

安装步骤

1. 克隆项目

   打开命令行界面，运行以下命令克隆项目到本地：

   git clone https://github.com/Azure-Samples/ms-identity-aspnet-webapp-openidconnect.git
   cd ms-identity-aspnet-webapp-openidconnect
   

2. 安装依赖项

   在项目目录中，运行以下命令安装所需的 NuGet 包：

   dotnet restore
   

3. 配置身份验证

   在 appsettings.json 文件中，配置 Microsoft Identity Platform 的相关信息，包括租户 ID、客户端 ID 和客户端密钥。例如：

   "AzureAd": {
     "Instance": "https://login.microsoftonline.com/",
     "Domain": "your-tenant-id.onmicrosoft.com",
     "TenantId": "your-tenant-id",
     "ClientId": "your-client-id",
     "ClientSecret": "your-client-secret",
     "CallbackPath": "/signalr"
   }
   

   请确保替换 your-tenant-id、your-client-id 和 your-client-secret 为您在 Azure 门户中创建的应用程序注册信息。

4. 运行项目

   使用 Visual Studio 或 Visual Studio Code 打开项目，然后按 F5 运行项目，或者在命令行中运行以下命令：

   dotnet run
   

5. 访问应用程序

   打开浏览器，访问 https://localhost:5001，您应该会被重定向到 Microsoft 登录页面，登录后可以访问受保护的应用程序资源。

以上步骤将帮助您成功安装和配置 ms-identity-aspnet-webapp-openidconnect 项目。