AspNetCore 成长杂记(一):JWT授权鉴权之生成JWT(其一)

引子

最近不知怎么的,自从学了WebAPI(为什么是这个,而不是MVC,还不是因为MVC的Razor语法比较难学,生态不如现有的Vue等框架,webapi很好的结合了前端生态)以后,使用别人的组件一帆风顺,但是不知其意,突然很想自己实现一个基于的JWT认证服务,来好好了解一下这个内容。

起步

自从Session-Cookie方案逐渐用的越来越少,JWT的使用也变得成为主流的安全方案之一,但是在.NET Core的文档(这里的.NET Core指代原来的.Net Core以及之后的版本,文档是微软的开发者文档)并没有对JWT做详细的介绍(可能是在微软看来太简单了,不值得细说),仅仅略带一提而已,实例代码更是少得可怜,根本没有什么建设性的帮助作用,更像文档工程师在水任务(但不得不说微软的Indentity框架是真的强大,Spring Security的功能基本都实现了)。纵然是费尽心机找资料,钻研文档,还是所获甚少。但是在不断的努力之下还是找到很多方案的,其中比较有用的就拿几个,我仔细研究实践后得到了这几篇文章,不求它有多大帮助,之希望它能帮更多人少走弯路。
然而这几个方案大概可以分成两类:

  1. 非对称加密的JWT(常用于外部网络认证)
  2. 对称加密的JWT (通常是内部系统)
    对比之下,非对称的JWT更安全,更符号系统的安全需求,虽然增加了解密时间,但利大于弊。可是关于非对称的JWT的文章却很少,大部分都是关于对称加密的JWT资料。对于这种情况,我自己也没有什么好的办法,直到我在看一篇文章时,在Nuget上无意找到的一个包改变了我的认知————JWT(名字粗暴直接)。当然,你直接使用.NET的扩展库也可以,这里面有一个System.IdentityModel.Tokens.Jwt可以同样使我们更快乐的创建JWT。关于这部分的内容,我也会在之后的时间单独写一篇文章来实验。
    另外,对于API验证测试工具,一般都是默认的Swagger,如果你喜欢更好用的工具,我推荐使用ApiFox或者EOLink

实施

首先创建一个WebAPI项目,至于是否在启动后使用HTTPS,根据自己的需要,一般都是需要的。然后用Nuget或者Dotnet安装JWT这个Nuget包即可开始,如果是ASP.NET Core这样需要依赖注入环境的,推荐JWT.Extensions.AspNetCore这个包(强力推荐),可以更好的让你开始,仅仅需要基本功能的只用JWT即可。
由于我这里使用的是RSA1024bit,所以需要一个HTTPS的PEM或者CRT证书做CA,各位可以自己生成一个。
首先,我们需要为服务注入这个包的依赖,即使用builder.Services.AddAuthentication().AddJwt()来添加相关依赖。那为什么是要使用这个方法呢?如果你通过对象浏览器查看API会发现一个AddJwtDecoder的方法,同样可以添加依赖,并且更灵活,如果反编译就发现——AddJwt方法是对AddJwtDecoder的某个重载的调用,后面可以调用其他方法达成同样的效果,所以推荐使用这个方法注入。

服务注入代码如下:
builder.Services.AddAuthentication(options =>
{
    options.DefaultAuthenticateScheme = JwtAuthenticationDefaults.AuthenticationScheme;
    options.DefaultChallengeScheme = JwtAuthenticationDefaults.AuthenticationScheme;
})
.AddJwt();

然后在应用认证中间件即可。

app.UseAuthentication();

完成这些工作以后,还需要创建一个用来根据用户信息生成JWT的控制器,为了防止使用HTTPGet被攻击,我这里采用了HTTPPost。
根据这个包的文档,生成一个JWT字符串非常容易,只需要创建一个x509对象或者两个RSA对象作为公钥和私钥即可,我推荐使用这个包里面提供的FluentApi方式,写起来非常舒服,最后编码生成JWT,完成。

生成JWT的代码如下:
var token = JwtBuilder.Create()
            .WithAlgorithm(algorithm) // 加密算法
            .AddClaim<string>("Account", accountName) //添加用户信息
            .AddClaim<string>("Passwd", passwdContext) //添加用户密码
            .Encode(); //编码生成jwt

完整的控制器代码如下:
[Route("api/[controller]")]
[ApiController]
public class JwtController : ControllerBase
{
    private RSA publicKey = RSA.Create();
    private RSA privateKey = RSA.Create();
    private RS2048Algorithm? algorithm { get; set; }

    public JwtController()
    {
        algorithm = new RS2048Algorithm(publicKey, privateKey);
    }



    [HttpPost]
    public async Task<string> CreateJwt(string accountName, string passwdContext)
    {
        return await Task<string>.Run<string>(() =>
        {
            var token =
            JwtBuilder.Create()
            .WithAlgorithm(algorithm)
            .AddClaim<string>("Account", accountName)
            .AddClaim<string>("Passwd", passwdContext)
            .Encode();

            return token;
        });
    }
}

总结

JWT.Extensions.AspNetCore这个包是一个集成了常用jwt操作的包,可以让你不必关心JWT的创建过程,这大大化简了我们使用JWT的过程,在一定程度上提高了生产力。如果您喜欢这个库,可以到项目主页上添加一颗星。

注意:

经过本人的亲身经历,x509在.NET6之后的类库X509Certificate2不能直接生成私钥,需要使用该类的成员方法:public System.Security.Cryptography.X509Certificates.X509Certificate2 CopyWithPrivateKey (System.Security.Cryptography.ECDiffieHellman privateKey);创建一个带有私钥的副本,否则会出现私钥在对象构造成功后出现NULL的情况。
如果没有特殊必要,建议直接使用Rsa的成员方法直接生成一个Rsa对象来操作比较简便,目前这个办法还可以改进,欢迎各位留言。

原文链接:https://www.cnblogs.com/Delighted/p/17330181.html

本站文章如无特殊说明,均为本站原创,如若转载,请注明出处:AspNetCore 成长杂记(一):JWT授权鉴权之生成JWT(其一) - Python技术站

(0)
上一篇 2023年4月24日
下一篇 2023年4月24日

相关文章

  • C# 10分钟完成百度人脸识别(入门篇)

    C#10分钟完成百度人脸识别(入门篇) 简介 百度人脸识别是一项基于人工智能的技术,可以通过照片或视频中的人脸,进行识别、比对,以及人脸库管理等功能。本文主要介绍如何使用C#完成百度人脸识别的入门教程。 步骤 1. 创建百度AI账号 首先,你需要去百度AI开放平台官网注册一个账号,然后创建一个应用,选择人脸识别。在创建应用的时候,记得保存下“App ID”、…

    C# 2023年5月15日
    00
  • 一个可用于生产项目 基于 .NET 6 自研ORM

    Fast Framework 作者 Mr-zhong 代码改变世界…. 一、前言 Fast Framework 基于NET6.0 封装的轻量级 ORM 框架 支持多种数据库 SqlServer Oracle MySql PostgreSql Sqlite 优点: 体积小、可动态切换不同实现类库、原生支持微软特性、流畅API、使用简单、性能高、模型数据绑定…

    C# 2023年4月22日
    00
  • c# Thread类的用法详解

    c#Thread类的用法详解 什么是Thread类 C#中的Thread类是用于创建和控制多线程的主要类。Thread类为开发人员提供了创建和操作线程的方法和属性。 创建Thread对象 创建Thread对象有两种主要的方法: 1. 使用Thread类的构造函数 可以通过Thread类的构造函数在程序中创建一个线程对象。Thread构造函数支持以下常见的签名…

    C# 2023年5月15日
    00
  • .Net Winform开发笔记(四)透过现象看本质

    接下来我将详细讲解“.Net Winform开发笔记(四)透过现象看本质”的完整攻略。 攻略概述 本篇攻略主要介绍如何透过现象看本质进行Winform开发,内容分为三个部分: 理解Winform的本质: 认识Winform的结构 理解Winform的生命周期 常用Winform控件的本质: 理解各种Winform控件的特点和用途 能够选择正确的控件实现需要的…

    C# 2023年5月31日
    00
  • C#生成Word文档代码示例

    下面是关于“C#生成Word文档代码示例”的完整攻略: 第一步:安装和引用必备组件 要使用C#生成Word文档,需要安装Open XML SDK 2.5 for Microsoft Office。这个组件提供了一个C# API,可以在应用程序中使用C#代码创建、读取和编辑Microsoft Office Word文档。 安装完成后,可以在Visual Stu…

    C# 2023年5月31日
    00
  • C#使用SQL DataAdapter数据适配代码实例

    SQL DataAdapter 是什么? SQL DataAdapter 是 ADO.NET 的一部分,他允许 C# 将数据从 SQL 数据库服务器检索到以 DataSet 和 DataTable 对象表示的本地内存中。使用 DataAdapter 对象,可以轻松地自动化与数据源的通信和数据填充。 C# 使用 DataAdapter 填充 DataSet 的…

    C# 2023年6月2日
    00
  • C# System.TypeInitializationException 异常处理方案

    当在C#程序中调用某个类或静态构造函数时,如果类的静态构造函数引发异常,System.TypeInitializationException异常将抛出。在这种情况下,程序将在控制台或日志中输出异常提示信息,并停止运行。针对这种情况,我们可以采取以下几种处理方案: 方案1:使用try…catch块处理TypeInitializationException异…

    C# 2023年6月6日
    00
  • C#泛型和反射实例解析

    C#泛型和反射实例解析 在C#中,泛型和反射是两个非常重要的概念。泛型可以让我们编写高度通用的代码,而反射则可以让我们在运行时动态地获取类型信息和调用方法,非常适合特定的场景。本文将针对泛型和反射进行实例分析,为大家介绍它们的具体用法和场景。 泛型实例解析 1.泛型基本语法 泛型是C#4.0及以上版本的新特性。它能够在定义类、结构体、接口、方法等时,指定数据…

    C# 2023年5月31日
    00
合作推广
合作推广
分享本页
返回顶部