go语言后端开发学习(一)——JWT的介绍以及基于JWT实现登录验证

news2024/11/17 23:25:51

什么是JWT

JWT,全名为JSON Web Token，是当下主流的一种服务端通信认证方式，具有轻量,无状态的特点，它实现了让我们在用户与服务器之间传递安全可靠的Json文本信息，它的使用过程主要是这样的：
当用户注册的时候，服务端会接受到来自用户输入的账号与密码，然后服务端会向客户端发送JWT，而当客户端有了JWT这个令牌后，当下一次客户端向服务端请求数据时，我们只要利用这个令牌，就可以轻松访问服务端的数据了，因此这种信息传输方式也有着开销少，传输安全的特点。

JWT的下载

终端输入以下命令即可：

go get -u github.com/golang-jwt/jwt/v4

JWT的构成

简介

在RFC标准中，JWT由以下三个部分组成：

  • Header: 头部
  • Payload: 载荷
  • Signature: 签名

我们会将这里的每一个部分用一个点.来分隔，最后组成一个字符串，格式如下：

header.payload.signature

而这就是一个JWT令牌的标准结构，接下来网格大家来逐个讲解每个结构的作用。

头部

Header中主要是声明一些基本信息，通常是由两部分来组成：

  • 令牌的类型
  • 签名所使用的加密算法
    比如下面的这个示例：
{
	"alg":"HS526",
	"typ":"JWT"
}

上面这个Json格式的数据意思大致为：令牌的类型为JWT，签名所使用的加密算法为HS526,最后再将JSON对象通过Base64Url编码为字符串，该字符串就是JWT的头部

载荷

JWT的第二部分是载荷部分，主要就是声明部分claims，声明部分通常是一个实体的数据，比如一个用户。而关于声明的类型主要有以下几种：

  • reigstered：Reigetered claims代表着一些预定义的声明 ，例如:iss(issuer 签发者)，exp(expiration time 过期时间),aud(audience 受众)
  • public:Puiblic claims这部分可以让使用JWT的人随意定义，但是最好避免与其他声明部分冲突
  • private claims:这部分的声明同样也是自定义的，通常用于在服务双方共享一些信息。

示例：

{
	"sub": "1234567890",
  	"name": "John Doe",
  	"admin": true
}

该JSON对象将通过Base64Url编码为字符串，该字符串就是JWT的第二部分。

注意：虽然载荷部分也受到保护，也有防篡改，但是这一部分是公共可读的，所以不要把敏感信息存放在JWT内。

签名

在获得了编码的头部和编码的载荷部分后，就可以通过头部所指明的签名算法根据前两个部分的内容再加上密钥进行加密签名，所以一旦JWT的内容有任何变化，解密时得到的签名都会不一样，同时如果是使用私钥，也可以对JWT的签发者进行验证。

JWT的工作原理

在身份验证中，用户使用凭据成功登录是，将会返回一个JSON WEB令牌，由于令牌是凭证，所以要求我们要常常小心地防止出现安全问题，所以令牌的保存时间不应超过其所需的时间,同时无论何时用户想要访问受保护的路由与资源,在发送请求时都必须携带上token，服务端在收到JWT后会对其进行有效性认证，例如内容有篡改，token已过期等等，如果验证通过就可以顺利的访问资源。

注意：虽然JWT允许我们携带一些基本的信息，但是建议不要带有过大信息量的数据。

JWT的使用案例

这里我主要会以一个通过JWT来实现的登录验证中间件来讲解一下我们如何在项目中使用JWT:

设置JWTKey

首先我们在config文件中设置JWTKey:
在这里插入图片描述

然后我们基于这个配置文件读取来读取配置：

package utils

import (
	"fmt"
	"github.com/sirupsen/logrus"
	"gopkg.in/ini.v1"
)

type Config struct {
	Server   *server   `ini:"server"`
	Database *database `ini:"database"`
}

type server struct {
	AppMode  string `ini:"AppMode"`
	HttpPort string `ini:"HttpPort"`
	JWTKey   string `ini:"JWTKey"`
}

type database struct {
	Db         string `ini:"Db"`
	DbName     string `ini:"DbName"`
	DbUser     string `ini:"DbUser"`
	DbPassWord string `ini:"DbPassWord"`
	DbHost     string `ini:"DbHost"`
	DbPort     string `ini:"DbPort"`
}

var ServerSetting = &server{
	AppMode:  "debug",
	HttpPort: ":3000",
	JWTKey:   "FengXu123",
}

var DatabaseSetting = &database{
	Db:         "mysql",
	DbName:     "goblog",
	DbUser:     "root",
	DbPassWord: "ba161754",
	DbHost:     "localhost",
	DbPort:     "3306",
}

// Config_Message
var Config_Message = &Config{
	Server:   ServerSetting,
	Database: DatabaseSetting,
}

func init() {
	filename := "config/config.ini"
	cfg, err := ini.Load(filename)
	if err != nil {
		logrus.Errorf("配置文件加载失败: %v", err)
	}
	err = cfg.MapTo(Config_Message)
	if err != nil {
		logrus.Errorf("配置文件映射失败: %v", err)
	}
	fmt.Println(Config_Message.Server.JWTKey)
	logrus.Infof("配置文件加载成功")
}

具体go-ini第三方包的使用可以参考博主以前的文章：
go语言并发实战——日志收集系统(五) 基于go-ini包读取日志收集服务的配置文件

运行程序后，控制台显示：
在这里插入图片描述

说明我们的配置信息就成功被加载出来了。

定义相关结构体与信息

// JWT结构体
type JWT struct {
	JWTKey []byte // JWT密钥
}

func NewJWT() *JWT { //新建JWT结构体
	return &JWT{
		JWTKey: []byte(utils.Config_Message.Server.JWTKey),
	}
}

// 自定义声明
type MyClaims struct {
	Username string `json:"username"` //这里的与gorm中声明的保持一致
	jwt.RegisteredClaims
}

// 定义相关错误信息
var (
	TokenExpired     error = errors.New("token已过期，请重新登录")
	TokenNotValidYet error = errors.New("token无效，请重新登录")
	TokenMalformed   error = errors.New("token不正确，请重新登录")
	TokenInvalid     error = errors.New("这不是一个token，请重新登录")
)

生成token

func(j *JWT)CreateToken(claims MyClaims) (string, error) {
	token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
	return token.SignedString(j.JWTKey)
}

部分函数记录：

  1. NewWithClaims:
func NewWithClaims(method SigningMethod, claims Claims) *Token

  • 作用：创建一个新的token

  • 相关参数：

    • SigningMethod：所采用的加密方法
    • claims：我们所定义的声明
  1. SignedString：
  • 作用：SignedString创建并返回一个完整的、已签名的JWT

解析token

// 解析token

func (j *JWT) ParseToken(tokenString string) error {
	// 解析token
	token, err := jwt.Parse(tokenString, func(token *jwt.Token) (interface{}, error) {
		return j.JWTKey, nil
	})

	// 校验token
	if token.Valid {
		return nil
	} else if errors.Is(err, jwt.ErrTokenExpired) || errors.Is(err, jwt.ErrTokenNotValidYet) {
		return TokenExpired
	} else if errors.Is(err, jwt.ErrSignatureInvalid) {
		return TokenInvalid
	} else if errors.Is(err, jwt.ErrTokenMalformed) {
		return TokenMalformed
	} else {
		return TokenNotValidYet
	}
}

实现token中间件

//jwt中间件

func JwtToken() gin.HandlerFunc {
	return func(c *gin.Context) {
		var code int
		//检验Header
		tokenHeader := c.Request.Header.Get("Authorization")
		if tokenHeader == "" {
			code = errmsg.ERROR_TOKEN_NOT_EXIST
			c.JSON(200, gin.H{
				"status":  code,
				"message": errmsg.GetErrMsg(code),
			})
			c.Abort() //拦截中间件
		}
		checkToken := strings.Split(tokenHeader, " ")
		if len(checkToken) == 0 {
			code = errmsg.ERROR_TOKEN_TYPE_WRONG
			c.JSON(200, gin.H{
				"status":  code,
				"message": errmsg.GetErrMsg(code),
			})
			c.Abort()
		}

		if len(checkToken) != 2 || checkToken[0] != "Bearer" {
			c.JSON(200, gin.H{
				"status":  code,
				"message": errmsg.GetErrMsg(code),
			})
			c.Abort()
		}

		//解析token
		j := NewJWT()
		err := j.ParseToken(checkToken[1])
		if err != nil {
			if errors.Is(err, TokenExpired) {
				c.JSON(200, gin.H{
					"status":  errmsg.ERROR_TOKEN_RUNTIME,
					"message": errmsg.GetErrMsg(errmsg.ERROR_TOKEN_RUNTIME),
				})
				c.Abort()
			} else {
				c.JSON(200, gin.H{
					"status":  errmsg.ERROR,
					"message": err.Error(),
				})
				c.Abort()
			}
		}
		c.Next()
	}
}

完整代码

package middleware

import (
	"errors"
	"gin_vue_blog/utils"
	"gin_vue_blog/utils/errmsg"
	"github.com/gin-gonic/gin"
	"github.com/golang-jwt/jwt/v4"
	"strings"
)

// JWT结构体
type JWT struct {
	JWTKey []byte // JWT密钥
}

func NewJWT() *JWT { //新建JWT结构体
	return &JWT{
		JWTKey: []byte(utils.Config_Message.Server.JWTKey),
	}
}

// 自定义声明
type MyClaims struct {
	Username string `json:"username"` //这里的与gorm中声明的保持一致
	jwt.RegisteredClaims
}

// 定义相关错误信息
var (
	TokenExpired     error = errors.New("token已过期，请重新登录")
	TokenNotValidYet error = errors.New("token无效，请重新登录")
	TokenMalformed   error = errors.New("token不正确，请重新登录")
	TokenInvalid     error = errors.New("这不是一个token，请重新登录")
)

// 生成token
func (j *JWT) CreateToken(claims MyClaims) (string, error) {
	token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
	return token.SignedString(j.JWTKey)
}

// 解析token

func (j *JWT) ParseToken(tokenString string) error {
	// 解析token
	token, err := jwt.Parse(tokenString, func(token *jwt.Token) (interface{}, error) {
		return j.JWTKey, nil
	})

	// 校验token
	if token.Valid {
		return nil
	} else if errors.Is(err, jwt.ErrTokenExpired) || errors.Is(err, jwt.ErrTokenNotValidYet) {
		return TokenExpired
	} else if errors.Is(err, jwt.ErrSignatureInvalid) {
		return TokenInvalid
	} else if errors.Is(err, jwt.ErrTokenMalformed) {
		return TokenMalformed
	} else {
		return TokenNotValidYet
	}
}

//jwt中间件

func JwtToken() gin.HandlerFunc {
	return func(c *gin.Context) {
		var code int
		//检验Header
		tokenHeader := c.Request.Header.Get("Authorization")
		if tokenHeader == "" {
			code = errmsg.ERROR_TOKEN_NOT_EXIST
			c.JSON(200, gin.H{
				"status":  code,
				"message": errmsg.GetErrMsg(code),
			})
			c.Abort() //拦截中间件
		}
		checkToken := strings.Split(tokenHeader, " ")
		if len(checkToken) == 0 {
			code = errmsg.ERROR_TOKEN_TYPE_WRONG
			c.JSON(200, gin.H{
				"status":  code,
				"message": errmsg.GetErrMsg(code),
			})
			c.Abort()
		}

		if len(checkToken) != 2 || checkToken[0] != "Bearer" {
			c.JSON(200, gin.H{
				"status":  code,
				"message": errmsg.GetErrMsg(code),
			})
			c.Abort()
		}

		//解析token
		j := NewJWT()
		err := j.ParseToken(checkToken[1])
		if err != nil {
			if errors.Is(err, TokenExpired) {
				c.JSON(200, gin.H{
					"status":  errmsg.ERROR_TOKEN_RUNTIME,
					"message": errmsg.GetErrMsg(errmsg.ERROR_TOKEN_RUNTIME),
				})
				c.Abort()
			} else {
				c.JSON(200, gin.H{
					"status":  errmsg.ERROR,
					"message": err.Error(),
				})
				c.Abort()
			}
		}
		c.Next()
	}
}

备注：拦截中间件与响应中间件的具体细节可以参考博主之前的文章：
Gin框架学习笔记(五) ——文件上传与路由中间件

拓展：签名算法的选择(仅供参考)

可用的签名算法有好几种，在使用之前应该先了解下它们之间的区别以便更好的去选择签名算法，它们之间最大的不同就是对称加密和非对称加密。

最简单的对称加密算法HSA，让任何[]byte都可以用作有效的密钥，所以计算速度稍微快一点。在生产者和消费者双方都是可以被信任的时候，对称加密算法的效率是最高的。不过由于签名和验证都使用相同的密钥，因此无法轻松的分发用于验证的密钥，毕竟签名的密钥也是同一个，签名泄露了则JWT的安全性就毫无意义。

非对称加密签名方法，例如RSA，使用不同的密钥来进行签名和验证token，这使得生成带有私钥的令牌成为可能，同时也允许任何使用公钥验证的人正常访问。

不同的签名算法所需要的密钥的类型也不同，下面给出一些常见签名算法的类型：

  • HMAC：对称加密，需要类型[]byte的值用于签名和验证。 (HS256,HS384,HS512)
  • RSA：非对称加密，需要rsa.PrivateKey类型的值用于签名，和rsa.PublicKey类型的值用于验证。(RS256,RS384,RS512)
  • ECDSA：非对称加密，需要ecdsa.PrivateKey类型的值用于签名，和ecdsa.PublicKey类型的值用于验证。(ES256,ES384,ES512)
  • EdDSA：非对称加密，需要ed25519.PrivateKey类型的值用于签名和ed25519.PublicKey 类型的值用于验证。(Ed25519)

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1792412.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

使用from…import语句导入模块

使用from…import语句导入模块

自学python如何成为大佬(目录):https://blog.csdn.net/weixin_67859959/article/details/139049996?spm1001.2014.3001.5501 在使用import语句导入模块时，每执行一条import语句都会创建一个新的命名空间（namespace），并且在该命名…
阅读更多...
python--面向对象-文件读写-异常

python--面向对象-文件读写-异常

一、继承 定义一个类时，需要使用另外一个类的方法或属性，就可以通过继承实现 object是Python的顶级类，创建类是会自动继承，就拥有object中的方法 定义格式 # 类的定义 # 旧式类定义 一般在定义单个类时使用 class 类名:name N…
阅读更多...
SwiftUI中ContentUnavailableView的使用（iOS 17、tvOS 17推出的新组件）

SwiftUI中ContentUnavailableView的使用（iOS 17、tvOS 17推出的新组件）

iOS 17为SwiftUI带来了一个新的组件ContentUnavailableView，它允许我们向用户呈现一个空状态，而不需要创建自定义错误或者无内容视图。 ContentUnavailableView易于使用，可自定义，并且具有用于空搜索状态的预定义视图。 建议在无…
阅读更多...
DVWA-Insecure CAPTCHA

DVWA-Insecure CAPTCHA

本模块是绕过修改密码需要的验证码，验证码使用的是 Google 提供 reCAPTCHA 服务，这个服务我们使用不了，下面讲一下绕过就好了，不影响。 Low 看下后端代码，有两部分POST step1为正常过验证，step2为修改密码…
阅读更多...
[数据集][图像分类]十二生肖分类数据集8492张12类别

[数据集][图像分类]十二生肖分类数据集8492张12类别

数据集类型：图像分类用，不可用于目标检测无标注文件 数据集格式：仅仅包含jpg图片，每个类别文件夹下面存放着对应图片 图片数量(jpg文件个数)：8492 分类类别数：12 类别名称:["dog","dragon&q…
阅读更多...
全球与中国汽车张紧器市场：增长趋势、竞争格局与前景展望

全球与中国汽车张紧器市场：增长趋势、竞争格局与前景展望

汽车张紧器是保持皮带和链条适当张力以保持汽车同步运行的关键部件。其主要目的是确保正时正确，避免出现链条和链轮过度磨损、链条拍击引起的发动机噪音以及可能严重损害发动机的正时链条故障等问题，从而使链条保持在理想的张力。 汽车张紧器市场的成长是…
阅读更多...
GNeRF论文理解

GNeRF论文理解

文章目录 主要解决什么问题？结构设计以及为什么有效果？个人想法。 主要解决什么问题？ 本文主要想要解决的问题是 如何使用uncalibrated的照片来进行Nerf重建。虽然说现在已经有了一些方式可以对相机位姿进行估计和优化，但是他们限…
阅读更多...
解锁下载EasyRecovery2024电脑版软件 3步破解下载秘籍！

解锁下载EasyRecovery2024电脑版软件 3步破解下载秘籍！

在数字时代，数据已成为我们生活中不可或缺的一部分。无论是工作中的重要文件，还是珍贵的家庭照片和视频，数据都承载着我们的回忆和努力。然而，数据的丢失也是我们常常遇到的问题。硬盘损坏、误删除、病毒攻击等都可能导致数据丢失…
阅读更多...
如何将本地项目上传到GitHub

如何将本地项目上传到GitHub

在软件开发过程中，将本地项目上传到GitHub是一个非常重要的步骤。它不仅可以帮助你备份代码，还可以让你与团队成员共享和协作开发。本文将详细介绍如何将本地项目上传到GitHub。 前提条件 已安装Git。如果还没有安装，请参考Git官网进行下载…
阅读更多...
记忆化搜索汇总

记忆化搜索汇总

记忆化搜索简介 记忆化搜索（Memoization Search）：是一种通过存储已经遍历过的状态信息，从而避免对同一状态重复遍历的搜索算法。 记忆化搜索是动态规划的一种实现方式。在记忆化搜索中，当算法需要计算某个子问题的结果…
阅读更多...
代理记账公司哪家好，深度剖析与选择指南

代理记账公司哪家好，深度剖析与选择指南

代理记账，作为企业会计管理和运营的重要环节，已经逐渐被越来越多的企业所重视，在众多的代理记账公司中，如何选择一家专业、高效且值得信赖的代理记账机构呢？以下是一些深度解析和推荐。 公司的规模 规模较大的代理记账…
阅读更多...
局域网怎么设置路由器？

局域网怎么设置路由器？

在搭建局域网的过程中，设置路由器是非常重要的一步。正确地设置路由器可以确保局域网的正常运行，并且可以更好地保护网络安全。以下是一些关于如何设置路由器的指南。 第一步：获取路由器 您需要获得一台适合您需求的路由器设备。选择一款性能…
阅读更多...
从C到C++，C++入门（2）

从C到C++，C++入门（2）

在C入门篇（1）中，博主为大家简单介绍了什么是C，以及C中的关键字，命名空间，输入与输出和缺省参数的相关知识。今天就让我们继续一起学习C的基础知识点吧！！ 1.函数重载 1.1函数重载的概…
阅读更多...
通过 .NET COM 互操作设置 System.Drawing.Color

通过 .NET COM 互操作设置 System.Drawing.Color

1. 问题背景 在尝试使用 Aspose.Words 库执行 COM 互操作时，遇到了一个关键问题：无法设置颜色。理论上，可以通过向 DocumentBuilder.Font.Color 赋值来设置颜色，但尝试时却出现了 OLE 错误 0x80131509。 以下代码示例演示了这个…
阅读更多...
Python Flask 入门开发

Python Flask 入门开发

Python基础学习： Pyhton 语法基础Python 变量Python控制流Python 函数与类Python Exception处理Python 文件操作Python 日期与时间Python Socket的使用Python 模块Python 魔法方法与属性 Flask基础学习： Python中如何选择Web开发框架？Pyth…
阅读更多...
杨校老师项目之SpringBoot整合Vue超市管理系统

杨校老师项目之SpringBoot整合Vue超市管理系统

1.获取代码： 有偿获取：mryang511688 2.技术栈 SpringBoot MySQL mybatis Plus Redis 摘 要 随着信息化时代的到来，管理系统都趋向于智能化、系统化，超市进销存系统也不例外，但目前国内仍都使用人工管理&#xff…
阅读更多...
运维开发（DevOps）：加速软件交付的关键方法

运维开发（DevOps）：加速软件交付的关键方法

1. 什么是运维开发 运维开发（DevOps）是将软件开发（Development）与信息技术运维（Operations）的流程整合在一起的实践方法。DevOps的目标是通过增强开发和运维团队之间的协作，提高软件产品的发布…
阅读更多...
【全开源】小区物业收费管理系统小程序（FastAdmin+UniApp）

【全开源】小区物业收费管理系统小程序（FastAdmin+UniApp）

便捷生活新选择 一款基于FastAdminUniApp开发的一款物业收费管理小程序。包含房产管理、收费标准、家属管理、抄表管理、在线缴费、业主公告、统计报表、业主投票、可视化大屏等功能。为物业量身打造的小区收费管理系统，贴合物业工作场景，轻松提高物业费…
阅读更多...
C#开源实用的工具类库，集成超过1000多种扩展方法

C#开源实用的工具类库，集成超过1000多种扩展方法

前言 今天大姚给大家分享一个C#开源（MIT License）、免费、实用且强大的工具类库，集成超过1000多种扩展方法增强 .NET Framework 和 .NET Core的使用效率：Z.ExtensionMethods。 直接项目引入类库使用 在你的对应项目中NuGet包管…
阅读更多...
【ARM Cache 及 MMU 系列文章 6 -- Cache 寄存器 CTR | CLIDR | CCSIDR | CSSELR 使用详解 1】

【ARM Cache 及 MMU 系列文章 6 -- Cache 寄存器 CTR | CLIDR | CCSIDR | CSSELR 使用详解 1】

请阅读【ARM Cache 及 MMU/MPU 系列文章专栏导读】 及【嵌入式开发学习必备专栏】 文章目录 Cache 常用寄存器Cache CSSELR 寄存器Cache CSSELR 使用场景Cache CSSELR 操作示例 Cache CLIDR 寄存器LoUU 介绍LoUU 使用 LoUIS 介绍CLIDR 使用 Cache CCSIDR 寄存器 Cache 常用寄存…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023