دليل بوابة توقيع المستندات الإلكترونية

بوابة توقيع المستندات الإلكترونية يتم توزيع واجهة برمجة التطبيقات كصورة عامل إرساء ويتم تثبيتها على مقر العميل. يقوم بالإجراءات التالية:

  • يرسل التطبيق مستند 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

تعليمات التثبيت

  1. قم بفك ضغط إصدار بوابة توقيع المستند
  2. افتح ملفات 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
  3. افتح ملف دوكر
    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"]
  4. تثبيت محرك دوكر على جهازك. بعد ذلك، أنشئ صورة عامل الإرساء باستخدام الأمر التالي:
    بناء عامل ميناء -t document_signing_gateway:1.0.0 .
  5. قم بتشغيل الحاوية باستخدام الأمر التالي. كما أنه يخلق حجمًا لـ ملف سجل واجهة برمجة تطبيقات بوابة توقيع عامل ميناء وتعيين المنفذ أيضًا.
    تشغيل عامل الميناء -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
  6. قم بالوصول إلى واجهة API لبوابة توقيع المستندات باستخدام تطبيق أو أداة POSTMAN.

اشترك في النشرة الإخبارية SSL.com

لا تفوت المقالات والتحديثات الجديدة من SSL.com

ابق على اطلاع وآمن

SSL.com هي شركة عالمية رائدة في مجال الأمن السيبراني، PKI والشهادات الرقمية. قم بالتسجيل لتلقي آخر أخبار الصناعة والنصائح وإعلانات المنتجات من SSL.com.

نحن نحب ملاحظاتك

شارك في استبياننا وأخبرنا بأفكارك حول عملية الشراء الأخيرة.