دليل أوامر eSigner DocSignTool

DocSignTool هي أداة سطر أوامر Java متعددة المنصات آمنة وموجهة نحو الخصوصية لتوقيع ملفات PDF عن بعد باستخدام التوقيع الإلكتروني شهادات توقيع المستندات. يتم إرسال تجزئات المستندات إلى SSL.com للتوقيع عليها حتى لا يتم إرسال المستند نفسه. يعد هذا مثاليًا عندما يلزم توقيع المستندات الحساسة، ولكن لا ينبغي إرسالها عبر السلك للتوقيع. يعد DocSignTool أيضًا مثاليًا للعمليات المجمعة الآلية للتوقيعات ذات الحجم الكبير أو التكامل في سير عمل المستندات الحالية.

تثبيت DocSignTool

لتثبيت الإصدار الحالي من DocSignTool ، ما عليك سوى تنزيل وفك ضغط الملف الصحيح لنظام التشغيل الخاص بك:

• Windows
• Linux و macOS

لاحظ أن تنزيل Windows يتضمن وقت تشغيل Java ، لكن إصدار Linux / macOS يتطلب تثبيت Java runtime على جهاز الكمبيوتر الخاص بك. إصدار Windows للأمر عبارة عن ملف دفعي (DocSignTool.bat) وإصدار Linux / macOS عبارة عن برنامج نصي شل (DocSignTool.sh).

نظرة عامة على استخدام DocSignTool

الاستخدام: DocSignTool [-hV] [COMMAND] [PARAMETERS]

خيارات:

• -h, --help: عرض رسالة المساعدة والخروج.
• -V, --version: عرض معلومات الإصدار والخروج.

الأوامر:

• get_credential_ids: إخراج قائمة معرفات اعتماد eSigner المرتبطة بمستخدم معين.
• credential_info: مفتاح الإخراج ومعلومات الشهادة المتعلقة بمعرف بيانات الاعتماد.
• sign: ملف PDF التوقيع والطابع الزمني.
• batch_sign: قم بتوقيع وختم ملفات PDF متعددة باستخدام OTP واحد.
• hash: احسب التجزئة مسبقًا للاستخدام لاحقًا مع batch_hash_sign أمر.
• batch_sign_hash: علامة التجزئة المحسوبة مسبقًا باستخدام hash أمر.

المعلمات:

• -access_token=<TOKEN>: أوث وصول الرمز.
• -contact_info=<CONTACT_INFO>: معلومات للتواصل.
• -credential_id=<CREDENTIAL_ID>: معرف الاعتماد لتوقيع الشهادة.
• -input_dir_path=<PATH>: دليل الإدخال لملفات PDF المراد توقيعها ، أو التي تم حسابها ، أو اختر الملفات غير الموقعة والتجزئة المقابلة للتوقيع.
• -input_file_path=<PATH>: مسار ملف PDF المراد توقيعه.
• -otp=<OTP>: قيمة OAuth OTP من تطبيق المصادقة.
• -output_dir_path=<PATH>: الدليل حيث سيتم كتابة ملف (ملفات) PDF الموقعة.
• -page_no=<PAGE_NUMBER>: صفحة من مستند PDF حيث سيظهر التوقيع المرئي.
• -password=<PASSWORD>: كلمة مرور حساب SSL.com.
• -sig_field_position=<X, Y, WIDTH, HEIGHT>: موقع التوقيع المرئي على PDF.
• -signing_location=<SIGNING_LOCATION>: الموقع حيث تم توقيع الوثيقة.
• signing_reason=<SIGNING_REASON>: سبب التوقيع.
• -totp_secret=<TOTP_SECRET>: أوث سر TOTP
• -username=<USERNAME>: اسم مستخدم حساب SSL.com

أوامر DocSignTool

get_credential_ids

قم بإخراج قائمة معرفات اعتماد eSigner المرتبطة بمستخدم معين. المعلمات -username و -password مطلوبة.

الاستخدام: DocSignTool [-hV] get_credential_ids -username=<USERNAME> -password=<PASSWORD>

على سبيل المثال:

DocSignTool get_credential_ids -username=john.doe@example.com -password="P0z9@lxo41"
Credential ID(s):
- fe537ace-e132-52a9-c2e7-egcd2ac3f1e6

الدخول DocSignTool get_credential_ids بدون المعلمات المطلوبة سيعرض معلومات الاستخدام للأمر.

بيانات الاعتماد

مفتاح الإخراج ومعلومات الشهادة المتعلقة بمعرف بيانات الاعتماد. المعلمات -credential_id, -usernameو -password مطلوبة.

الاستخدام: DocSignTool [-hV] credential_info -credential_id=<CREDENTIAL_ID> -username=<USERNAME> -password=<PASSWORD>

على سبيل المثال:

DocSignTool credential_info -credential_id = fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -username=john.doe@example.com -password = "P0z9 @ lxo41" معلومات موضوع شهادة التوقيع: - العنوان DN: CN = JOHN DOE، O = SSL Corp ، L = Houston، ST = Texas، C = US - انتهاء صلاحية الشهادة: السبت 11 فبراير 14:52:59 EST 2023 - المُصدر DN: CN = SSL.com شهادة العميل المتوسطة CA RSA R2، O = SSL Corp، L = Houston ، ST = تكساس ، C = الولايات المتحدة

الدخول DocSignTool credential_info بدون المعلمات المطلوبة سيعرض معلومات الاستخدام للأمر.

إشارة

توقيع وملف PDF الطابع الزمني. المعلمات -username, -passwordو -input_file_path مطلوبة. -credential_id مطلوب فقط للمستخدمين الذين لديهم أكثر من شهادة توقيع وثيقة eSigner. -output_dir_path, -signing_location, -signing-reason, -contact_info,  -sig_field_position, -page_noو -totp_secret اختيارية.

الاستخدام: DocSignTool sign [-hV] [-credential_id=<CREDENTIAL_ID>] -username=<USERNAME> -password=<PASSWORD> -input_file_path=<PATH> [-output_dir_path=<PATH>] [-signing_location=<SIGNING_LOCATION>] [-signing_reason=<SIGNING_REASON>] [-contact_info=<CONTACT_INFO>] [-sig_field_position=<X, Y, WIDTH, HEIGHT>][-page_no=<PAGE_NUMBER>] [-totp_secret=<TOTP_SECRET>]

معلمات اختيارية:

• If -credential_id تم حذفه ولدى المستخدم شهادة توقيع وثيقة eSigner واحدة فقط ، وسوف يقوم DocSignTool افتراضيًا بذلك. إذا كان لدى المستخدم أكثر من شهادة توقيع وثيقة واحدة ، فإن هذه المعلمة إلزامية.
• If -output_dir_path الملف المحدد في -input_file_path سيتم الكتابة فوق الملف الموقع. سيطالبك DocSignTool المستخدم قبل الكتابة فوق الملف.
• If -signing_location موجود ، سيتم إضافة الموقع المحدد إلى التوقيع الرقمي.
• If -signing_reason موجود ، سيتم إضافة سبب التوقيع المحدد إلى التوقيع الرقمي.
• If -contact_info موجود ، سيتم إضافة النص المحدد إلى التوقيع الرقمي. على الرغم من تضمينها مع التوقيع ، لن يتم تضمين هذه المعلومات في التعليق التوضيحي للتوقيع المرئي (إن وجد).
• If -sig_field_position موجود ، ستتم إضافة تعليق توضيحي مرئي إلى المستند على الصفحة المحددة بواسطة -page_no. يجب تقديم الموقع والتوقيع بالتنسيق "x, y, width, height".
• -page_no مطلوب فقط عند إنشاء توقيع مرئي باستخدام -sig_field_position ويحدد صفحة المستند التي سيظهر عليها التعليق التوضيحي للتوقيع المرئي.
• If -totp_secret موجود ، سيقوم DocSignTool بحساب OTP المستند إلى الوقت للتوقيع ، مما يسمح بالاستخدام الآلي للأداة. في حالة عدم وجود هذه المعلمة ، سيُطلب من المستخدم إدخال كلمة المرور لمرة واحدة يدويًا.

أمثلة:

الإدخال اليدوي لمرة واحدة مع التوقيع المرئي:

علامة DocSignTool -credential_id = fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -username=john.doe@example.com -password = "P0z9 @ lxo41" -output_dir_path = موقع -input_file_path = test.pdf -sig_file_path = test.pdf -sig_file_path = test.pdf 100، 200 "-page_no = 150 -signing_location =" هيوستن ، تكساس "-signing_reason =" الموافقة على المستند "-contact_info ="support@ssl.com"أدخل كلمة المرور لمرة واحدة - اضغط على إدخال للمتابعة: 884646 تم توقيع PDF بنجاح: إخراج \ test.pdf

إنشاء آلي لمرة واحدة ، بدون توقيع مرئي:

DocSignTool sign -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -username=john.doe@example.com -password="P0z9@lxo41" -output_dir_path=signed -input_file_path=test.pdf -totp_secret=ii5gVvZ9G+WkxB3FauAnoL/z14AXSMistcE0jZMWWNSjQDlql2kt2D6Z+l8=
PDF signed successfully: output\test.pdf

الدخول DocSignTool sign بدون المعلمات المطلوبة سيعرض معلومات الاستخدام للأمر.

دفعة_توقيع

قم بتوقيع وطابع زمني يصل إلى 100 ملف PDF باستخدام OTP واحد. المعلمات -username, -passwordو -input_dir_path مطلوبة. -credential_id مطلوب فقط للمستخدمين الذين لديهم أكثر من شهادة توقيع وثيقة eSigner. -output_dir_path, -signing_location, -signing-reason, -contact_info,  -sig_field_position, -page_noو -totp_secret اختيارية.

الاستخدام: DocSignTool [-hV] batch_sign [-hV] [-credential_id=<CREDENTIAL_ID>] -username=<USERNAME> -password=<PASSWORD> -input_dir_path=<PATH> [-output_dir_path=<PATH>] [-signing_location=<SIGNING_LOCATION>] [-signing_reason=<SIGNING_REASON>] [-contact_info=<CONTACT_INFO>] [-sig_field_position=<X, Y, WIDTH, HEIGHT>][-page_no=<PAGE_NUMBER>] [-totp_secret=<TOTP_SECRET>]

معلمات اختيارية:

• If -credential_id تم حذفه ولدى المستخدم شهادة توقيع وثيقة eSigner واحدة فقط ، وسوف يقوم DocSignTool افتراضيًا بذلك. إذا كان لدى المستخدم أكثر من شهادة توقيع وثيقة واحدة ، فإن هذه المعلمة إلزامية.
• If -output_dir_path الملفات المحددة في -input_dir_path ستتم الكتابة فوق الملفات الموقعة. سيطالبك DocSignTool المستخدم قبل الكتابة فوق الملفات.
• If -signing_location موجود ، سيتم إضافة الموقع المحدد إلى التوقيعات الرقمية.
• If -signing_reason موجود ، سيتم إضافة سبب التوقيع المحدد إلى التوقيعات الرقمية.
• If -contact_info موجود ، سيتم إضافة النص المحدد إلى التوقيعات الرقمية. على الرغم من تضمينها مع التوقيع ، لن يتم تضمين هذه المعلومات في التعليقات التوضيحية للتوقيع المرئي (إن وجدت).
• If -sig_field_position موجود ، ستتم إضافة تعليق توضيحي مرئي إلى المستندات الموجودة على الصفحة المحددة بواسطة -page_no. يجب تقديم الموقع والتوقيع بالتنسيق "x, y, width, height".
• -page_no مطلوب فقط عند إنشاء توقيع مرئي باستخدام -sig_field_position ويحدد صفحة المستندات التي ستظهر عليها التعليقات التوضيحية للتوقيع المرئي.
• If -totp_secret موجود ، سيقوم DocSignTool بحساب OTP المستند إلى الوقت للتوقيع ، مما يسمح بالاستخدام الآلي للأداة. في حالة عدم وجود هذه المعلمة ، سيُطلب من المستخدم إدخال كلمة المرور لمرة واحدة يدويًا.

على سبيل المثال:

DocSignTool batch_sign -username=john.doe@example.com -password="P0z9@lxo41" -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -input_dir_path=input -output_dir_path=output -sig_field_position="100, 200, 150, 70" -page_no=1 -signing_location="Houston, Texas" -signing_reason="document approval" -contact_info="support@ssl.com"أدخل OTP - اضغط على Enter للمتابعة: 455145 تم تنفيذ أمر Batch Sign بنجاح. دليل الإخراج للملفات الموقعة: الإخراج

الدخول DocSignTool batch_sign بدون المعلمات المطلوبة سيعرض معلومات الاستخدام للأمر.

مزيج

قم بحساب التجزئة مسبقًا لاستخدامها لاحقًا مع batch_hash_sign أمر. المعلمات -access_token و -input_dir_path مطلوبة. -credential_id مطلوب فقط للمستخدمين الذين لديهم أكثر من شهادة توقيع وثيقة eSigner. -signing_location, -signing-reason, -contact_info,  -sig_field_positionو -page_no، اختيارية.

الاستخدام: DocSignTool [-hV] hash -access_token=<ACCESS_TOKEN> -input_dir_path=<PATH> [-signing_location=<SIGNING_LOCATION>] [-signing_reason=<SIGNING_REASON>] [-contact_info=<CONTACT_INFO>] [-sig_field_position=<X, Y, WIDTH, HEIGHT>][-page_no=<PAGE_NUMBER>]

معلمات اختيارية:

• If -program_name عند التوقيع على مثبّت MSI ، سيتم عرض القيمة في مربع حوار التأكيد كاسم البرنامج.
• If -signing_location موجود ، سيتم إضافة الموقع المحدد إلى التوقيعات الرقمية عند إنشائها.
• If -signing_reason موجود ، سيتم إضافة سبب التوقيع المحدد إلى التوقيعات الرقمية عند إنشائها.
• If -contact_info موجود ، سيتم إضافة النص المحدد إلى التوقيعات الرقمية عند إنشائها. على الرغم من تضمينها مع التوقيع ، لن يتم تضمين هذه المعلومات في التعليقات التوضيحية للتوقيع المرئي (إن وجدت).
• If -sig_field_position موجود ، ستتم إضافة تعليق توضيحي مرئي إلى المستندات الموجودة على الصفحة المحددة بواسطة -page_no عندما يتم إنشاء التواقيع. يجب تقديم الموقع والتوقيع بالتنسيق "x, y, width, height".
• -page_no مطلوب فقط عند إنشاء توقيع مرئي باستخدام -sig_field_position ويحدد صفحة المستندات التي ستظهر عليها التعليقات التوضيحية للتوقيع المرئي عند إنشائها.

على سبيل المثال:

DocSignTool hash -access_token=eyJraWQiOiJmUE1yYUdlbXVMWGUtcG9JWUtLem1CMEYwYXlFczktUEpiN29lTWFlY2I0IiwiYWxnIjoiUlMyNTYifQ.eyJpc3MiOiJTU 0wuY29tIEF1dGhlbnRpY2F0aW9uIFNlcnZpY2UiLCJleHAiOjE2MTQ4OTcxNDIsImlhdCI6MTYxNDg5MzU0MiwianRpIjoiZmI2OTZlNDUtMTIzOS00ZGE4LW I1MmYtODNkZDE2MTY3ZTM3IiwidXNlciI6eyJ1c2VyX2lkIjoxMzIyODU4LCJ1c2VyX2VtYWlsIjoiYWFyb24uZS5ydXNzZWxsQGdtYWlsLmNvbSIsInNzbF9 hY2NvdW50X2lkIjo0NzQzMDJ9LCJjbGllbnQiOnsiaWQiOiJmUE1yYUdlbXVMWGUtcG9JWUtLem1CMEYwYXlFczktUEpiN29lTWFlY2I0In19.fCKDs1igjsI UDG2sUN_2OTb90Jw1nKNPHcD1MyEUR6sHCv_aJmcvcaFRne_eKLHzeQ9WtT5y3Fb2ppc50kMnjPG6JgX5gnFMptMn-ySsI277CtKbkSn3u-WSDSovn51jPm82 4wTeJmuXEzdv9clRjTwp6VoM9eqHCIaDAd3MP2xpMaa35cZbDaaAFKQ7jxWo9dUuTZY7DsKK0p1LloUEnmNxtNimQ3GDwkj_M600WB1zYrhDL9_3oZKaXcUx9 qzHcBCLzGgeaZ0xdpZtADxmXDUCcmkZi20yQ53bxqVL2w00sJ73efKB7JGeGWVehO-ZlGs3PUQwooox1JgEgcsA -credential_id=fe537ace-e132-52a9 -c2e7-egcd2ac3f1e6 -input_dir_path=input
Hash command executed successfully. Hash files created at: input

الدخول DocSignTool hash بدون المعلمات المطلوبة سيعرض معلومات الاستخدام للأمر.

Batch_sign_hash

علامة التجزئة المحسوبة مسبقًا بـ hash أمر. المعلمات -access_token, input_dir_path, -otpو output_dir_path مطلوبة. -credential_id مطلوب فقط للمستخدمين الذين لديهم أكثر من شهادة توقيع وثيقة eSigner.

الاستخدام: DocSignTool [-hV] batch_sign_hash -access_token=<ACCESS_TOKEN> [-credential_id=<CREDENTIAL_ID>] -input_dir_path=<PATH> -output_dir_path=<PATH> -otp=<OTP>

معلمات اختيارية:

• If -credential_id تم حذفه ولدى المستخدم شهادة توقيع وثيقة eSigner واحدة فقط ، وسوف يقوم DocSignTool افتراضيًا بذلك. إذا كان لدى المستخدم أكثر من شهادة توقيع وثيقة واحدة ، فإن هذه المعلمة إلزامية.

على سبيل المثال:

DocSignTool batch_sign_hash -access_token=eyJraWQiOiJmUE1yYUdlbXVMWGUtcG9JWUtLem1CMEYwYXlFczktUEpiN29lTWFlY2I0IiwiYWxnIjoiUlMyNTYifQ.eyJpc3MiOiJTU
0wuY29tIEF1dGhlbnRpY2F0aW9uIFNlcnZpY2UiLCJleHAiOjE2MTQ4OTcxNDIsImlhdCI6MTYxNDg5MzU0MiwianRpIjoiZmI2OTZlNDUtMTIzOS00ZGE4LW
I1MmYtODNkZDE2MTY3ZTM3IiwidXNlciI6eyJ1c2VyX2lkIjoxMzIyODU4LCJ1c2VyX2VtYWlsIjoiYWFyb24uZS5ydXNzZWxsQGdtYWlsLmNvbSIsInNzbF9
hY2NvdW50X2lkIjo0NzQzMDJ9LCJjbGllbnQiOnsiaWQiOiJmUE1yYUdlbXVMWGUtcG9JWUtLem1CMEYwYXlFczktUEpiN29lTWFlY2I0In19.fCKDs1igjsI
UDG2sUN_2OTb90Jw1nKNPHcD1MyEUR6sHCv_aJmcvcaFRne_eKLHzeQ9WtT5y3Fb2ppc50kMnjPG6JgX5gnFMptMn-ySsI277CtKbkSn3u-WSDSovn51jPm82
4wTeJmuXEzdv9clRjTwp6VoM9eqHCIaDAd3MP2xpMaa35cZbDaaAFKQ7jxWo9dUuTZY7DsKK0p1LloUEnmNxtNimQ3GDwkj_M600WB1zYrhDL9_3oZKaXcUx9
qzHcBCLzGgeaZ0xdpZtADxmXDUCcmkZi20yQ53bxqVL2w00sJ73efKB7JGeGWVehO-ZlGs3PUQwooox1JgEgcsA -credential_id=fe537ace-e132-52a9
-c2e7-egcd2ac3f1e6 -input_dir_path=input -output_dir_path=output -otp=142392
Batch sign hash command executed successfully. Output directory for signed files: output

الدخول DocSignTool batch_sign_hash بدون المعلمات المطلوبة سيعرض معلومات الاستخدام للأمر.

كيفية اختبار DocSignTool في وضع الحماية

1. في إصدار DocSignTool، انتقل إلى conf مجلد وفتح doc_sign_tool.properties ملف
2. قم بالتعليق على الخصائص الموجودة عن طريق الإضافة # رمز قبل كل خاصية
3. أضف الخصائص التالية في الملف:
   • CLIENT_ID=qOUeZCCzSqgA93acB3LYq6lBNjgZdiOxQc-KayC3UMw
   • OAUTH2_ENDPOINT=https://oauth-sandbox.ssl.com/oauth2/token
   • CSC_API_ENDPOINT=https://cs-try.ssl.com
   • TSA_URL=http://ts.ssl.com
4. حفظ الملف. بعد الحفظ، يمكن الآن استخدام DocSignTool في وضع الحماية.
5. للتبديل مرة أخرى إلى وضع الإنتاج، قم بإلغاء التعليق على الخصائص الموجودة وحذف خصائص وضع الحماية.

اختياري: قم بتحويل شهادة توقيع مستند OV إلى شهادة ختم

ملحوظة: هذا القسم مخصص فقط للمستخدمين الذين يريدون القيام بالختم. لأتمتة توقيع المستندات وعدم المطالبة بكلمات مرور لمرة واحدة (OTP)، يقوم المستخدمون بتحويل شهادة توقيع مستند التحقق من صحة المؤسسة (OV) الخاصة بهم إلى شهادة ختم على حسابات SSL.com الخاصة بهم. التعليمات أدناه:

1. انقر الطلبات في القائمة العلوية لحساب SSL.com الخاص بك. 
2. حدد موقع شهادتك وانقر فوق تنزيل / التفاصيل الرابط.
3. انقر على إزالة 2FA .