secrets — Генерация криптографически стойких случайных чисел для управления секретами

Случайные числа

Модуль secrets предоставляет доступ к самому безопасному источнику случайных чисел, доступному в вашей операционной системе.

class secrets.SystemRandom

Класс для генерации случайных чисел с использованием источников высочайшего качества, предоставляемых операционной системой. Дополнительные сведения см. в random.SystemRandom.

secrets.choice(seq)

Возвращает случайно выбранный элемент из непустой последовательности.

secrets.randbelow(exclusive_upper_bound)

Возвращает случайное целое число в диапазоне [0, exclusive_upper_bound).

secrets.randbits(k)

Возвращает неотрицательное целое число, состоящее из k случайных битов.

Генерация токенов

Модуль secrets предоставляет функции для генерации безопасных токенов, подходящих для таких задач, как сброс пароля, создание URL-адресов, которые трудно угадать, и тому подобного.

secrets.token_bytes([nbytes=None])

Возвращает случайную строку байтов длиной nbytes байт. Если nbytes равно None или не указано, используется подходящее значение по умолчанию.

>>> token_bytes(16)
b'\xebr\x17D*t\xae\xd4\xe3S\xb6\xe2\xebP1\x8b'

secrets.token_hex([nbytes=None])

Возвращает случайную текстовую строку в шестнадцатеричном формате. Строка содержит nbytes случайных байт, каждый из которых преобразуется в две шестнадцатеричные цифры. Если nbytes равно None или не указано, используется подходящее значение по умолчанию.

>>> token_hex(16)
'f9bf78b9a18ce6d46a0cd2b0b86df9da'

secrets.token_urlsafe([nbytes=None])

Возвращает случайную текстовую строку, безопасную для URL и содержащую nbytes случайных байт. Текст кодируется в Base64, поэтому в среднем каждый байт преобразуется примерно в 1,3 символа. Если nbytes равно None или не указано, используется подходящее значение по умолчанию.

>>> token_urlsafe(16)
'Drmhze6EPcv0fN_81Bj-nA'

Другие функции

secrets.compare_digest(a, b)

Возвращает True, если строки или объекты, подобные bytes a и b равны, и False в противном случае. Для снижения риска атак по времени выполнения используется сравнение с постоянным временем выполнения. Дополнительные сведения см. в hmac.compare_digest().

Примеры и рекомендации

В этом разделе приведены примеры и рекомендации по использованию secrets для обеспечения базового уровня безопасности.

Сгенерируйте пароль из восьми буквенно-цифровых символов:

import string
import secrets
alphabet = string.ascii_letters + string.digits
password = ''.join(secrets.choice(alphabet) for i in range(8))

Сгенерируйте пароль из десяти буквенно-цифровых символов, содержащий как минимум одну строчную букву, одну заглавную букву и три цифры:

import string
import secrets
alphabet = string.ascii_letters + string.digits
while True:
    password = ''.join(secrets.choice(alphabet) for i in range(10))
    if (any(c.islower() for c in password)
            and any(c.isupper() for c in password)
            and sum(c.isdigit() for c in password) >= 3):
        break

Сгенерируйте парольную фразу в стиле XKCD:

import secrets
# On standard Linux systems, use a convenient dictionary file.
# Other platforms may need to provide their own word-list.
with open('/usr/share/dict/words') as f:
    words = [word.strip() for word in f]
    password = ' '.join(secrets.choice(words) for i in range(4))

Сгенерируйте временный URL-адрес, который трудно угадать и который содержит токен безопасности для приложений восстановления пароля:

import secrets
url = 'https://example.com/reset=' + secrets.token_urlsafe()