آمن. خزّن. املأ تلقائيًا. — مدير كلمات مرور لأندرويد يضع الخصوصية أولًا، من إعداد Abdal Security Group.

يحتفظ Abdal LockBox ببيانات اعتمادك مشفّرة على جهازك، ويملأ نماذج تسجيل الدخول عبر إطار Android Autofill الرسمي، ويُنسخ خزنتك احتياطيًا بصيغة .ablbx المشفّرة القابلة للنقل — دون إرسال أسرار الخزنة إلى خادم سحابي خلفي.

🎯 لماذا أُنشئ هذا التطبيق؟

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

بُني Abdal LockBox لحل مشكلة عملية:

• 🏠 إبقاء بيانات الاعتماد على الجهاز تحت Master Password واحد — بلا مزامنة خزنة عن بُعد حسب التصميم
• ⚡ ملء سجلات الدخول بسرعة في التطبيقات والمتصفحات عبر Android Autofill
• 📦 نسخ احتياطي واستعادة بأمان باستخدام صيغة .ablbx المشفّرة المعيارية
• 🔑 استعادة الوصول عبر Recovery Key إذا نُسيت Master Password
• 💣 الحماية تحت الإكراه عبر Self-Destruct اختياري يمسح بيانات الخزنة المحلية بصمت

الهدف هو مدير كلمات مرور خفيف وموجّه للأمن يحترم الخصوصية ويتبع ممارسات هندسة أندرويد الحديثة (Jetpack Compose، Room، DataStore، التشفير المصادق عليه).

✨ الميزات والإمكانات

🗄️ الخزنة وبيانات الاعتماد

• إنشاء خزنة وفتحها باستخدام Master Password
• إضافة بيانات الاعتماد وتعديلها وحذفها: العنوان، اسم المستخدم، كلمة المرور، عنوان الموقع، حزمة التطبيق، ملاحظات إضافية
• مولّد كلمات مرور مدمج مع مؤشر القوة
• ألوان بطاقة ونص مخصصة للتنظيم البصري
• إخفاء كلمات المرور افتراضيًا (Settings)
• بحث، وتصفية (الكل / التطبيقات / المواقع / المستخدمة مؤخرًا)، وفرز في Vault
• عرض تفاصيل الاعتماد مع نسخ وفتح URL
• عناصر حديثة على لوحة Home
• مساعدة ودليل داخل التطبيق قابل للبحث (Home → Learn More)

📲 Android Autofill

• خدمة نظام AutofillService للتطبيقات والمتصفحات
• مفتاح Enable Autofill لكل اعتماد
• الإكمال التلقائي في التطبيقات / المتصفحات، طلب Master Password قبل الملء، عرض اقتراحات الملء
• تدفق تأكيد الحفظ عند اكتشاف سجلات دخول جديدة
• تعيين يدوي للحقول للتطبيقات بلا تلميحات إكمال تلقائي قياسية

🛡️ الأمن والجلسة

• قفل تلقائي بعد عدم النشاط (أبدًا، ١ / ٥ / ١٥ / ٣٠ دقيقة)
• تغيير Master Password
• توليد Recovery Key وتدويرها
• حماية من لقطات الشاشة وتسجيل الشاشة (FLAG_SECURE) عبر الشاشات والحوارات واللوحات
• Self-Destruct Password — مسح طارئ صامت عند إدخاله في شاشة الفتح
• android:allowBackup="false" — النسخ الاحتياطي السحابي لأندرويد معطّل لبيانات التطبيق

💾 النسخ الاحتياطي والترحيل

• Export Vault → ملف .ablbx مشفّر (محمي بعبارة مرور)
• Import Vault → استعادة على الجهاز نفسه أو جهاز جديد
• معرّف الصيغة الرسمي OID: 1.3.6.1.4.1.66033.1.2.2.1

🔒 لماذا Abdal LockBox جدير بالثقة وآمن؟

يتبع Abdal LockBox نموذج أمن محلي أولًا، دون اتصال أولًا:

Encryption & Cryptography

يستخدم Abdal LockBox نموذج مفاتيح متعدد الطبقات. لا تُخزَّن كلمات المرور والبيانات الوصفية بنص واضح على القرص أبدًا.

Key Hierarchy

flowchart TB
    MP[Master Password] -->|KDF| KEK[KEK — Key Encryption Key]
    RK[Recovery Key] -->|KDF| RKEK[Recovery KEK]
    KEK -->|AES-256-GCM wrap| DEK[DEK — Data Encryption Key]
    KEK -->|AES-256-GCM wrap| IK[Index Key]
    RKEK -->|AES-256-GCM wrap| DEK
    RKEK -->|AES-256-GCM wrap| IK
    DEK -->|AES-256-GCM| Items[Vault Items & Settings]
    IK -->|HMAC-SHA-256| Lookup[Domain / Package Lookup Hashes]

Primary KDF: Argon2id (memory 32,768 KiB · iterations 3 · parallelism 2 · 32-byte output)
Fallback KDF: PBKDF2-HMAC-SHA256 (600,000 iterations)
AEAD: AES-256-GCM (32-byte key · 12-byte nonce · 128-bit tag) via Google Tink / JCE

للاطلاع على بنية الأمن الكاملة، راجع Whitepaper.

🚀 كيفية الاستخدام

أول تشغيل

1. ثبّت Abdal LockBox.
2. أنشئ Master Password قوية (حد أدنى ٦ أحرف؛ يُنصح بشدة بطول أكبر).
3. احفظ Recovery Key دون اتصال في مكان آمن عند الطلب.

الاستخدام اليومي

إعداد Autofill

1. افتح Autofill وفعّل الإكمال التلقائي في التطبيق.
2. انتقل إلى Settings → Passwords & accounts → Autofill service في أندرويد (قد يختلف النص حسب الشركة المصنعة).
3. اختر Abdal LockBox.
4. ركّز على حقل تسجيل دخول في تطبيق أو متصفح آخر واختر الاعتماد المقترح.

نصائح النسخ الاحتياطي

• 💾 صدّر بانتظام واحفظ ملفات .ablbx في موقع آمن.
• 🔑 استخدم عبارة مرور تصدير قوية تختلف عن كلمات المرور اليومية قدر الإمكان.
• 🧾 احتفظ بـ Recovery Key منفصلة عن ملف النسخة الاحتياطية.

🧰 Technical Overview (For Developers)

Build toolchain

• 🐘 Gradle (wrapper): 9.3.1
• 🤖 Android Gradle Plugin (AGP): 9.1.1
• 🟣 Kotlin: 2.2.10
• ⚙️ KSP: 2.3.5
• ☕ Java compatibility (source/target): 11

Android SDK / API levels

• 🛠️ compileSdk: 36 (Android 16)
• 🎯 targetSdk: 36
• 📉 minSdk: 26 (Android 8.0)
• 📦 applicationId: com.abdal.lockbox · versionName: 1.65 (versionCode 165)

Platform APIs used

• 🔐 android.service.autofill.AutofillService — system autofill fill/save for apps and browsers (AbdalAutofillService).
• 🪟 WindowManager.LayoutParams.FLAG_SECURE — screenshot / screen-recording protection for activities, dialogs, and bottom sheets.
• 📦 Package visibility (<queries>) — discover installed launcher apps for the app-package picker (Android 11+).
• 🚫 android:allowBackup="false" — disables Android Auto Backup for app data.
• 🗄️ Room SQLite — local vault metadata and encrypted item storage (lockbox_vault.db).
• 💾 DataStore Preferences — auto-lock timing and Self-Destruct credential metadata.

Core libraries

• 🎨 Jetpack Compose — BOM 2024.09.00, Material 3, Navigation Compose 2.8.9, Activity Compose 1.10.1, Lifecycle 2.8.7.
• 🔐 Crypto: Google Tink Android 1.15.0 (AES-GCM) · Argon2kt 1.6.0 (Argon2id KDF).
• 🔄 Coroutines: kotlinx-coroutines 1.10.2.
• 🗄️ Persistence: Room 2.7.0 (KSP) · DataStore Preferences 1.1.7.
• 🌍 Serialization / networking helpers: Moshi 1.15.2, OkHttp 4.10.0, Retrofit converter-moshi 2.12.0.
• 🧪 Testing: JUnit 4.13.2, Robolectric , Roborazzi , Espresso .

Build commands

./gradlew assembleDebug
./gradlew assembleRelease
./gradlew clean assembleRelease -PenableMinify=true
./gradlew test

📚 Documentation

• Whitepaper
• ABLBX File Format Specification

📦 ABLBX Encrypted Vault Backup Format

ABLBX هي صيغة النسخ الاحتياطي المشفّرة للخزنة التي يستخدمها Abdal LockBox لتصدير واستيراد بيانات الخزنة بأمان.

• File extension: .ablbx
• Media type: application/vnd.abdalsecuritygroup.lockbox
• Recommended filename pattern: abdal-lockbox-backup-{yyyyMMdd-HHmmss}.ablbx

للتفاصيل التقنية الكاملة، راجع ABLBX File Format Specification.

🐛 الإبلاغ عن المشكلات

إذا واجهت أي مشكلات أو صعوبات في الإعداد، يُرجى التواصل عبر البريد الإلكتروني [email protected]. يمكنك أيضًا الإبلاغ عن المشكلات على GitLab أو GitHub.

❤️ التبرع

إذا وجدت هذا المشروع مفيدًا وترغب في دعم التطوير المستمر، يُرجى التفكير في التبرع:

• تبرّع هنا

🤵 المطوّر

صُنع بشغف بواسطة إبراهيم شفيعي (EbraSha)

• E-Mail: [email protected]
• Telegram: @ProfShafiei

📜 الترخيص

هذا المشروع مرخّص بموجب ترخيص AGPLv3. راجع LICENSE.

ملخص حقوقك والتزاماتك

• ✅ يجوز لك استخدام هذا البرنامج ودراسته وتعديله وإعادة توزيعه بموجب شروط AGPLv3.
• ✅ يجوز لك إنشاء أعمال مشتقة، بشرط الالتزام بمتطلبات الإسناد وإعادة التسمية أدناه.
• ⚠️ الاستخدام الشبكي يفعّل التزامات الإفصاح عن المصدر (AGPLv3 §13). إذا شغّلت نسخة معدّلة من هذا البرنامج كخدمة شبكية، فيجب عليك توفير الشيفرة المصدرية المعدّلة لمستخدميها.
• ⚠️ الأسماء "Abdal LockBox" و**"Abdal"** و**"EbraSha"** و**"Abdal Security Group"** و**"Nahaanbin CyberSecurity Company"** والشعارات المرتبطة بها هي علامات تجارية لـ إبراهيم شفيعي (EbraSha) وليست مشمولة بترخيص AGPLv3.
• ⚠️ يجب على النسخ المتفرّعة والمعدّلة إعادة التسمية إلى اسم غير مشابه بشكل مربك لعلامة المشروع، ولا يجوز إعادة استخدام العلامة الأصلية أو الشعارات أو الهوية البصرية.
• ⚠️ يجب الحفاظ على جميع إسنادات المؤلف وإشعارات حقوق النشر وشاشات "About" وخطوط الاعتماد والمعلومات التعريفية في أي نسخة معدّلة. الإزالة أو التعتيم انتهاك جوهري للترخيص.
• ⚠️ يجب أن تشير النسخ المعدّلة بوضوح إلى أنها معدّلة ويجب ألا تُقدَّم على أنها النسخة الرسمية.

للتفاصيل، راجع قسم Additional Terms في ملف LICENSE.

الترخيص التجاري / العلامات التجارية

للترخيص التجاري أو ترخيص العلامات التجارية أو الأذونات خارج نطاق AGPLv3، يُرجى التواصل مع:

• Author: Ebrahim Shafiei (EbraSha)
• Team: Abdal Security Group
• Company: Nahaanbin CyberSecurity Company
• Email: [email protected]
• Repository: https://github.com/ebrasha

الإبلاغ عن انتهاكات الترخيص

إذا اكتشفت تفرعًا أو توزيعًا أو استخدامًا تجاريًا ينتهك هذه الشروط (مثل إزالة الإسناد أو إعادة استخدام العلامة أو استخدام غير مصرّح به للعلامة التجارية)، يُرجى الإبلاغ عبر جهة الاتصال أعلاه.