تثبيت واستخدام تطبيق التوقيع بتوكن USB

ثبّت تطبيق التوقيع على الجهاز الذي يحمل توكن Egypt Trust، الصق مفتاح التوقيع الخاص بالمؤسسة، وقّع مستندات جاهزة للتوقيع من فاتورة مع إبقاء PIN على الجهاز فقط.

توقيع USB فاتورة إلكترونيةEgypt Trustتطبيق التوقيع المحليlocalhost:7733فاتورة signer

تشترط المصلحة توقيع CAdES بشهادة الجهاز. المفتاح الخاص لا يغادر توكن USB. لذلك يستخدم فاتورة توقيعاً محلياً على الجهاز الذي يحمل التوكن.

ماذا يفعل التطبيق

• يسحب مستندات بحالة READY_TO_SIGN
• يوقّع بالتوكن
• يعيد الحمولة الموقّعة فتصبح الحالة SIGNED
• ثم تضغط إرسال للمصلحة داخل فاتورة

التثبيت

• أول مرة: اختصار سطح المكتب من حزمة التوقيع
• يومياً: شغّل الاختصار واترك نافذة الطرفية مفتوحة
• الواجهة: `http://localhost:7733`
• الإعدادات: `http://localhost:7733/settings`
• المتطلبات: Node.js LTS وبناء `CadesSigner` عند البناء من المصدر

إعداد ملف تعريف

• رابط موقع فاتورة (أصل الموقع)
• مفتاح التوقيع من إعدادات فاتورة
• بصمة الشهادة / اسم البطاقة (Egypt Trust / ePass2003)
• PIN التوكن (على الجهاز فقط — ليس في سحابة فاتورة)

المنفذ الافتراضي 7733.

البروتوكول

المصادقة: `Authorization: Bearer {signerApiKey}` ثم:

• `GET /api/e-invoicing/signer/pending`
• `POST /api/e-invoicing/signer/signed` مع `{ results: [{ id, signedPayload, error? }] }`

التوقيع من واجهة فاتورة

على مستند جاهز للتوقيع اضغط توقيع محلي. يفتح `http://localhost:7733/?oneshot=1`. بعد الانتهاء حدّث الصفحة — يفترض أن تصبح الحالة SIGNED.

تشغيل يومي

• ثبّت التطبيق فقط على أجهزة تحمل التوكن فعلياً
• درّب موقّعاً احتياطياً
• بعد تدوير المفتاح حدّث كل الأجهزة وإلا يتوقف التوقيع
• لا تشارك PIN في المحادثات أو التذاكر