ASP.NET Core 身份验证工作坊教程

1. 项目介绍

AspNetAuthenticationWorkshop 是一个开源项目，旨在帮助开发者深入了解和掌握 ASP.NET Core 中身份验证的各种新特性和组件。该项目基于 ASP.NET Core 2.1 版本，并使用 MVC（模型-视图-控制器）模板作为开发起点，是学习 ASP.NET Core 身份验证机制的绝佳资源。

2. 项目快速启动

准备工作

• 安装 Visual Studio 2017 或 Visual Studio Code。
• 安装 .NET Core 2.1 SDK。

创建项目

1. 在计算机上创建一个新文件夹，命名为 authenticationlab。
2. 打开命令行，切换到创建的文件夹。
3. 执行 dotnet new console 创建一个新的控制台应用。
4. 执行 dotnet run，看到 "Hello World" 输出，确认项目创建成功。

转换为 Web 应用

1. 修改 authenticationlab.csproj 文件，添加以下内容：

<ItemGroup>
  <PackageReference Include="Microsoft.AspNetCore.All" Version="2.1" />
</ItemGroup>

2. 保存文件，并在 IDE 中恢复包，或在命令行执行 dotnet restore。
3. 修改 Program.cs 文件，替换内容为：

using System;
using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Hosting;

namespace authenticationlab
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateWebHostBuilder(args).Build().Run();
        }

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args).UseStartup<Startup>();
    }
}

4. 创建一个新的 Startup.cs 文件，并添加以下内容：

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;

namespace authenticationlab
{
    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
        }

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            app.Run(async (context) =>
            {
                await context.Response.WriteAsync("Hello World!");
            });
        }
    }
}

5. 构建并运行项目，使用浏览器访问 http://localhost:5000/，看到 "Hello World!" 表示 Web 应用创建成功。

3. 应用案例和最佳实践

配置 HTTPS

在开发环境中配置 HTTPS：

dotnet dev-certs https -c -v

若没有证书，生成并信任证书：

dotnet dev-certs https --trust

在 Startup.Configure 方法中添加 HTTPS 重定向：

app.UseHttpsRedirection();

使用 Google 登录

1. 在 Google Developers Console 配置项目并获取 Client ID 和 Client Secret。
2. 在 Startup.cs 中配置 Google 身份验证服务：

services.AddAuthentication()
    .AddGoogle(options =>
    {
        options.ClientId = "你的Client ID";
        options.ClientSecret = "你的Client Secret";
    });

3. 修改 Startup.Configure 方法以使用 Google 身份验证：

app.UseAuthentication();

4. 典型生态项目

AspNetAuthenticationWorkshop 作为一个典型的身份验证生态项目，涵盖了与身份验证相关的多种技术和最佳实践，例如：

• 使用 ASP.NET Core Identity 进行用户管理。
• 集成第三方身份验证提供者，如 Google、Twitter 等。
• 实现OAuth 2.0 和 OpenID Connect。
• 配置 HTTPS 和处理安全事务。

以上教程涵盖了项目的快速启动和基本使用，为开发者提供了深入学习 ASP.NET Core 身份验证的起点。