hmac模块生成加入了密钥的消息摘要详解

hmac模块

hmac模块用于生成HMAC码。这个HMAC码可以用于验证消息的完整性，其原理也很简单，就是一种加入了密钥的消息摘要，相比起MAC更加安全。JWT（JSON Web Token）中第三部分的消息摘要就是使用了HMAC。

HMAC(Hash-based Message Authentication Code)

先大致介绍一下HMAC吧。HMAC是一种消息摘要算法，是一种特殊的MAC（消息认证码），内部使用别的摘要算法进行摘要的计算（比如MD5）。相比MAC，HMAC在生成摘要的时候加入了密钥，这使得HMAC码不仅可以用于验证消息完整性，并且保证了其无法被伪造。注意，摘要算法跟加密算法是有区别的。

整个算法可以总结为下图 图片来自wiki：

K：key，密钥
K'：调整长度之后的密钥
m：message，消息
H：hash function，消息摘要算法
opad：outer padding，一个块长度的十六进制常数，Ox5c5c5c…5c
ipad：inner padding，一个块长度的十六进制常数，Ox363636…36

计算步骤：

如果K的长度大于使用的摘要算法的Block Size（比如MD5中是64），HMAC算法会先计算K的摘要，而当K的长度小于Block Size时则用0进行填充。这一步得到结果K'。
将K'与ipad做异或运算。
上一步的结果加上m并计算消息摘要值。
将K'与opad做异或运算。
上一步的结果加上第三步的结果并计算消息摘要值，这一步的结果为最终结果。

hmac.HMAC(key, msg=None, digestmod=None)

hmac模块中最核心的就是HMAC类，可以直接通过实例化来获取该类的实例，也可以通过调用函数hmac.new(key, msg=None, digestmod=None)获取。

参数key可以是一个bytes对象或者bytearray对象，是用于加密的密钥。如果key大于Block Size（默认是64），会先计算一次消息摘要，小于的话用0填充到与Block Size相同的长度。

参数msg是用于加密的消息。

参数digestmod是用于计算摘要的算法，默认使用hashlib.md5。这个参数支持三种类型的值：

可以是hashlib里面的其他的构造器，比如hashlib.sha1、hashlib.sha256等
可以是一个字符串，会调用hashlib.new(digestmod)获取相应的构造器
可以是一个符合PEP247标准的模块，这时会调用digestmod.new()

API

HMAC.update(msg)

更新HMAC对象的内容，附加到之前的msg后面。

HMAC.digest()

返回消息摘要值。因为HMAC.update()会动态修改msg内容，所以每次都会重新计算。

HMAC.hexdigest()

以十六进制的形式返回消息摘要值。因为HMAC.update()会动态修改msg内容，所以每次都会重新计算。

HMAC.copy()

返回HMAC对象的克隆，用于在两个对象内容拥有相同部分的时候提高效率，修改克隆的对象不会影响原对象。