PyCryptodome

PyCryptodome は、低レベル暗号プリミティブを提供する自己完結型の Python パッケージです。pip install を一度実行するだけで、システムライブラリは不要であり、AES や RSA から HPKE、KangarooTwelve、耐量子 ML-DSA まで、幅広く一貫した API を提供します。

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 コンパイラのみが必要です。 Linux、macOS、Windows 向けのバイナリホイールが、x86 と ARM、CPython と PyPy 向けに提供されています。
幅広い。 主流のアルゴリズムから専門的なアルゴリズムまでを一貫した API の背後に揃えており、 Python の他の場所では見つけにくいものも多数含みます。SIV モードと OCB モード、 AES キーラップ (KW、KWP)、HPKE、KMAC、TupleHash、TurboSHAKE、KangarooTwelve、 Ed448 と X448、ML-DSA、ML-KEM、Shamir の秘密分散などです。
正しく使うのが簡単。 認証付き暗号化と検証は 1 回の呼び出しで行え、nonce と IV は自動的に生成され、乱数はオペレーティングシステムから直接取得され、鍵は標準形式 (PEM、DER、PKCS#8、OpenSSH) でインポートおよびエクスポートされます。
サイドチャネルを考慮。 秘密鍵に対する大きな整数演算は、C 言語で定数時間で実行されます。 RSA 復号はブラインディングされ、楕円曲線のスカラー乗算はブラインディングされ、ランダム化された座標を使用します。
重要な場面で高速。 CPU が対応していれば AES-NI、CLMUL、SHA 拡張命令、AVX2、BMI2/ADX が実行時に選択されて使用されます。同じホイールがどこでも動作し、最新のハードウェアでは最高速度で動作します。
十分にテスト済み。 NIST および Wycheproof のテストベクターに対して、 Linux、macOS、Windows、x86、ARM、CPython、PyPy で検証されています。
寛容なライセンス。 BSD 2-Clause ライセンスで、最も古いコードはパブリックドメインです。

アルゴリズムと形式の完全なリストについては、features page_ を参照してください。その他の情報については、homepage_ を参照してください。

セキュリティに関する問題については、[email protected] までメールをお送りください。

すべてのコードは GitHub_ からダウンロードできます。

.. _homepage: https://www.pycryptodome.org .. _features page: https://www.pycryptodome.org/src/features .. _GitHub: https://github.com/Legrandin/pycryptodome

pycryptodome

人気

PyCryptodome

PyCryptodome を選ぶ理由