PyCryptodome

PyCryptodome è un pacchetto Python autonomo di primitive crittografiche di basso livello: un solo pip install, nessuna libreria di sistema, e un'API ampia e coerente da AES e RSA fino a HPKE, KangarooTwelve e ML-DSA post-quantistico.

Supporta Python 3.9 e versioni successive, e PyPy.

Si installa con::

pip install pycryptodome

Tutti i moduli sono installati nel pacchetto 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)         # viene generato un nonce casuale
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)  # solleva ValueError se manomesso

.. note:: Fino alla versione 3.x, la libreria era distribuita anche come progetto pycryptodomex, installato nel pacchetto Cryptodome. A partire dalla versione 4.0, pycryptodomex non viene più distribuito e Crypto è l'unico nome di pacchetto. Per migrare, sostituisci Cryptodome con Crypto nei tuoi import.

Perché PyCryptodome

Autonomo. Nessuna dipendenza a runtime e nessuna libreria di sistema: tutto il codice C è incluso nel pacchetto, quindi non c'è nient'altro da installare, aggiornare o mantenere sincronizzato. La compilazione dai sorgenti richiede solo un compilatore C. Sono disponibili wheel binarie per Linux, macOS e Windows, su x86 e ARM, per CPython e PyPy.
Ampio. Algoritmi mainstream e specializzati dietro un'unica API coerente, inclusi molti difficili da trovare altrove in Python: modalità SIV e OCB, AES key wrap (KW, KWP), HPKE, KMAC, TupleHash, TurboSHAKE, KangarooTwelve, Ed448 e X448, ML-DSA, ML-KEM e la condivisione di segreti di Shamir.
Facile da usare correttamente. La cifratura autenticata e la verifica sono una singola chiamata, nonce e IV vengono generati per te, la casualità proviene direttamente dal sistema operativo, e le chiavi vengono importate ed esportate nei formati standard (PEM, DER, PKCS#8, OpenSSH).
Attento ai canali laterali. L'aritmetica su interi grandi per le chiavi private viene eseguita in tempo costante, in C. La decifratura RSA è cieca (blinded), e le moltiplicazioni scalari sulle curve ellittiche sono cieche e usano coordinate randomizzate.
Veloce dove conta. AES-NI, CLMUL, le estensioni SHA, AVX2 e BMI2/ADX vengono usati quando la CPU li supporta, selezionati a runtime: la stessa wheel funziona ovunque, a piena velocità su hardware recente.
Ben testato. Verificato rispetto ai test vector NIST e Wycheproof, su Linux, macOS e Windows, x86 e ARM, CPython e PyPy.
Licenza permissiva. BSD 2-Clause, e pubblico dominio per il codice più vecchio.

Per l'elenco completo degli algoritmi e dei formati, consulta la pagina delle funzionalità. Per tutto il resto, consulta la homepage.

Per problemi di sicurezza, invia un'email a [email protected].

Tutto il codice può essere scaricato da GitHub_.

.. _homepage: https://www.pycryptodome.org .. _pagina delle funzionalità: https://www.pycryptodome.org/src/features .. _GitHub: https://github.com/Legrandin/pycryptodome

pycryptodome

Più Popolari

PyCryptodome

Perché PyCryptodome