واجهة برمجة التوقيع (API)
تطبيقاتك وتطبيقاتنا
توقّع ملفات PDF والملفات والبيانات، وتتحقق من التوقيعات والشهادات، وتضيف الأختام الزمنية، وتحفظ إعدادات الثقة والهوية لكل عميل، وتسجّل كل عملية.
القدرات
ستة مكوّنات تعمل معًا في طبقة تنسيق واحدة
يضم SignLayer خدمات وحزم تطوير يؤدي كلٌّ منها دورًا محددًا، فتختار منها ما يناسبك، وتتصل جميعها بواجهة برمجة التوقيع.
خدمة الفاتورة الإلكترونية
نظام ERP أو المحاسبة لديك
تبني الفاتورة بالصيغة القياسية، وتختمها عبر واجهة التوقيع وHSM، وترسل المستندات وتجلبها وتلغيها وترفضها لدى مصلحة الضرائب.
بوابة HSM
واجهة التوقيع
تتصل بوحدة أمان الأجهزة (HSM) عبر معيار PKCS#11 وتوقّع بختم الشركة عند الطلب، دون أن يغادر المفتاح الوحدة.
تطبيق Trpass
الموقّعون من المتصفح
تطبيق لأنظمة Windows وmacOS وLinux يتيح للمواقع المعتمدة استخدام البطاقة الذكية أو مفتاح التوقيع (USB Token)، ويبقى الرقم السري (PIN) والمفتاح على جهاز المستخدم.
حزمة المتصفح
مطورو الويب
مكتبة JavaScript تربط صفحتك بتطبيق سطح المكتب وواجهة التوقيع للتوقيع بالبطاقة الذكية.
حزم iOS وAndroid للتوقيع عن بُعد
مطورو تطبيقات الهاتف
توقّع ملفات PDF بشهادة ITIDA عن بُعد ورمز تحقق لمرة واحدة (OTP)، مع توقيع مرئي وهوية بصرية لكل علامة تجارية.
القدرات
ماذا توقّع، وبأي قناة
صيغ التوقيع المتاحة حاليًا في كل قناة.
| البطاقة الذكية (المتصفح) | الهاتف (عن بُعد) | ختم الشركة (HSM) | |
|---|---|---|---|
| توقيع PDF بصيغة PAdES مع توقيع مرئي | مدعوم | مدعوم | مدعوم |
| توقيع بيانات أو ملف (CAdES-B-B أو CMS) | مدعوم | غير متاح | مدعوم |
| توقيع مجرد (raw) | مدعوم | غير متاح | مدعوم |
| فاتورة إلكترونية (CAdES منفصل) | غير متاح | غير متاح | مدعوم |
| ختم زمني أثناء التوقيع | مدعوم | غير متاح | مدعوم |
مدعوم غير متاح
API
عمليات واجهة التوقيع
العمليات العامة لواجهة برمجة التوقيع مصنّفة حسب المهمة. التفاصيل الكاملة في مرجع واجهة API (بالإنجليزية).
التوقيع
POST/sign/data | Sign data or a file as CMS, CAdES-B-B or a bare signature, attached or detached. One call with the HSM; the first of two calls with a token. | البطاقةختم HSM |
POST/sign/finish | Complete a token signature started with /sign/data. The certificate is checked again here. | البطاقة |
POST/documents/pdf/prepare | Prepare a PDF for signing with a token: signature field, visible stamp, reason and location. Returns what the token must sign. | البطاقة |
POST/documents/pdf/finish | Embed the token signature into the prepared PDF and return the signed PDF (PAdES). | البطاقة |
POST/documents/pdf/signWithHsm | Sign a PDF in one call with the company seal held in the HSM, with an optional visible stamp. | ختم HSM |
POST/remote/pdf/embed | Embed a signature produced on the phone (remote certificate) into a PDF prepared by the mobile SDK. | الهاتف |
POST/raw/file/prepare | Prepare any file for a detached or attached CMS signature with a token. Legacy flow; prefer /sign/data. | البطاقة |
POST/raw/file/finish | Complete a file signature started with /raw/file/prepare. Legacy flow; prefer /sign/finish. | البطاقة |
التحقق
POST/verify | Verify a CMS, CAdES or bare signature, attached or detached. The format can be detected automatically. | الكل |
POST/documents/pdf/validate | Validate every signature in a PDF: integrity, certificate chain, expiry, and revocation through OCSP and CRL. | الكل |
POST/remote/pdf/validate | Check a remotely signed PDF for integrity and later modifications. Use /documents/pdf/validate for full trust checks. | الهاتف |
POST/documents/office/validate | Validate the signatures in an Office document. | الكل |
POST/raw/file/validate | Validate a file against its detached or attached CMS signature (.p7s). | الكل |
POST/raw/text/validate | Validate a signature over a piece of text with the signer certificate. | الكل |
POST/tools/certificate/validate | Validate a certificate: chain to a trusted CA, validity period and revocation status. | الكل |
الختم الزمني
POST/documents/pdf/timestamp | Add a trusted document timestamp to a PDF from your RFC 3161 Timestamp Authority. | الكل |
POST/raw/file/timestamp | Get an RFC 3161 timestamp token for any file. | الكل |
POST/raw/uuid/timestamp | Get a timestamp token bound to an identifier. | الكل |
رموز التحقق
GET/verify/code/:code | Look up a verification code. Returns the signed document's summary and its signers, oldest first; only the last signer carries a certificate status. Unknown, invalid and expired codes all return the same 404. | الكل |
GET/verify/code/:code/printable | Download the unsigned printable copy (PDF), generated on each request from the stored signed original. 404 when no original was stored. | الكل |
GET/verify/code/:code/signed | Download the signed original (PDF). 404 unless original downloads are enabled for your server and the original was stored. | الكل |
الحالة
GET/ | Health check: service status and uptime. | الكل |
الفاتورة الإلكترونية
عمليات خدمة الفاتورة الإلكترونية
لربط أنظمة ERP والمحاسبة بمصلحة الضرائب المصرية.
POST/invoice/sign | Sign invoices with the company seal. You submit them to ETA yourself. |
POST/invoice/submit | Sign and submit up to 100 documents to ETA in one call. |
POST/invoice/validate | Check the signature on a document you hold. |
GET/invoice/:uuid | Fetch a submitted document from ETA. |
GET/invoice/:uuid/details | Fetch document details and validation results from ETA. |
GET/invoice/recent | List recent documents. |
PUT/invoice/:uuid/cancel | Cancel an issued document. |
PUT/invoice/:uuid/reject | Reject a received document. |
القدرات
صُممت لتسهّل عمل فرق التشغيل
- إعدادات لكل عميل
- حزمة الثقة وجهة الختم الزمني واتصال HSM والهوية البصرية وسياسة التحقق لكل عميل، مع قيم افتراضية آمنة.
- فحوص الحالة
- نقطة فحص لموازِنات الأحمال، وفحص للإعدادات يتأكد من إمكانية الوصول إلى HSM وجهة الختم الزمني.
- إحصاءات الاستخدام
- أعداد عمليات التوقيع والتحقق والختم الزمني لكل عميل ونوع ويوم، للتقارير والفوترة.
- سجل التدقيق
- تُسجَّل كل عملية مع العميل والنوع والنتيجة والوقت.
القدرات
خيارات التعاقد
- ترخيص داخل مقر مؤسستك
- التثبيت على خوادم Ubuntu 20.04+ أو عائلة RHEL 8+ بمعالجات x86-64 أو arm64. الحد الأدنى نواتا معالجة و4 جيجابايت من الذاكرة، والترخيص لكل خادم.
- خدمة سحابية مُدارة
- استخدم واجهة التوقيع المستضافة لدى SignLayer بحساب مستقل لكل عميل، دون أن تدير أي خوادم.
- بعلامتك التجارية
- علامتك التجارية على تطبيقات الهاتف والحزم، بتقنية SignLayer.
- هجين
- شغّل بوابة HSM بجوار وحدة HSM في مركز بياناتك، وبقية المكوّنات حيث يناسبك.