eSigner DocSignTool käsujuhend

DocSignTool on turvaline, privaatsusele orienteeritud mitme platvormiga Java käsurea utiliit PDF-failide kaug allkirjastamiseks, kasutades e-allkirjastaja dokumentide allkirjastamise sertifikaadid. Dokumentide räsi saadetakse SSL.com-ile allkirjastamiseks, et dokumenti ennast ei saadetaks. See on ideaalne koht, kus tundlikud dokumendid tuleb allkirjastada, kuid neid ei tohiks allkirjastamiseks saata. DocSignTool sobib ideaalselt ka automatiseeritud pakkprotsesside jaoks suure mahuga allkirjastamiseks või olemasolevatesse dokumentide töövoogudesse integreerimiseks.

DocSignTooli installimine

DocSignTooli praeguse versiooni installimiseks laadige lihtsalt oma OS-i jaoks õige fail alla ja pakkige lahti:

• Windows
• Linux ja macOS

Pange tähele, et Windowsi allalaadimine sisaldab Java käitust, kuid Linuxi / macOS-i versioon nõuab Java arvutisse installimist. Käsu Windowsi versioon on pakkfail (DocSignTool.bat) ja Linuxi / macOS-i versioon on shelliskript (DocSignTool.sh).

DocSignTooli kasutamise ülevaade

Kasutus: DocSignTool [-hV] [COMMAND] [PARAMETERS]

Valikud:

• -h, --help: Kuvage abisõnum ja väljuge.
• -V, --version: Kuva versiooni teave ja väljuge.

Käsud:

• get_credential_ids: Väljastage konkreetse kasutajaga seotud eSigneri mandaadi ID-de loend.
• credential_info: Mandaadi ID-ga seotud väljundvõti ja sertifikaadi teave.
• sign: Allkiri ja ajatempel PDF filr.
• batch_sign: Mitme OTP-ga mitme PDF-faili allkirjastamine ja ajatempel.
• hash: Eelnevalt arvutage räsi (d) koos hilisemaks kasutamiseks batch_hash_sign käsk
• batch_sign_hash: Märgi räsi (d) eelnevalt arvutatud hash käsk

Parameetrid:

• -access_token=<TOKEN>: OAuth juurdepääsukutse.
• -contact_info=<CONTACT_INFO>: Kontaktinfo.
• -credential_id=<CREDENTIAL_ID>: Mandaadi ID sertifikaadi allkirjastamiseks.
• -input_dir_path=<PATH>: Sisendkataloog allkirjastatavate PDF-failide jaoks, arvutab räsid või valib allkirjastamiseks allkirjastamata failid ja vastavad räsid.
• -input_file_path=<PATH>: Allkirjastatava PDF-faili tee.
• -otp=<OTP>: OAuthi OTP väärtus autentimisrakendusest.
• -output_dir_path=<PATH>: Kataloog, kuhu kirjutatakse allkirjastatud PDF-fail (id).
• -page_no=<PAGE_NUMBER>: PDF-dokumendi leht, kuhu ilmub nähtav allkiri.
• -password=<PASSWORD>: SSL.com konto parool.
• -sig_field_position=<X, Y, WIDTH, HEIGHT>: Nähtava allkirja asukoht PDF-is.
• -signing_location=<SIGNING_LOCATION>: Dokumenti allkirjastamise koht.
• signing_reason=<SIGNING_REASON>: Allkirjastamise põhjus.
• -totp_secret=<TOTP_SECRET>: OAuth TOTP saladus
• -username=<USERNAME>: SSL.com konto kasutajanimi

DocSignTooli käsud

get_credential_ids

Väljundage konkreetse kasutajaga seotud eSigneri mandaadi ID-de loend. Parameetrid -username ja -password on vaja.

Kasutus: DocSignTool [-hV] get_credential_ids -username=<USERNAME> -password=<PASSWORD>

Näide:

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

Sisestamine DocSignTool get_credential_ids ilma vajalike parameetriteta kuvatakse käsu kasutamise teave.

volituste_info

Mandaadi ID-ga seotud väljundvõti ja sertifikaadi teave. Parameetrid -credential_id, -usernameja -password on vaja.

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

Näide:

DocSignTool credential_info -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -username=john.doe@example.com -password="P0z9@lxo41" Allkirjastamissertifikaadi ODN-subjekti teave: CNDOP=Teema DNSSL, CNOHJ , L=Houston, ST=Texas, C=USA – sertifikaadi aegumine: laupäev 11. veebruar 14:52:59 EST 2023 – väljaandja DN: CN=SSL.com kliendi sertifikaat, keskmine CA RSA R2, O=SSL Corp, L=Houston , ST = Texas, C = USA

Sisestamine DocSignTool credential_info ilma vajalike parameetriteta kuvatakse käsu kasutamise teave.

kirjutama

Allkirjastage ja ajatempli PDF-fail. Parameetrid -username, -passwordja -input_file_path on vaja. -credential_id on vajalik ainult kasutajatele, kellel on rohkem kui üks dokumendi eSigner allkirjastamise sertifikaat. -output_dir_path, -signing_location, -signing-reason, -contact_info,  -sig_field_position, -page_noja -totp_secret on valikulised.

Kasutus: 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>]

Valikulised parameetrid:

• If -credential_id on välja jäetud ja kasutajal on ainult üks dokumendi eSigner allkirjastamise sertifikaat, vaikimisi on see DocSignTool. Kui kasutajal on mitu dokumendi allkirjastamise sertifikaati, on see parameeter kohustuslik.
• If -output_dir_path on välja jäetud, failis täpsustatud fail -input_file_path kirjutatakse koos allkirjastatud failiga üle. DocSignTool küsib kasutajalt enne faili ülekirjutamist.
• If -signing_location on olemas, lisatakse määratud asukoht digitaalallkirjale.
• If -signing_reason on olemas, lisatakse digitaalallkirjale täpsustatud allkirjastamise põhjus.
• If -contact_info on olemas, lisatakse täpsustatud tekst digitaalsesse signatuuri. Ehkki see teave on koos allkirjaga, ei sisaldu see teave nähtavas allkirja märkuses (kui see on olemas).
• If -sig_field_position on olemas, lisatakse nähtav allkirja annotatsioon dokumendile lehel -page_no. Amet ja allkiri tuleks esitada sellises vormis "x, y, width, height".
• -page_no on vajalik ainult siis, kui loote nähtava allkirja -sig_field_position ja määrab dokumendi lehe, millel nähtav allkirja märkus ilmub.
• If -totp_secret on olemas, arvutab DocSignTool allkirjastamiseks ajapõhise OTP, võimaldades tööriista automatiseeritud kasutamist. Kui seda parameetrit pole, palutakse kasutajal sisestada OTP käsitsi.

Näited:

Manuaalne OTP sisestamine nähtava allkirjaga:

DocSignTool märk -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -username=john.doe@example.com -password="P0z9@lxo41" -output_dir_path=signed -output_dir_path=signed -pathig_position100,pdf. 200, 150" -page_no=70 -signing_location="Houston, Texas" -signing_reason="dokumendi kinnitamine" -contact_info="support@ssl.com" Sisestage OTP – jätkamiseks vajutage sisestusklahvi: 1 PDF allkirjastatud edukalt: output\test .pdf

Automatiseeritud OTP genereerimine, nähtava allkirjata:

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

Sisestamine DocSignTool sign ilma vajalike parameetriteta kuvatakse käsu kasutamise teave.

partii_sign

Ühe OTP-ga saate alla kirjutada ja ajatempli kuni 100 PDF-faili. Parameetrid -username, -passwordja -input_dir_path on vaja. -credential_id on vajalik ainult kasutajatele, kellel on rohkem kui üks dokumendi eSigner allkirjastamise sertifikaat. -output_dir_path, -signing_location, -signing-reason, -contact_info,  -sig_field_position, -page_noja -totp_secret on valikulised.

Kasutus: 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>]

Valikulised parameetrid:

• If -credential_id on välja jäetud ja kasutajal on ainult üks dokumendi eSigner allkirjastamise sertifikaat, vaikimisi on see DocSignTool. Kui kasutajal on mitu dokumendi allkirjastamise sertifikaati, on see parameeter kohustuslik.
• If -output_dir_path on välja jäetud, jaotises määratud failid -input_dir_path kirjutatakse koos allkirjastatud failidega üle. DocSignTool küsib kasutajalt enne failide ülekirjutamist.
• If -signing_location on olemas, lisatakse digitaalallkirjadele määratud asukoht.
• If -signing_reason on olemas, lisatakse digitaalallkirjadele täpsustatud allkirjastamise põhjus.
• If -contact_info on olemas, lisatakse määratud tekst digitaalsetele sigatuuridele. Ehkki see teave on koos allkirjaga, ei sisaldu see nähtavates allkirja märkustes (kui need on olemas).
• If -sig_field_position on olemas, lisatakse nähtav allkirja märkus dokumentidele, mille on täpsustanud -page_no. Amet ja allkiri tuleks esitada sellises vormis "x, y, width, height".
• -page_no on vajalik ainult siis, kui loote nähtava allkirja -sig_field_position ja määrab dokumentide lehe, millel nähtavad allkirja märkused ilmuvad.
• If -totp_secret on olemas, arvutab DocSignTool allkirjastamiseks ajapõhise OTP, võimaldades tööriista automatiseeritud kasutamist. Kui seda parameetrit pole, palutakse kasutajal sisestada OTP käsitsi.

Näide:

DocSignTool partii_sign -kasutajanimi=john.doe@example.com -password="P0z9@lxo41" -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -input_dir_path=input_path100,out_out 200, 150" -page_no=70 -signing_location="Houston, Texas" -signing_reason="dokumendi kinnitamine" -contact_info="support@ssl.com" Sisestage OTP – Vajutage jätkamiseks sisestusklahvi: 1 Pakettallkirja käsk täideti edukalt. Allkirjastatud failide väljundkataloog: väljund

Sisestamine DocSignTool batch_sign ilma vajalike parameetriteta kuvatakse käsu kasutamise teave.

hash

Eelnevalt arvutage räsi (d) koos hilisemaks kasutamiseks batch_hash_sign käsk. Parameetrid -access_token ja -input_dir_path on vaja. -credential_id on vajalik ainult kasutajatele, kellel on rohkem kui üks dokumendi eSigner allkirjastamise sertifikaat. -signing_location, -signing-reason, -contact_info,  -sig_field_positionja -page_noon valikulised.

Kasutus: 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>]

Valikulised parameetrid:

• If -program_name on olemas MSI installeri allkirjastamisel, kuvatakse väärtus kinnitusdialoogis programmi nimena.
• If -signing_location on olemas, lisatakse määratud asukoht digitaalallkirjadele nende loomisel.
• If -signing_reason on olemas, lisatakse määratud allkirjastamise põhjus digitaalallkirjadele nende loomisel.
• If -contact_info on olemas, lisatakse määratud tekst digitaalsignaalidele nende loomisel. Kuigi see teave on allkirjaga kaasas, ei lisata seda teavet nähtavate allkirjade märkustesse (kui need on olemas).
• If -sig_field_position on olemas, lisatakse nähtav allkirja märkus dokumentidele, mille on täpsustanud -page_no kui allkirjad genereeritakse. Amet ja allkiri tuleks esitada sellises vormis "x, y, width, height".
• -page_no on vajalik ainult siis, kui loote nähtava allkirja -sig_field_position ja määrab dokumentide lehe, millel nähtavad allkirja märkused nende loomisel ilmuvad.

Näide:

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

Sisestamine DocSignTool hash ilma vajalike parameetriteta kuvatakse käsu kasutamise teave.

partii_sign_hash

Märgi räsi (d) on eelnevalt arvutatud hash käsk. Parameetrid -access_token, input_dir_path, -otpja output_dir_path on vaja. -credential_id on vajalik ainult kasutajatele, kellel on rohkem kui üks dokumendi eSigner allkirjastamise sertifikaat.

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

Valikulised parameetrid:

• If -credential_id on välja jäetud ja kasutajal on ainult üks dokumendi eSigner allkirjastamise sertifikaat, vaikimisi on see DocSignTool. Kui kasutajal on mitu dokumendi allkirjastamise sertifikaati, on see parameeter kohustuslik.

Näide:

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

Sisestamine DocSignTool batch_sign_hash ilma vajalike parameetriteta kuvatakse käsu kasutamise teave.

Kuidas testida DocSignTooli liivakastirežiimis

1. DocSignTooli versioonis minge aadressile conf kaust ja avage doc_sign_tool.properties fail
2. Kommenteerige olemasolevaid omadusi lisades # sümbol iga vara ees
3. Lisage faili järgmised atribuudid:
   • 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. Salvestage fail. Pärast salvestamist saab DocSignTooli nüüd kasutada liivakastirežiimis.
5. Tootmisrežiimile naasmiseks tühjendage olemasolevate atribuutide kommentaarid ja kustutage liivakasti atribuudid.

Valikuline: teisendage oma OV dokumendi allkirjastamise sertifikaat pitseerimissertifikaadiks

Märge: See jaotis on mõeldud ainult kasutajatele, kes soovivad tihendada. Dokumendi allkirjastamise automatiseerimiseks ja mitte ühekordsete paroolide (OTP) küsimise vältimiseks teisendavad kasutajad oma organisatsiooni kinnitamise (OV) dokumendi allkirjastamise sertifikaadi ise oma SSL.com-i kontodel pitseerimissertifikaadiks. Juhised on allpool:

1. Click Tellimused oma SSL.com-i konto ülemises menüüs. 
2. Leidke oma sertifikaat ja klõpsake nuppu allalaadimine / üksikasjad link.
3. kliki EEMALDA 2FA nuppu.