.. image:: https://github.com/Legrandin/pycryptodome/workflows/Integration%20test/badge.svg :target: https://github.com/Legrandin/pycryptodome/actions

.. image:: https://badge.fury.io/py/pycryptodome.svg :target: https://pypi.org/project/pycryptodome

PyCryptodome

PyCryptodome — это самодостаточный Python-пакет низкоуровневых криптографических примитивов: один pip install, никаких системных библиотек и широкий, согласованный API от AES и RSA до HPKE, KangarooTwelve и постквантового ML-DSA.

Поддерживает Python 3.9 и новее, а также PyPy.

Установка::

pip install pycryptodome

Все модули устанавливаются в пакет Crypto.

.. code-block:: python

from Crypto.Cipher import AES
from Crypto.Random import get_random_bytes

key = get_random_bytes(32)
cipher = AES.new(key, AES.MODE_GCM)         # a random nonce is generated
ciphertext, tag = cipher.encrypt_and_digest(b"attack at dawn")

receiver = AES.new(key, AES.MODE_GCM, nonce=cipher.nonce)
plaintext = receiver.decrypt_and_verify(ciphertext, tag)  # raises ValueError if tampered

.. note:: До версии 3.x библиотека также выпускалась как проект pycryptodomex, устанавливаемый в пакет Cryptodome. Начиная с версии 4.0 pycryptodomex больше не выпускается, и Crypto — единственное имя пакета. Для миграции замените Cryptodome на Crypto в ваших импортах.

Почему PyCryptodome

• Самодостаточность. Никаких зависимостей времени выполнения и системных библиотек: весь C-код поставляется вместе с пакетом, поэтому больше ничего не нужно устанавливать, патчить или синхронизировать. Для сборки из исходников нужен только C-компилятор. Бинарные wheel-пакеты доступны для Linux, macOS и Windows, на x86 и ARM, для CPython и PyPy.
• Широта. Основные и специализированные алгоритмы за единым согласованным API, включая многие, которые трудно найти в других местах в Python: режимы SIV и OCB, обёртка ключей AES (KW, KWP), HPKE, KMAC, TupleHash, TurboSHAKE, KangarooTwelve, Ed448 и X448, ML-DSA и разделение секрета Шамира.
• Простота правильного использования. Аутентифицированное шифрование и проверка — это один вызов, nonce и IV генерируются за вас, случайность берётся напрямую из операционной системы, а ключи импортируются и экспортируются в стандартных форматах (PEM, DER, PKCS#8, OpenSSH).
• Учёт побочных каналов. Арифметика больших целых чисел на приватных ключах выполняется за постоянное время, на C. Расшифровка RSA использует ослепление, а скалярные умножения на эллиптических кривых ослепляются и используют рандомизированные координаты.
• Быстрота там, где это важно. AES-NI, CLMUL, расширения SHA, AVX2 и BMI2/ADX используются, когда они есть в процессоре, с выбором во время выполнения: один и тот же wheel-пакет работает везде, на полной скорости на современном оборудовании.
• Хорошая тестовая проверка. Проверено на тестовых векторах NIST и Wycheproof, на Linux, macOS и Windows, x86 и ARM, CPython и PyPy.
• Разрешительная лицензия. BSD 2-Clause, а для самого старого кода — общественное достояние.

Возможности

• AES, RSA (с OAEP и PSS), DSA

• Режимы аутентифицированного шифрования (GCM, CCM, EAX, SIV, OCB, KW, KWP)

• Гибридное шифрование с открытым ключом (HPKE)

• Криптография на эллиптических кривых (кривые NIST P; Ed25519, Ed448, Curve25519, Curve448)

• Постквантовые подписи: ML-DSA и HashML-DSA (FIPS 204), включая external mu

• Компактный API (атрибуты nonce и iv для шифров, автоматическая генерация случайных nonce и IV, упрощённый режим шифра CTR и многое другое)

• Хеш-алгоритмы SHA-2, включая усечённые SHA-512/224 и SHA-512/256 (FIPS 180-4)

• HMAC и CMAC

• Хеш-алгоритмы SHA-3 (FIPS 202) и производные функции (NIST SP-800 185):

  • XOF SHAKE128 и SHAKE256
  • XOF cSHAKE128 и cSHAKE256
  • KMAC128 и KMAC256
  • TupleHash128 и TupleHash256

• KangarooTwelve, TurboSHAKE128 и TurboSHAKE256 XOF

• Хеш-алгоритмы BLAKE2b и BLAKE2s

• Потоковые шифры Salsa20 и ChaCha20/XChaCha20

• MAC Poly1305

• Аутентифицированные шифры ChaCha20-Poly1305 и XChaCha20-Poly1305

• Функции вывода ключа scrypt, bcrypt, HKDF и NIST SP 800 108r1 Counter Mode

• Детерминированные (EC)DSA и EdDSA

• Контейнеры ключей PKCS#8, защищённые паролем

• Схема разделения секрета Шамира

• Случайные числа, получаемые напрямую из операционной системы

• Простая установка, в том числе на Windows

• Генерация ключей RSA и DSA, в значительной степени основанная на FIPS 186-4

Для получения дополнительной информации см. homepage_.

По вопросам безопасности, пожалуйста, отправьте письмо на [email protected].

Весь код можно скачать с GitHub_.

.. _homepage: https://www.pycryptodome.org .. _GitHub: https://github.com/Legrandin/pycryptodome