crypt — Функция для проверки паролей Unix¶

Методы хэширования¶

Модуль crypt определяет список методов хэширования (не все методы доступны на всех платформах).:

crypt.METHOD_SHA512¶

Метод модульного криптографического формата с 16-символьной солью и 86-символьным хэшем, основанный на хэш-функции SHA512. Это самый надежный метод.

crypt.METHOD_SHA256¶

Еще один метод модульного формата шифрования с 16-символьной солью и 43-символьным хэшем, основанный на хэш-функции SHA-256.

crypt.METHOD_BLOWFISH¶

Еще один модульный метод шифрования в формате шифрования с 22-символьной солью и 31-символьным хэшем, основанный на шифре Blowfish.

Добавлено в версии 3.7.

crypt.METHOD_MD5¶

Еще один метод модульного криптографического формата с 8-символьной солью и 22-символьным хэшем, основанный на хэш-функции MD5.

crypt.METHOD_CRYPT¶

Традиционный метод с 2-символьной солью и 13-символьным хэшем. Это самый слабый метод.

Атрибуты модуля¶

crypt.methods¶

Список доступных алгоритмов хэширования паролей в виде объектов crypt.METHOD_*. Этот список отсортирован от самого надежного к самому слабому.

Функции модуля¶

Модуль crypt определяет следующие функции:

crypt.crypt(word, salt=None)¶

word обычно представляет собой пароль пользователя, введенный в командной строке или в графическом интерфейсе. Необязательный параметр salt представляет собой либо строку, возвращаемую из mksalt(), либо одно из значений crypt.METHOD_* (хотя не все они могут быть доступны на всех платформах), либо полный зашифрованный пароль, включая salt, возвращаемый этой функцией. Если соль не указана, будет использован самый надежный метод, доступный в methods.

Проверка пароля обычно выполняется путем передачи обычного текстового пароля в виде word и полных результатов предыдущего вызова crypt(), которые должны совпадать с результатами этого вызова.

salt (случайная строка из 2 или 16 символов, возможно, с префиксом $digit$ для указания метода), которая будет использоваться для изменения алгоритма шифрования. Символы в salt должны быть в наборе [./a-zA-Z0-9], за исключением формата Modular Crypt, который имеет префикс $digit$.

Возвращает хэшированный пароль в виде строки, которая будет состоять из символов того же алфавита, что и соль.

Поскольку несколько расширений crypt(3) допускают разные значения с разными размерами в salt, рекомендуется использовать полный зашифрованный пароль в качестве соли при проверке пароля.

Изменено в версии 3.3: Принимайте значения crypt.METHOD_* в дополнение к строкам для salt.

crypt.mksalt(method=None, *, rounds=None)¶

Возвращает случайно сгенерированную соль указанного метода. Если метод не указан, используется самый надежный метод, доступный в methods.

Возвращаемое значение представляет собой строку, подходящую для передачи в качестве аргумента salt в crypt().

раунды указывает количество раундов для METHOD_SHA256, METHOD_SHA512 и METHOD_BLOWFISH. Для METHOD_SHA256 и METHOD_SHA512 это должно быть целое число в диапазоне от 1000 до 999_999_999, значение по умолчанию равно 5000. Для METHOD_BLOWFISH значение должно быть в степени двойки от 16 (2⁴) до 2_147_483_648 (2³¹), по умолчанию используется 4096 (2¹²).

Добавлено в версии 3.3.

Изменено в версии 3.7: Добавлен параметр округления.

Примеры¶

Простой пример, иллюстрирующий типичное использование (операция сравнения с постоянным временем необходима для ограничения подверженности атакам по времени. hmac.compare_digest() подходит для этой цели):

import pwd
import crypt
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.crypt(cleartext, cryptedpasswd), cryptedpasswd)
    else:
        return True

Сгенерировать хэш пароля самым надежным из доступных методов и сравнить его с исходным:

import crypt
from hmac import compare_digest as compare_hash

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