Sprievodca príkazom eSigner DocSignTool

DocSignTool je bezpečný multiplatformový nástroj príkazového riadku Java zameraný na súkromie na vzdialené podpisovanie súborov PDF pomocou eSigner certifikáty na podpisovanie dokumentov. Hashe dokumentov sa odosielajú na podpísanie na SSL.com, aby sa neodosielal samotný dokument. Je to ideálne tam, kde je potrebné podpísať citlivé dokumenty, ale nemali by sa posielať na podpis cez drôt. DocSignTool je tiež ideálny pre automatizované dávkové procesy pre veľkoobjemové podpisy alebo integráciu do existujúcich pracovných tokov dokumentov.

Inštalácia DocSignTool

Ak chcete nainštalovať aktuálnu verziu aplikácie DocSignTool, jednoducho si stiahnite a rozbaľte správny súbor pre váš operačný systém:

• Windows
• Linux a macOS

Upozorňujeme, že sťahovanie do systému Windows obsahuje runtime Java, ale verzia pre Linux / macOS vyžaduje, aby bol na vašom počítači nainštalovaný runtime Java. Verzia príkazu pre Windows je dávkový súbor (DocSignTool.bat) a verzia pre Linux / macOS je shell skript (DocSignTool.sh).

Prehľad použitia DocSignTool

Použitie: DocSignTool [-hV] [COMMAND] [PARAMETERS]

Voľby:

• -h, --help: Zobraziť pomocnú správu a ukončiť.
• -V, --version: Zobraziť informácie o verzii a ukončiť.

príkazy:

• get_credential_ids: Výstup zoznamu identifikátorov poverení eSigneru priradených ku konkrétnemu používateľovi.
• credential_info: Výstupný kľúč a informácie o certifikáte súvisiace s ID poverenia.
• sign: Podpis a časová pečiatka vo formáte PDF.
• batch_sign: Podpisujte a označte časovou značkou viac súborov PDF pomocou jedného OTP.
• hash: Predbežne vypočítať hodnoty hash pre ďalšie použitie s batch_hash_sign Príkaz.
• batch_sign_hash: Podpísať hash (y) vopred vypočítaný pomocou hash Príkaz.

Parametre:

• -access_token=<TOKEN>: OAuth prístupový token.
• -contact_info=<CONTACT_INFO>: Kontaktné informácie.
• -credential_id=<CREDENTIAL_ID>: ID poverenia na podpísanie certifikátu.
• -input_dir_path=<PATH>: Vstupný adresár pre súbory PDF, ktoré sa majú podpísať, majú vypočítané hodnoty hash alebo vybrať nepodpísané súbory a zodpovedajúce hodnoty hash na podpisovanie.
• -input_file_path=<PATH>: Cesta k súboru PDF, ktorý sa má podpísať.
• -otp=<OTP>: Hodnota OTP protokolu OAuth z autentifikačnej aplikácie.
• -output_dir_path=<PATH>: Adresár, do ktorého sa zapíšu podpísané súbory PDF.
• -page_no=<PAGE_NUMBER>: Stránka dokumentu PDF, na ktorej sa objaví viditeľný podpis.
• -password=<PASSWORD>: Heslo účtu SSL.com.
• -sig_field_position=<X, Y, WIDTH, HEIGHT>: Poloha viditeľného podpisu v PDF.
• -signing_location=<SIGNING_LOCATION>: Miesto, kde je dokument podpísaný.
• signing_reason=<SIGNING_REASON>: Dôvod podpisu.
• -totp_secret=<TOTP_SECRET>: OAuth Tajomstvo TOTP
• -username=<USERNAME>: Používateľské meno účtu SSL.com

Príkazy DocSignTool

get_credential_ids

Výstup zoznamu identifikátorov poverení eSigneru priradených ku konkrétnemu používateľovi. Parametre -username a -password sú povinné.

Použitie: DocSignTool [-hV] get_credential_ids -username=<USERNAME> -password=<PASSWORD>

Príklad:

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

Zadanie DocSignTool get_credential_ids bez požadovaných parametrov zobrazí informácie o použití príkazu.

poverenia_info

Výstupný kľúč a informácie o certifikáte súvisiace s ID poverenia. Parametre -credential_id, -usernamea -password sú povinné.

Použitie: DocSignTool [-hV] credential_info -credential_id=<CREDENTIAL_ID> -username=<USERNAME> -password=<PASSWORD>

Príklad:

DocSignTool credential_info -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -username=john.doe@example.com -password="P0z9@lxo41" Informácie o predmete podpisového certifikátu: - Subject DN: DOECN,=OJOHN , L=Houston, ST=Texas, C=US - Platnosť certifikátu: 11. február 14:52:59 EST 2023 - DN vydavateľa: CN=SSL.com Klientsky certifikát Stredný CA RSA R2, O=SSL Corp, L=Houston , ST=Texas, C=US

Zadanie DocSignTool credential_info bez požadovaných parametrov zobrazí informácie o použití príkazu.

značka

Podpísať a časovú pečiatku súbor PDF. Parametre -username, -passworda -input_file_path sú povinné. -credential_id sa vyžaduje iba pre používateľov s viac ako jedným podpisovým certifikátom dokumentu eSigner. -output_dir_path, -signing_location, -signing-reason, -contact_info,  -sig_field_position, -page_noa -totp_secret sú voliteľné.

Použitie: 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>]

Voliteľné parametre:

• If -credential_id je vynechané a používateľ má iba jeden podpisový certifikát dokumentu eSigner, DocSignTool bude mať predvolené nastavenie. Ak má používateľ viac ako jeden podpisový certifikát dokumentu, je tento parameter povinný.
• If -output_dir_path je vynechaný, súbor uvedený v -input_file_path bude prepísaný podpísaným súborom. DocSignTool vyzve používateľa pred prepísaním súboru.
• If -signing_location ak je k dispozícii, zadané umiestnenie sa pridá do digitálneho podpisu.
• If -signing_reason je prítomný, do digitálneho podpisu sa pridá zadaný dôvod podpisu.
• If -contact_info ak je k dispozícii, zadaný text sa pridá k digitálnemu podpisu. Aj keď sú tieto informácie súčasťou podpisu, nebudú zahrnuté do viditeľnej anotácie podpisu (ak sú prítomné).
• If -sig_field_position je k dispozícii, do dokumentu na stránke určenej používateľom bude pridaná viditeľná anotácia podpisu -page_no. Pozícia a podpis by mali byť poskytnuté vo formáte "x, y, width, height".
• -page_no sa vyžaduje iba pri vytváraní viditeľného podpisu pomocou -sig_field_position a určuje stránku dokumentu, na ktorej sa bude zobrazovať viditeľná anotácia podpisu.
• If -totp_secret DocSignTool vypočíta časovo závislé OTP na podpisovanie, čo umožní automatické použitie nástroja. Pokiaľ tento parameter nie je k dispozícii, bude užívateľ vyzvaný na zadanie manuálneho OTP.

Príklady:

Ručné zadanie OTP s viditeľným podpisom:

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 = "test" 100, 200 "-page_no = 150 -signing_location =" Houston, Texas "-signing_reason =" schválenie dokumentu "-contact_info ="support@ssl.com"Zadajte OTP - pokračujte stlačením klávesu Enter: 884646 PDF úspešne podpísané: output \ test.pdf

Automatizované generovanie OTP, bez viditeľného podpisu:

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

Zadanie DocSignTool sign bez požadovaných parametrov zobrazí informácie o použití príkazu.

batch_sign

Podpisujte a označte časovou značkou až 100 súborov PDF pomocou jedného OTP. Parametre -username, -passworda -input_dir_path sú povinné. -credential_id sa vyžaduje iba pre používateľov s viac ako jedným podpisovým certifikátom dokumentu eSigner. -output_dir_path, -signing_location, -signing-reason, -contact_info,  -sig_field_position, -page_noa -totp_secret sú voliteľné.

Použitie: 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>]

Voliteľné parametre:

• If -credential_id je vynechané a používateľ má iba jeden podpisový certifikát dokumentu eSigner, DocSignTool bude mať predvolené nastavenie. Ak má používateľ viac ako jeden podpisový certifikát dokumentu, je tento parameter povinný.
• If -output_dir_path je vynechaný, súbory uvedené v -input_dir_path budú prepísané podpísanými súbormi. DocSignTool vyzve používateľa pred prepísaním súborov.
• If -signing_location je k dispozícii, zadané umiestnenie sa pridá k digitálnym podpisom.
• If -signing_reason je prítomný, k digitálnym podpisom sa pridá zadaný dôvod podpisu.
• If -contact_info ak je k dispozícii, zadaný text sa pridá k digitálnym podpisom. Aj keď sú tieto informácie súčasťou podpisu, nebudú zahrnuté do viditeľných anotácií podpisu (ak sú prítomné).
• If -sig_field_position je k dispozícii, bude k dokumentom na stránke zadanej používateľom pridaná viditeľná anotácia podpisu -page_no. Pozícia a podpis by mali byť poskytnuté vo formáte "x, y, width, height".
• -page_no sa vyžaduje iba pri vytváraní viditeľného podpisu pomocou -sig_field_position a určuje stránku dokumentov, na ktorých sa zobrazia viditeľné anotácie podpisu.
• If -totp_secret DocSignTool vypočíta časovo závislé OTP na podpisovanie, čo umožní automatické použitie nástroja. Pokiaľ tento parameter nie je k dispozícii, bude užívateľ vyzvaný na zadanie manuálneho OTP.

Príklad:

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"Zadajte OTP - pokračujte stlačením klávesu Enter: 455145 Príkaz dávkového podpisu bol úspešne vykonaný. Výstupný adresár pre podpísané súbory: výstup

Zadanie DocSignTool batch_sign bez požadovaných parametrov zobrazí informácie o použití príkazu.

hašiš

Predbežne vypočítajte hash pre ďalšie použitie s batch_hash_sign príkaz. Parametre -access_token a -input_dir_path sú povinné. -credential_id sa vyžaduje iba pre používateľov s viac ako jedným podpisovým certifikátom dokumentu eSigner. -signing_location, -signing-reason, -contact_info,  -sig_field_positiona -page_no, sú voliteľné.

Použitie: 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>]

Voliteľné parametre:

• If -program_name je prítomný pri podpise inštalátora MSI, hodnota sa zobrazí v potvrdzovacom dialógovom okne ako názov programu.
• If -signing_location ak je k dispozícii, zadané umiestnenie sa pridá k digitálnym podpisom, keď sa vygenerujú.
• If -signing_reason je prítomný, bude sa pri generovaní digitálnych podpisov pridávať zadaný dôvod podpisu.
• If -contact_info ak je prítomný, zadaný text sa pridá k digitálnym podpisom, keď sa vygenerujú. Aj keď sú tieto informácie súčasťou podpisu, nebudú zahrnuté do viditeľných anotácií podpisu (ak sú prítomné).
• If -sig_field_position je k dispozícii, bude k dokumentom na stránke zadanej používateľom pridaná viditeľná anotácia podpisu -page_no keď sa generujú podpisy. Pozícia a podpis by mali byť poskytnuté vo formáte "x, y, width, height".
• -page_no sa vyžaduje iba pri vytváraní viditeľného podpisu pomocou -sig_field_position a určuje stránku dokumentov, na ktorých sa pri generovaní objavia viditeľné anotácie podpisov.

Príklad:

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

Zadanie DocSignTool hash bez požadovaných parametrov zobrazí informácie o použití príkazu.

batch_sign_hash

Predbežne vypočítané znaky hash hash príkaz. Parametre -access_token, input_dir_path, -otpa output_dir_path sú povinné. -credential_id sa vyžaduje iba pre používateľov s viac ako jedným podpisovým certifikátom dokumentu eSigner.

Použitie: DocSignTool [-hV] batch_sign_hash -access_token=<ACCESS_TOKEN> [-credential_id=<CREDENTIAL_ID>] -input_dir_path=<PATH> -output_dir_path=<PATH> -otp=<OTP>

Voliteľné parametre:

• If -credential_id je vynechané a používateľ má iba jeden podpisový certifikát dokumentu eSigner, DocSignTool bude mať predvolené nastavenie. Ak má používateľ viac ako jeden podpisový certifikát dokumentu, je tento parameter povinný.

Príklad:

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

Zadanie DocSignTool batch_sign_hash bez požadovaných parametrov zobrazí informácie o použití príkazu.

Ako otestovať DocSignTool v režime sandbox

1. Vo vydaní DocSignTool prejdite na conf priečinok a otvorte ho doc_sign_tool.properties rezeň
2. Okomentujte existujúce vlastnosti pridaním # symbol pred každou vlastnosťou
3. Pridajte do súboru nasledujúce vlastnosti:
   • 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. Uložte súbor. Po uložení možno teraz DocSignTool používať v režime karantény.
5. Ak chcete prepnúť späť do produkčného režimu, zrušte komentár k existujúcim vlastnostiam a odstráňte vlastnosti karantény.

Voliteľné: Preveďte svoj certifikát na podpisovanie dokumentov OV na certifikát esealing

Poznámka: Táto sekcia je len pre používateľov, ktorí chcú vykonávať tesnenie. Aby sa zautomatizovalo podpisovanie dokumentov a nemuseli byť požiadaní o jednorazové heslá (OTP), používatelia si sami konvertujú svoj certifikát na podpisovanie dokumentov organizácie Validation (OV) na certifikát esealing na svojich účtoch SSL.com. Pokyny sú nižšie:

1. kliknite Objednávky v hornej ponuke vášho účtu SSL.com. 
2. Nájdite svoj certifikát a kliknite na stiahnutie / podrobnosti odkaz.
3. Kliknite na tlačidlo ODSTRÁŇTE 2FA tlačidlo.