.. 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 واحد، دون مكتبات نظام، وواجهة برمجية واسعة ومتسقة من 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. تتوفر حزم ثنائية (wheels) لأنظمة Linux وmacOS وWindows، على x86 وARM، لـ CPython وPyPy.
• واسعة. خوارزميات سائدة ومتخصصة خلف واجهة برمجية واحدة متسقة، بما في ذلك العديد منها التي يصعب العثور عليها في مكان آخر في Python: أوضاع SIV وOCB، وتغليف مفاتيح AES (KW، KWP)، وHPKE، وKMAC، وTupleHash، وTurboSHAKE، وKangarooTwelve، وEd448 وX448، وML-DSA، وML-KEM، وتقاسم السر لشامير.
• سهلة الاستخدام بشكل صحيح. التشفير الموثق والتحقق هما استدعاء واحد، ويتم توليد nonces وIVs لك، والعشوائية تأتي مباشرة من نظام التشغيل، ويتم استيراد المفاتيح وتصديرها في الصيغ القياسية (PEM، DER، PKCS#8، OpenSSH).
• واعية بالقنوات الجانبية. تعمل حسابات الأعداد الصحيحة الكبيرة على المفاتيح الخاصة في زمن ثابت، بلغة C. فك تشفير RSA مُعمَّى (blinded)، وضربات العدد القياسي للمنحنيات الإهليلجية مُعمَّاة وتستخدم إحداثيات عشوائية.
• سريعة حيث يهم ذلك. تُستخدم 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