إضافة المتصفح
ملحقات Chrome وFirefox (التثبيت اليدوي) عبر Native Messaging - لا توجد مساحة تخزين لبيانات الاعتماد السحابية.
يتواصل ملحق متصفح QubKey مع تطبيق سطح المكتب عبر قناة آمنة محلية (المراسلة الأصلية). التدفق هو: **الامتداد → المضيف الأصلي → تطبيق QubKey → قبو مفتوح **.
لا يوجد خادم سحابي ولا حساب عبر الإنترنت - يعمل الامتداد فقط عندما يكون تطبيق سطح المكتب قيد التشغيل ويكون المخزن مفتوحًا.
المتصفح
وضع حماية WebExtension — معزول عن العمليات الأصلية
ملحق QubKey
واجهة المستخدم المنبثقة
(يبحث)
البرنامج النصي للمحتوى
(الملء التلقائي)
عامل الخلفية
(الرسائل الأصلية)
qubkey-host (مضيف المراسلة الأصلي)
- التحقق من صحة أصل الامتداد
- التبديلات إلى QubKey Desktop عبر IPC
سطح المكتب QubKey
- قبو مقفلة في الذاكرة
- يتعامل مع الطلبات (الحصول على، الملء التلقائي، إنشاء)
تثبيت
قبل أن تبدأ
المتطلبات الأساسية الشائعة: تثبيت تطبيق QubKey لسطح المكتب لنظام التشغيل macOS أو Windows، وتشغيله، وفتح المخزن. قم بتنزيل الملحقات للتنزيل لنظام التشغيل الخاص بك على صفحة الإصدار — إصدار macOS وWindows غير للتبديل. لا يتم توزيع الإضافات عبر سوق Chrome الإلكتروني أو الإضافات أو المتاجر العامة الأخرى.
- قم بتنزيل
passmanager-chrome-1.0.0.zipلمنصتك من /ar/browser-extensions - قم بزيارة الأرشيف إلى المجلد الثابت (
manifest.jsonفي تريجر) - حساب
chrome://extensions(أوedge://extensionsلـ Edge/Chromium) → كما وضع المطور → التحميل غير المعبأ - قم بتكوين المراسلة الأصلية (
com.passmanager.native.json) النسخ الرمز الامتداد في بيان المضيف - قم بإلغاء إلغاء قفل QubKey - يجب أن تمتلك الخيارات الازمة متصل
- قم بتنزيل
passmanager-firefox-1.0.0.xpiلمنصتك من /ar/browser-extensions - الاختبار المحلي: تسجيل الدخول
about:debugging→ هذا Firefox → تحميل الوظيفة المؤقتة → حددmanifest.json(مستخرج من ملف .xpi) - في **إصدار Firefox **، يتيح ما يتم ** رفض ملف .xpi غير الموقع ** — يتيح نشر AMO تثبيت بنقرة واحدة بمجرد توقيع الإصدار
- قم بتكوين المراسلة الأصلية لتصفح Firefox - راجع دليل المراسلة الأصلية (
%APPDATA%\Mozilla\NativeMessagingHosts\في نظام التشغيل Windows، والمجلدات المكافئة في نظام التشغيل macOS) - قم بإلغاء إلغاء إلغاء إلغاء إلغاء إلغاء قفل مفتاح QubKey → الإعدادات → الامتداد يجب أن يظهر متصل
بخلاف الآخر
استخدام متصفحات Chromium (Chrome وBrave وEdge وOpera) نفس الحدث .zip المستخرجة - قم بتحميل المجلد من chrome://extensions أو edge://extensions. Safari لا يحتوي على حزمة QubKey للتنوع على الموقع.
بنيان
التكنولوجيا الحديثة
المراسلة الأصلية: تجسس الامتدادات عبر stdin/stdout إلى شبكة محلية (المضيف الأصلي)، والتي تقوم بالرحيل لتطبيق QubKey.
- لا تنتقل البيانات عبر الإنترنت
- يبقى مخزن
.rkveyعلى القرص الخاص بك - الامتداد أبدًا لديه حق الوصول إلى كلمة المرور الرئيسية أو المفاتيح الأولية
- يحدد رمز JWT للجلسة (15 دقيقة) من نافذة الوصول
سمات
نموذج الأمان
| آلية | اكتب | الحماية |
|---|---|---|
Native Messaging | IPC | اتصال stdin/stdout المحلي — لم يتم فتح منفذ شبكة |
Session Token | JWT | الرمز المميز الموقّع بواسطة HMAC، تنتهي صلاحيته بعد 15 دقيقة من عدم النشاط — يحد من نافذة الوصول إلى الامتداد |
Permissions | Minimal | لا يوجد سجل أو ملفات تعريف الارتباط أو الوصول إلى علامات التبويب غير النشطة - الصفحة الحالية فقط |
Content Script | Isolated | يعمل في عالم معزول — منفصل عن JavaScript |
استكشاف الأخطاء وإصلاحها
"Cannot connect"
- تحقق من أن تطبيق سطح المكتب قيد التشغيل وأن المخزن مفتوح
- تحقق من حزمة الامتداد (macOS مقابل Windows)
- تحقق من بيان المراسلة الأصلية ومعرف الامتداد
- أعد تشغيل الامتداد (تعطيل/إعادة التمكين)
الدليل: صفحة ملحقات المتصفح
"Native host not found"
لم يتم تسجيل بيان المراسلة الأصلي (com.passmanager.native.json) أو أن معرف الامتداد غير صحيح. اتبع قسم المراسلة الأصلية في صفحة ملحقات المتصفح.
لم يتم الكشف عن الحقول
1. انقر بزر الماوس الأيمن → "املأ باستخدام QubKey" 2. تحقق من حفظ عنوان URL في الإدخال 3. لا يمكن الوصول إلى إطارات iFrames - التعبئة اليدوية 4. قم بتعطيل مديري كلمات المرور الآخرين مؤقتًا