saad_tools

مكتبة بايثون صغيرة للتشفير الموثّق وتخزين الأسرار في خزنة محمية بكلمة مرور.

تنبيه أمني مهم: التشفير يحمي البيانات والمفاتيح المخزنة، لكنه لا يستطيع منع نسخ كود بايثون الذي يجب توزيعه وتشغيله على جهاز المستخدم. إذا كان الهدف حماية منطق تجاري سري، فالحل الأقوى هو إبقاء المنطق على خادم API وعدم شحنه إلى العميل، أو استخدام خدمة إدارة أسرار/وحدة HSM. لا تضع كلمة مرور الخزنة داخل الكود أو مستودع Git.

التثبيت

pip install saad_tools

تشفير البيانات

from saad_tools import decrypt_text, encrypt_text, generate_key

key = generate_key()  # خزّنها في مدير أسرار، لا في المصدر
ciphertext = encrypt_text("رسالة سرية", key)
plaintext = decrypt_text(ciphertext, key)

التشفير المستخدم هو AES-256-GCM مع nonce عشوائي لكل عملية، لذلك يكتشف التعديل أو كلمة المرور/المفتاح الخاطئ.

خزنة الأسرار

from saad_tools import Vault

vault = Vault("~/.config/myapp/vault.json", "كلمة مرور طويلة وفريدة", create=True)
vault.set("database_password", "...secret...")
password = Vault("~/.config/myapp/vault.json", "كلمة مرور طويلة وفريدة").get("database_password")

الخزنة تستخدم scrypt لاشتقاق مفتاح من كلمة المرور، ثم AES-256-GCM لتشفير المحتوى. لا تُحفظ كلمة المرور في الملف. يحاول البرنامج جعل صلاحيات الملف 0600 على الأنظمة التي تدعم ذلك.

تطوير محلي

python -m pip install -e ".[test]"
pytest
python -m build

الحالة

الإصدار الحالي 0.1.0 تجريبي. قبل استخدامه في إنتاج حساس، راجع إدارة كلمات المرور، النسخ الاحتياطي، صلاحيات نظام الملفات، وسياسة تدوير المفاتيح. لا تحذف الخزنة الأصلية قبل اختبار النسخة الاحتياطية.

الترخيص

MIT