crypt-r 3.13.1

哈希方法

Python 3.3 中的新功能。

crypt_r 模块定义了哈希方法列表（并非所有方法都在所有平台上可用）

METHOD_SHA512

基于 SHA-512 哈希函数的 16 字符盐和 86 字符哈希的模块加密格式方法。这是最强的方法。

METHOD_SHA256

基于 SHA-256 哈希函数的 16 字符盐和 43 字符哈希的另一种模块加密格式方法。

METHOD_BLOWFISH

基于 Blowfish 加密算法的 22 字符盐和 31 字符哈希的另一种模块加密格式方法。

Python 3.7 中的新功能。

METHOD_MD5

基于 MD5 哈希函数的 8 字符盐和 22 字符哈希的另一种模块加密格式方法。

METHOD_CRYPT

带有 2 个字符盐和 13 个字符哈希的传统方法。这是最弱的方法。

模块属性

Python 3.3 中的新功能。

methods

一个可用密码哈希算法列表，作为 crypt.METHOD_* 对象。此列表按最强到最弱排序。

模块函数

crypt_r 模块定义了以下函数

crypt(word, salt=None)

word 通常是一个用户在提示或图形界面中输入的密码。可选的 salt 是 mksalt() 返回的字符串、crypt.METHOD_* 的值之一（尽管并非所有平台都可用），或包含盐的完整加密密码，如此函数返回。如果未提供 salt，则将使用 methods 中可用的最强方法。

检查密码通常是通过将明文密码作为 word 和先前 crypt 调用的完整结果（应与此次调用的结果相同）传递来完成的。

盐（可以是随机生成的2或16位字符串，可能以$digit$开头表示方法），将用于扰动加密算法。盐中的字符必须是集合[./a-zA-Z0-9]中的字符，除了模数加密格式，其前缀为$digit$。

返回作为字符串的哈希密码，该字符串将由与盐相同的字母表中的字符组成。

由于一些crypt_r(3)扩展允许不同的值，盐的大小不同，建议在检查密码时使用完整的加密密码作为盐。

在Python 3.3中更改：除了字符串外，还接受crypt.METHOD_*的值作为盐。

mksalt(method=None, *, rounds=None)

返回指定方法的随机生成的盐。如果没有提供method，则使用methods中可用的最强方法。

返回值是一个字符串，适合作为crypt的盐参数传递。

rounds指定METHOD_SHA256、METHOD_SHA512和METHOD_BLOWFISH的轮数。对于METHOD_SHA256和METHOD_SHA512，它必须是介于1000和999_999_999之间的整数，默认值为5000。对于METHOD_BLOWFISH，它必须是介于16（2⁴）和2_147_483_648（2³¹）之间的2的幂，默认值为4096（2¹²）。

Python 3.3 中的新功能。

在Python 3.7中更改：添加了rounds参数。

示例

一个简单的示例，说明典型用法（需要常数时间比较操作来限制对时间攻击的暴露。《hmac.compare_digest()》适用于此目的）

import pwd
import crypt_r
import getpass
from hmac import compare_digest as compare_hash

def login():
    username = input('Python login: ')
    cryptedpasswd = pwd.getpwnam(username)[1]
    if cryptedpasswd:
        if cryptedpasswd == 'x' or cryptedpasswd == '*':
            raise ValueError('no support for shadow passwords')
        cleartext = getpass.getpass()
        return compare_hash(crypt_r.crypt(cleartext, cryptedpasswd), cryptedpasswd)
    else:
        return True

使用最强可用方法生成密码的哈希并检查其与原始密码是否匹配

import crypt_r
from hmac import compare_digest as compare_hash

hashed = crypt_r.crypt(plaintext)
if not compare_hash(hashed, crypt_r.crypt(plaintext, hashed)):
    raise ValueError("hashed version doesn't validate against original")

变更日志