• بوابة توقيع المستندات الإلكترونية يتم توزيع واجهة برمجة التطبيقات كصورة عامل إرساء ويتم تثبيتها على مقر العميل. يقوم بالإجراءات التالية:
- يرسل التطبيق مستند PDF غير الموقع إلى API بوابة توقيع المستند
- يحسب تطبيق بوابة توقيع المستند تجزئة PDF ويرسلها إلى eSigner CSC API لتوقيع التجزئة
- يتم بعد ذلك تضمين التجزئة الموقعة داخل مستند PDF كجزء من عملية توقيع مستند PDF
- يتم وضع ختم زمني على وثيقة PDF الموقعة باستخدام SSL.com TSA
- يتم جلب الإلغاء المستند إلى CRL لسلسلة الشهادات وإدراجه داخل مستند PDF لتمكينه من القيمة الدائمة (LTV)
المتطلبات الأساسية
طلب:-
URL:- /v1/pdf/eseal مطلوب رمز وصول صالح للوصول إلى API. يمكن العثور على دليل حول كيفية استرداد رمز الوصول في هذه المقالة: توقيع المستندات عن بعد باستخدام eSigner CSC API{ "credential_id": "db1653b7-6135-4a10-809b-e29a25d3bb7b"، "page_number": 0، "signing_reason": ""، "sign_location": ""، "contact_Info": ""، "sig_field_position": { " x": 160, "y":245, "width":250, "height": 150 }, "hand_signature": " "، "بي دي إف": "" }
توضيح العلامات
- الاعتماد_المعرّف - معرف الاعتماد الإلزامي لشهادة الختم الإلكتروني. لمعرفة كيفية التعرف على معرف الاعتماد الخاص بشهادتك، يرجى الرجوع إلى هذا الدليل: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- رقم الصفحة - مطلوب فقط للتوقيعات المرئية. يبدأ بـ 0
- سبب_التوقيع – سبب التوقيع الاختياري
- التوقيع - موقع التوقيع الاختياري
- معلومات الاتصال - معلومات الاتصال الاختيارية
- sig_field_position - x، y، عرض وارتفاع موضع حقل التوقيع. إنه مطلوب فقط للتوقيعات المرئية
- hand_signature - صورة توقيع اليد بصيغة PNG مشفرة بـ Base64. إنه مطلوب فقط للتوقيعات المرئية ولإضافة توقيع اليد كجزء من مظهر التوقيع
- النسخة الإلكترونية pdf – مستند PDF مشفر Base64 للتوقيع
إجابة:-
{ "signed_pdf": "" }
- موقعة_pdf – وثيقة PDF ممكّنة بتشفير Base64 وتوقيع LTV
تعليمات التثبيت
- قم بفك ضغط إصدار بوابة توقيع المستند
- افتح ملفات application.properties وقم بالتغيير وفقًا لذلك
# لاختبار وضع الحماية، قم بتعيين CSR عنوان URL لـ https://cs-try.ssl.com وللإنتاج، قم بتعيينه على https://cs.ssl.com csc.url=https://cs-try.ssl.com # URL لـ SSL.com TSA tsa.url=http://ts.ssl.com # المنفذ في حاوية عامل الإرساء server.port=8081 # TLS إعدادات شهادة الخادم. يمكن للمرء استخدام شهادة موقعة ذاتيا أو خاصة PKI أو عامة PKI الشهادة server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: Secret server.ssl.key-store-password: Secret
-
افتح ملف دوكر
FROM Eclipse-temurin:17.0.9_9-jdk-jammy # المنفذ الذي سيتم تشغيل بوابة توقيع المستندات عليه. يجب أن يكون هذا هو نفسه كما في ملف application.properties EXPOSE 8081 WORKDIR /app COPY document_signing_gateway-1.0.0.jar /app/ COPY application.properties /app/ COPY server.jks /app/ COPY GoNotoKurrent.ttf /app/ ENTRYPOINT [" java"، "-Dspring.config.location=file:/app/application.properties"، "-jar"، "document_signing_gateway-1.0.0.jar"]
- تثبيت محرك دوكر على جهازك. بعد ذلك، أنشئ صورة عامل الإرساء باستخدام الأمر التالي:
بناء عامل ميناء -t document_signing_gateway:1.0.0 .
- قم بتشغيل الحاوية باستخدام الأمر التالي. كما أنه يخلق حجمًا لـ ملف سجل واجهة برمجة تطبيقات بوابة توقيع عامل ميناء وتعيين المنفذ أيضًا.
تشغيل عامل الميناء -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- قم بالوصول إلى واجهة API لبوابة توقيع المستندات باستخدام تطبيق أو أداة POSTMAN.