ASP.NET Core 3.1 JWT身份验证API教程-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00546/article/details/142294654

ASP.NET Core 3.1 JWT身份验证API教程

aspnet-core-3-jwt-authentication-api ASP.NET Core 3.1 JWT Authentication API 项目地址: https://gitcode.com/gh_mirrors/as/aspnet-core-3-jwt-authentication-api

本教程将引导您了解cornflourblue/aspnet-core-3-jwt-authentication-api这个开源项目，这是一个基于ASP.NET Core 3.1实现的JWT（JSON Web Tokens）认证示例应用。该项目提供了实现RESTful API安全认证的一种方式。

1. 项目目录结构及介绍

此项目遵循了ASP.NET Core常见的项目组织结构。下面是主要的目录及文件介绍：

Controllers - 包含API控制器，如UserController.cs，处理客户端请求。
Entities - 定义数据模型实体，例如用户信息的类文件。
Helpers - 存放辅助工具类，比如JWT token的生成与解析逻辑。
Models - 定义数据传输对象(DTO)，用于在服务层和控制器之间传递数据。
Services - 实现业务逻辑的服务类，如认证服务。
Program.cs 和 Startup.cs - 应用程序的入口点及配置设置。
appsettings.json, appsettings.Development.json - 环境相关的应用程序配置文件。
.gitignore - Git忽略文件列表。
LICENSE - 许可证文件，说明了软件的使用条款（MIT许可证）。

2. 项目的启动文件介绍

Program.cs

作用: 这个文件是应用程序的起点，初始化WebHostBuilder来构建Web主机，并配置Kestrel服务器或IIS集成等。

关键代码示例:

public static void Main(string[] args)
{
    CreateHostBuilder(args).Build().Run();
}

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

这段代码负责启动应用程序，并通过调用UseStartup<Startup>指定应用程序的配置类。

Startup.cs

作用: 负责配置DI（依赖注入）、中间件管道以及服务注册，并配置路由规则。
关键部分:
- ConfigureServices(IServiceCollection services)方法中注册服务，包括数据库上下文、JWT服务等。
- Configure(IApplicationBuilder app, IWebHostEnvironment env)配置HTTP请求管道，添加诸如日志记录、身份验证中间件等。

3. 项目的配置文件介绍

appsettings.json 此文件包含了应用程序的核心配置信息，适用于所有环境。它可能包含数据库连接字符串、JWT密钥、过期时间等关键设置。

{
    "Logging": { ... },
    "AllowedHosts": "*",
    "AppSettings": {
        "Secret": "your-secret-key", // JWT密钥
        "Issuer": "localhost", // 签发者
        "Audience": "http://localhost/api", // 观众，即接收方地址
        "Expiration": 30 // Token有效时长（分钟）
    }
}