SSL.com

คู่มือคำสั่ง eSigner DocSignTool

DocSignTool เป็นยูทิลิตี้บรรทัดคำสั่ง Java แบบหลายแพลตฟอร์มที่ปลอดภัยและเน้นความเป็นส่วนตัวสำหรับการเซ็นชื่อไฟล์ PDF จากระยะไกลโดยใช้ eSigner ใบรับรองการลงนามเอกสาร แฮชของเอกสารจะถูกส่งไปยัง SSL.com เพื่อลงนามเพื่อไม่ให้ตัวเอกสารถูกส่งไป วิธีนี้เหมาะอย่างยิ่งในกรณีที่จำเป็นต้องลงนามในเอกสารสำคัญ แต่ไม่ควรส่งผ่านการโอนเงินเพื่อลงนาม DocSignTool ยังเหมาะอย่างยิ่งสำหรับกระบวนการแบทช์อัตโนมัติสำหรับการลงนามในปริมาณมากหรือการบูรณาการเข้ากับเวิร์กโฟลว์เอกสารที่มีอยู่

หากคุณต้องการลองใช้ DocSignTool ด้วยบัญชีทดลองและใบรับรอง โปรดอ่าน eSigner Demo Credentials และใบรับรอง สำหรับข้อมูลประจำตัวและข้อมูลการกำหนดค่า

หากคุณต้องการใช้ esigner เพื่อลงนามโค้ดและไฟล์สั่งการแทน โปรด อ้างถึงคู่มือ CodeSignTool นี้.

ไม่จำเป็นต้องมีการอนุญาต OTP เมื่อลงนามโดยใช้ใบรับรองการลงนามเอกสารแบบปิดผนึก ละเว้นพารามิเตอร์ OTP ทั้งหมดในคำแนะนำต่อไปนี้ หากใช้ใบรับรองการลงนามเอกสารแบบปิดผนึก (ลูกค้าที่มีอยู่แล้ว ใบรับรองการลงนามในเอกสารการตรวจสอบองค์กร สามารถติดต่อได้ support@ssl.com เพื่อแปลงเป็นใบรับรอง eSealing)

การติดตั้ง DocSignTool

ในการติดตั้ง DocSignTool เวอร์ชันปัจจุบัน เพียงดาวน์โหลดและคลายซิปไฟล์ที่ถูกต้องสำหรับระบบปฏิบัติการของคุณ:

โปรดทราบว่าการดาวน์โหลดของ Windows มีรันไทม์ Java แต่เวอร์ชัน Linux/macOS ต้องมีการติดตั้งรันไทม์ Java บนคอมพิวเตอร์ของคุณ คำสั่งเวอร์ชัน Windows เป็นไฟล์แบตช์ (DocSignTool.bat) และเวอร์ชัน Linux / macOS คือเชลล์สคริปต์ (DocSignTool.sh).

ภาพรวมการใช้งาน DocSignTool

การใช้งาน: DocSignTool [-hV] [COMMAND] [PARAMETERS]

ตัวเลือก:

คำสั่ง:

พารามิเตอร์:

หากรหัสผ่านของคุณมีอักขระพิเศษให้ใส่เครื่องหมายคำพูด (เช่น -password="P!@^^ssword12").

คำสั่ง 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 หากไม่มีพารามิเตอร์ที่ต้องการจะแสดงข้อมูลการใช้งานสำหรับคำสั่ง

ข้อมูลประจำตัว_info

คีย์เอาต์พุตและข้อมูลใบรับรองที่เกี่ยวข้องกับ ID ข้อมูลรับรอง พารามิเตอร์ -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=ฮุสตัน, ST=เท็กซัส, C=US - ใบรับรองหมดอายุ: วันเสาร์ที่ 11 กุมภาพันธ์ 14:52:59 EST 2023 - DN ของผู้ออก: CN=SSL.com ใบรับรองไคลเอนต์ระดับกลาง CA RSA R2, O=SSL Corp, L=ฮุสตัน , 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>]

พารามิเตอร์เสริม:

สำหรับข้อมูลเกี่ยวกับการลงทะเบียนใบรับรองการลงนามเอกสาร EV ใน eSigner และการตั้งค่าการตรวจสอบสิทธิ์แบบสองปัจจัย โปรดอ่าน การลงนามรหัส EV ระยะไกลด้วย eSigner. สำหรับข้อมูลเกี่ยวกับค่าลับ TOTP โปรดดูที่ การลงนาม eSigner EV Code โดยอัตโนมัติ.

ตัวอย่าง:

รายการ OTP ด้วยตนเองพร้อมลายเซ็นที่มองเห็นได้:

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 -sig_field_position="100, 200, 150" -page_no=70 -signing_location="ฮิวสตัน, เท็กซัส" -signing_reason="การอนุมัติเอกสาร" -contact_info="support@ssl.com" ป้อน OTP - กด Enter เพื่อดำเนินการต่อ: 884646 ลงนาม PDF สำเร็จแล้ว: output\test.pdf

การสร้าง OTP อัตโนมัติ, ไม่มีลายเซ็นที่มองเห็นได้:

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 หากไม่มีพารามิเตอร์ที่ต้องการจะแสดงข้อมูลการใช้งานสำหรับคำสั่ง

หากคุณได้รับข้อความแสดงข้อผิดพลาด Error: invalid otp เมื่อพยายามเซ็นชื่อไฟล์อาจเกิดจากปัญหาเหล่านี้อย่างน้อยหนึ่งอย่าง:
  • รหัส QR ที่คุณสแกนในแอปตรวจสอบสิทธิ์ของคุณไม่ตรงกับชื่อผู้ใช้รหัสผ่านและ / หรือรหัสข้อมูลรับรองจากคำสั่งของคุณ สิ่งนี้อาจเกิดขึ้นได้หาก:
    • คุณมีบัญชีหลายบัญชีที่กำหนดค่าไว้สำหรับ 2FA บนอุปกรณ์ของคุณและเลือกบัญชีที่ไม่ถูกต้อง
    • คุณกำลังพยายามใช้ข้อมูลรับรองการเข้าสู่ระบบของคุณสำหรับไฟล์ ใบรับรองที่ใช้ร่วมกันแต่สแกนโค้ด QR ที่เพื่อนร่วมทีมแชร์จากบัญชีของพวกเขา
  • OTP ที่คุณป้อนหมดอายุแล้ว
  • คำสั่งของคุณมีข้อมูลลับ TOTP ที่ไม่ถูกต้อง

แบทช์_เซ็น

ลงชื่อและประทับเวลาไฟล์ PDF สูงสุด 100 ไฟล์ด้วย 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>]

พารามิเตอร์เสริม:

ตัวอย่าง:

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 คำสั่งแบทช์ดำเนินการสำเร็จ ไดเรกทอรีเอาต์พุตสำหรับไฟล์ที่ลงนาม: เอาต์พุต

เข้า DocSignTool batch_sign หากไม่มีพารามิเตอร์ที่ต้องการจะแสดงข้อมูลการใช้งานสำหรับคำสั่ง

กัญชา

ควรใช้อัลกอริทึม SHA 256 เพื่อคำนวณแฮชของเอกสาร PDF 
  1. จำเป็นต้องมีไลบรารี PDF เพื่อจัดการ PDF สำหรับอินพุตแฮช และฝัง PKCS#7 ลงในเอกสาร PDF ในภายหลัง (เช่น ApachePDFBox ใน Java) 
  2. ไลบรารี Crypto สำหรับการสร้าง PKCS#7 จากลายเซ็นดิบที่ได้รับจาก eSigner API (เช่น BouncyCastle ใน Java)

คำนวณแฮชล่วงหน้าเพื่อใช้ในภายหลังกับ 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>]

พารามิเตอร์เสริม:

ตัวอย่าง:

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

เข้าสู่ระบบแฮช (es) ที่คำนวณไว้ล่วงหน้าด้วย 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>

พารามิเตอร์เสริม:

ตัวอย่าง:

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. เพิ่มคุณสมบัติต่อไปนี้ในไฟล์:
  4. บันทึกไฟล์. หลังจากบันทึกแล้ว DocSignTool สามารถใช้ในโหมดแซนด์บ็อกซ์ได้แล้ว
  5. หากต้องการสลับกลับไปยังโหมดการใช้งานจริง ให้ยกเลิกหมายเหตุคุณสมบัติที่มีอยู่และลบคุณสมบัติแซนด์บ็อกซ์

ทางเลือก: แปลงใบรับรองการลงนามเอกสาร OV ของคุณเป็นใบรับรองการปิดผนึก

หมายเหตุ ส่วนนี้มีไว้สำหรับผู้ใช้ที่ต้องการทำการซีลเท่านั้น. หากต้องการทำให้การลงนามเอกสารเป็นอัตโนมัติและไม่ได้รับแจ้งจากรหัสผ่านครั้งเดียว (OTP) ผู้ใช้จะแปลงใบรับรองการลงนามเอกสารการตรวจสอบองค์กร (OV) ด้วยตนเองเป็นใบรับรองปิดผนึกในบัญชี SSL.com ของตน คำแนะนำอยู่ด้านล่าง:

  1. คลิก รายการสั่งซื้อ ที่เมนูด้านบนของบัญชี SSL.com ของคุณ 
  2. ค้นหาใบรับรองของคุณแล้วคลิก ดาวน์โหลด / รายละเอียด ลิงค์
  3. คลิก ลบ 2FA ปุ่ม
ขอบคุณที่เลือกใช้ SSL.com! หากคุณมีคำถามใด ๆ โปรดติดต่อเราทางอีเมลที่ Support@SSL.com, โทร 1-877-SSL-SECUREหรือคลิกลิงก์แชทที่ด้านล่างขวาของหน้านี้ คุณยังสามารถค้นหาคำตอบสำหรับคำถามการสนับสนุนทั่วไปได้ใน ฐานความรู้.
ออกจากเวอร์ชันมือถือ