hmac --- 基于密鑰的消息驗(yàn)證?

源代碼: Lib/hmac.py

此模塊實(shí)現(xiàn)了 HMAC 算法，算法的描述參見(jiàn) RFC 2104。

hmac.new(key, msg=None, digestmod='')?

返回一個(gè)新的 hmac 對(duì)象。 key 是一個(gè)指定密鑰的 bytes 或 bytearray 對(duì)象。 如果提供了 msg，將會(huì)調(diào)用 update(msg) 方法。 digestmod 為 HMAC 對(duì)象所用的摘要名稱(chēng)、摘要構(gòu)造器或模塊。 它可以是適用于 hashlib.new() 的任何名稱(chēng)。 雖然該參數(shù)位置靠后，但它卻是必須的。

在 3.4 版更改: 形參 key 可以為 bytes 或 bytearray 對(duì)象。 形參 msg 可以為 hashlib 所支持的任意類(lèi)型。 形參 digestmod 可以為某種哈希算法的名稱(chēng)。

Deprecated since version 3.4, removed in version 3.8: MD5 作為 digestmod 的隱式默認(rèn)摘要已被棄用。 digestmod 形參現(xiàn)在是必須的。 請(qǐng)將其作為關(guān)鍵字參數(shù)傳入以避免當(dāng)你沒(méi)有初始 msg 時(shí)將導(dǎo)致的麻煩。

hmac.digest(key, msg, digest)?

基于給定密鑰 key 和 digest 返回 msg 的摘要。 此函數(shù)等價(jià)于 HMAC(key, msg, digest).digest()，但使用了優(yōu)化的 C 或內(nèi)聯(lián)實(shí)現(xiàn)，對(duì)放入內(nèi)存的消息能處理得更快。 形參 key, msg 和 digest 具有與 new() 中相同的含義。

作為 CPython 的實(shí)現(xiàn)細(xì)節(jié)，優(yōu)化的 C 實(shí)現(xiàn)僅當(dāng) digest 為字符串并且是一個(gè) OpenSSL 所支持的摘要算法的名稱(chēng)時(shí)才會(huì)被使用。

3.7 新版功能.

HMAC 對(duì)象具有下列方法:

HMAC.update(msg)?

用 msg 來(lái)更新 hmac 對(duì)象。 重復(fù)調(diào)用相當(dāng)于單次調(diào)用并傳入所有參數(shù)的拼接結(jié)果: m.update(a); m.update(b) 等價(jià)于 m.update(a + b)。

在 3.4 版更改: 形參 msg 可以為 hashlib 所支持的任何類(lèi)型。

HMAC.digest()?

返回當(dāng)前已傳給 update() 方法的字節(jié)串?dāng)?shù)據(jù)的摘要。 這個(gè)字節(jié)串?dāng)?shù)據(jù)的長(zhǎng)度將與傳給構(gòu)造器的摘要的長(zhǎng)度 digest_size 相同。 它可以包含非 ASCII 的字節(jié)，包括 NUL 字節(jié)。

警告

在驗(yàn)證例程運(yùn)行期間將 digest() 的輸出與外部提供的摘要進(jìn)行比較時(shí)，建議使用 compare_digest() 函數(shù)而不是 == 運(yùn)算符以減少定時(shí)攻擊防御力的不足。

HMAC.hexdigest()?

類(lèi)似于 digest() 但摘要會(huì)以?xún)杀堕L(zhǎng)度字符串的形式返回，其中僅包含十六進(jìn)制數(shù)碼。 這可以被用于在電子郵件或其他非二進(jìn)制環(huán)境中安全地交換數(shù)據(jù)值。

警告

在驗(yàn)證例程運(yùn)行期間將 hexdigest() 的輸出與外部提供的摘要進(jìn)行比較時(shí)，建議使用 compare_digest() 函數(shù)而不是 == 運(yùn)算符以減少定時(shí)攻擊防御力的不足。

HMAC.copy()?

返回 hmac 對(duì)象的副本（“克?。?。 這可被用來(lái)高效地計(jì)算共享相同初始子串的數(shù)據(jù)的摘要。

hash 對(duì)象具有以下屬性：

HMAC.digest_size?

以字節(jié)表示的結(jié)果 HMAC 摘要的大小。

HMAC.block_size?

以字節(jié)表示的哈希算法的內(nèi)部塊大小。

3.4 新版功能.

HMAC.name?

HMAC 的規(guī)范名稱(chēng)，總是為小寫(xiě)形式，例如 hmac-md5。

3.4 新版功能.

這個(gè)模塊還提供了下列輔助函數(shù):

hmac.compare_digest(a, b)?

返回 a == b。 此函數(shù)使用一種經(jīng)專(zhuān)門(mén)設(shè)計(jì)的方式通過(guò)避免基于內(nèi)容的短路行為來(lái)防止定時(shí)分析，使得它適合處理密碼。 a 和 b 必須為相同的類(lèi)型：或者是 str (僅限 ASCII 字符，如 HMAC.hexdigest() 的返回值)，或者是 bytes-like object。

備注

如果 a 和 b 具有不同的長(zhǎng)度，或者如果發(fā)生了錯(cuò)誤，定時(shí)攻擊在理論上可以獲取有關(guān) a 和 b 的類(lèi)型和長(zhǎng)度信息 — 但不能獲取它們的值。

3.3 新版功能.

在 3.10 版更改: 此函數(shù)在可能的情況下會(huì)在內(nèi)部使用 OpenSSL 的 CRYPTO_memcmp()。