eSigner DocSignTool -komento-opas

DocSignTool on turvallinen, yksityisyyden suojaan suuntautuva monialustainen Java-komentorivi-apuohjelma PDF-tiedostojen etäkirjaamiseen käyttäen sähköinen allekirjoittaja asiakirjojen allekirjoitustodistukset. Asiakirjojen tiivisteet lähetetään SSL.com:iin allekirjoittamista varten, jotta itse asiakirjaa ei lähetetä. Tämä on ihanteellinen paikka, jossa arkaluontoiset asiakirjat on allekirjoitettava, mutta niitä ei tule lähettää allekirjoitettavaksi. DocSignTool on myös ihanteellinen automatisoituihin eräprosesseihin suuren volyymin allekirjoituksiin tai integrointiin olemassa oleviin dokumenttien työnkulkuihin.

DocSignTool-asennus

Asenna DocSignToolin nykyinen versio lataamalla ja purkamalla oikea käyttöjärjestelmäsi tiedosto:

• Windows
• Linux ja macOS

Huomaa, että Windowsin lataus sisältää Java-ajonaikaisen, mutta Linux / macOS-versio vaatii Java-ajonaikaisen asennuksen tietokoneellesi. Komennon Windows-versio on erätiedosto (DocSignTool.bat) ja Linux / macOS-versio on komentotulkkikomento (DocSignTool.sh).

DocSignTool-käytön yleiskatsaus

Käyttö: DocSignTool [-hV] [COMMAND] [PARAMETERS]

Vaihtoehdot:

• -h, --help: Näytä ohjeviesti ja poistu.
• -V, --version: Näytä versiotiedot ja poistu.

Käskyt:

• get_credential_ids: Tulosta luettelo tiettyyn käyttäjään liittyvistä eSigner-tunnistetunnuksista.
• credential_info: Tunnistetunnukseen liittyvät tulostusavaimen ja varmenteen tiedot.
• sign: Merkki ja aikaleima PDF-tiedosto.
• batch_sign: Allekirjoita ja leimaa useita PDF-tiedostoja yhdellä OTP: llä.
• hash: Laske hash (esilaskelmat) myöhempää käyttöä varten batch_hash_sign komento.
• batch_sign_hash: Merkkikokoonpano (t) valmiiksi laskettu hash komento.

parametrit:

• -access_token=<TOKEN>: OAuth pääsyoikeus.
• -contact_info=<CONTACT_INFO>: Yhteystiedot.
• -credential_id=<CREDENTIAL_ID>: Tunnistetunnus varmenteen allekirjoittamiseen.
• -input_dir_path=<PATH>: Syötä hakemisto allekirjoitettaville PDF-tiedostoille, laskee hajautukset tai valitse allekirjoittamattomat tiedostot ja vastaavat hajautukset.
• -input_file_path=<PATH>: Allekirjoitettavan PDF-tiedoston polku.
• -otp=<OTP>: OAuth-OTP-arvo todennussovelluksesta.
• -output_dir_path=<PATH>: Hakemisto, johon allekirjoitetut PDF-tiedostot kirjoitetaan.
• -page_no=<PAGE_NUMBER>: PDF-asiakirjan sivu, jossa näkyvä allekirjoitus näkyy.
• -password=<PASSWORD>: SSL.com-tilin salasana.
• -sig_field_position=<X, Y, WIDTH, HEIGHT>: Näkyvän allekirjoituksen sijainti PDF-tiedostossa.
• -signing_location=<SIGNING_LOCATION>: Sijainti, jossa asiakirja allekirjoitetaan.
• signing_reason=<SIGNING_REASON>: Syy allekirjoittamiseen.
• -totp_secret=<TOTP_SECRET>: OAuth TOTP-salaisuus
• -username=<USERNAME>: SSL.com-tilin käyttäjänimi

DocSignTool-komennot

get_credential_ids

Tulosta luettelo tiettyyn käyttäjään liittyvistä eSigner-tunnistetunnuksista. Parametrit -username ja -password tarvitaan.

Käyttö: DocSignTool [-hV] get_credential_ids -username=<USERNAME> -password=<PASSWORD>

Esimerkiksi:

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

Syöttäminen DocSignTool get_credential_ids ilman vaadittuja parametreja näyttää komennon käyttötiedot.

tunnistetiedot

Tunnistetunnukseen liittyvät lähtöavaimen ja varmenteen tiedot. Parametrit -credential_id, -usernameja -password tarvitaan.

Käyttö: DocSignTool [-hV] credential_info -credential_id=<CREDENTIAL_ID> -username=<USERNAME> -password=<PASSWORD>

Esimerkiksi:

DocSignTool credential_info -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -username=john.doe@example.com -password="P0z9@lxo41" Allekirjoitusvarmenteen Aihe OSSL,OHJ: , L=Houston, ST=Texas, C=US – Sertifikaatin vanheneminen: la 11. helmikuuta 14:52:59 EST 2023 – Myöntäjän tunnusnumero: CN=SSL.com Asiakasvarmenne Keskitason CA RSA R2, O=SSL Corp, L=Houston , ST = Texas, C = US

Syöttäminen DocSignTool credential_info ilman vaadittuja parametreja näyttää komennon käyttötiedot.

merkki

Allekirjoita ja aikaleima PDF-tiedosto. Parametrit -username, -passwordja -input_file_path tarvitaan. -credential_id vaaditaan vain käyttäjille, joilla on useampi kuin yksi eSigner-asiakirjan allekirjoitusvarmenne. -output_dir_path, -signing_location, -signing-reason, -contact_info,  -sig_field_position, -page_noja -totp_secret ovat valinnaisia.

Käyttö: 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>]

Valinnaiset parametrit:

• If -credential_id on jätetty pois ja käyttäjällä on vain yksi eSigner-asiakirjan allekirjoitusvarmenne, DocSignTool käyttää sitä oletusarvoisesti. Jos käyttäjällä on useita asiakirjojen allekirjoitusvarmenteita, tämä parametri on pakollinen.
• If -output_dir_path on jätetty pois, tiedostossa määritetty tiedosto -input_file_path korvataan allekirjoitetulla tiedostolla. DocSignTool kehottaa käyttäjää ennen tiedoston korvaamista.
• If -signing_location määritetty sijainti lisätään digitaaliseen allekirjoitukseen.
• If -signing_reason on läsnä, määritetty allekirjoittamisen syy lisätään digitaaliseen allekirjoitukseen.
• If -contact_info määritetty teksti lisätään digitaaliseen allekirjoitukseen. Vaikka nämä tiedot sisältyvät allekirjoitukseen, näitä tietoja ei sisälly näkyvään allekirjoitusmerkintään (jos sellaisia ​​on).
• If -sig_field_position on näkyvissä, näkyvään allekirjoitusmerkintään lisätään asiakirja -page_no. Sijainti ja allekirjoitus tulee toimittaa muodossa "x, y, width, height".
• -page_no vaaditaan vain, kun luot näkyvän allekirjoituksen -sig_field_position ja määrittää asiakirjan sivun, jolla näkyvä allekirjoituksen merkintä näkyy.
• If -totp_secret on läsnä, DocSignTool laskee aikaperusteisen OTP: n allekirjoittamista varten, mikä mahdollistaa työkalun automaattisen käytön. Jos tätä parametria ei ole, käyttäjää pyydetään syöttämään OTP manuaalisesti.

Esimerkkejä:

Manuaalinen OTP-merkintä näkyvällä allekirjoituksella:

DocSignTool-merkki -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="asiakirjan hyväksyminen" -contact_info="support@ssl.com" Anna OTP - Jatka painamalla enter: 1 PDF allekirjoitettu onnistuneesti: output\test .pdf

Automatisoitu OTP-sukupolvi, ei näkyvää allekirjoitusta:

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

Syöttäminen DocSignTool sign ilman vaadittuja parametreja näyttää komennon käyttötiedot.

erän_merkki

Kirjoita ja leimaa jopa 100 PDF-tiedostoa yhdellä OTP: llä. Parametrit -username, -passwordja -input_dir_path tarvitaan. -credential_id vaaditaan vain käyttäjille, joilla on useampi kuin yksi eSigner-asiakirjan allekirjoitusvarmenne. -output_dir_path, -signing_location, -signing-reason, -contact_info,  -sig_field_position, -page_noja -totp_secret ovat valinnaisia.

Käyttö: 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>]

Valinnaiset parametrit:

• If -credential_id on jätetty pois ja käyttäjällä on vain yksi eSigner-asiakirjan allekirjoitusvarmenne, DocSignTool käyttää sitä oletusarvoisesti. Jos käyttäjällä on useita asiakirjojen allekirjoitusvarmenteita, tämä parametri on pakollinen.
• If -output_dir_path on jätetty pois, kohdassa määritetyt tiedostot -input_dir_path korvataan allekirjoitetuilla tiedostoilla. DocSignTool kehottaa käyttäjää ennen tiedostojen korvaamista.
• If -signing_location on läsnä, määritetty sijainti lisätään digitaalisiin allekirjoituksiin.
• If -signing_reason on läsnä, määritetty allekirjoittamisen syy lisätään digitaalisiin allekirjoituksiin.
• If -contact_info on läsnä, määritetty teksti lisätään digitaalisiin allekirjoituksiin. Vaikka nämä tiedot sisältyvät allekirjoitukseen, näitä tietoja ei sisälly näkyviin allekirjoitusten merkintöihin (jos niitä on).
• If -sig_field_position on näkyvissä, näkyvän allekirjoituksen merkintä lisätään asiakirjoihin -page_no. Sijainti ja allekirjoitus tulee toimittaa muodossa "x, y, width, height".
• -page_no vaaditaan vain, kun luot näkyvän allekirjoituksen -sig_field_position ja määrittää asiakirjojen sivun, jolla näkyvät allekirjoitusmerkinnät näkyvät.
• If -totp_secret on läsnä, DocSignTool laskee aikaperusteisen OTP: n allekirjoittamista varten, mikä mahdollistaa työkalun automaattisen käytön. Jos tätä parametria ei ole, käyttäjää pyydetään syöttämään OTP manuaalisesti.

Esimerkiksi:

DocSignTool batch_sign -username=john.doe@example.com -password="P0z9@lxo41" -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -input_dir_path=input_out_out= 100, 200" -page_no=150 -signing_location="Houston, Texas" -signing_reason="dokumentin hyväksyntä" -contact_info="support@ssl.com" Anna OTP - Jatka painamalla enter: 70 Erän allekirjoituskomento suoritettu onnistuneesti. Lähtöhakemisto allekirjoitetuille tiedostoille: lähtö

Syöttäminen DocSignTool batch_sign ilman vaadittuja parametreja näyttää komennon käyttötiedot.

hasis

Esilasketaan hash (t) myöhempää käyttöä varten batch_hash_sign komento. Parametrit -access_token ja -input_dir_path tarvitaan. -credential_id vaaditaan vain käyttäjille, joilla on useampi kuin yksi eSigner-asiakirjan allekirjoitusvarmenne. -signing_location, -signing-reason, -contact_info,  -sig_field_positionja -page_noovat valinnaisia.

Käyttö: 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>]

Valinnaiset parametrit:

• If -program_name on läsnä, kun allekirjoitat MSI-asennusohjelman, arvo näkyy vahvistusikkunassa ohjelman nimellä.
• If -signing_location määritetty sijainti lisätään digitaalisiin allekirjoituksiin, kun ne luodaan.
• If -signing_reason määritetty allekirjoittamisen syy lisätään digitaalisiin allekirjoituksiin, kun ne luodaan.
• If -contact_info on läsnä, määritetty teksti lisätään digitaalisiin merkintöihin, kun ne luodaan. Vaikka nämä tiedot sisältyvät allekirjoitukseen, näitä tietoja ei sisälly näkyviin allekirjoitusten merkintöihin (jos niitä on).
• If -sig_field_position on näkyvissä, näkyvän allekirjoituksen merkintä lisätään asiakirjoihin -page_no kun allekirjoitukset luodaan. Sijainti ja allekirjoitus tulee toimittaa muodossa "x, y, width, height".
• -page_no vaaditaan vain, kun luot näkyvän allekirjoituksen -sig_field_position ja määrittää asiakirjojen sivun, jolla näkyvät allekirjoitusmerkinnät näkyvät, kun ne luodaan.

Esimerkiksi:

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

Syöttäminen DocSignTool hash ilman vaadittuja parametreja näyttää komennon käyttötiedot.

batch_sign_hash

Kyltin hash (es) laskettu valmiiksi hash komento. Parametrit -access_token, input_dir_path, -otpja output_dir_path tarvitaan. -credential_id vaaditaan vain käyttäjille, joilla on useampi kuin yksi eSigner-asiakirjan allekirjoitusvarmenne.

Käyttö: DocSignTool [-hV] batch_sign_hash -access_token=<ACCESS_TOKEN> [-credential_id=<CREDENTIAL_ID>] -input_dir_path=<PATH> -output_dir_path=<PATH> -otp=<OTP>

Valinnaiset parametrit:

• If -credential_id on jätetty pois ja käyttäjällä on vain yksi eSigner-asiakirjan allekirjoitusvarmenne, DocSignTool käyttää sitä oletusarvoisesti. Jos käyttäjällä on useita asiakirjojen allekirjoitusvarmenteita, tämä parametri on pakollinen.

Esimerkiksi:

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

Syöttäminen DocSignTool batch_sign_hash ilman vaadittuja parametreja näyttää komennon käyttötiedot.

Kuinka testata DocSignToola hiekkalaatikkotilassa

1. Siirry DocSignTool-julkaisussa kohtaan conf kansio ja avaa doc_sign_tool.properties tiedosto
2. Kommentoi olemassa olevia ominaisuuksia lisäämällä # symboli ennen jokaista omaisuutta
3. Lisää tiedostoon seuraavat ominaisuudet:
   • 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. Tallenna tiedosto. Tallennuksen jälkeen DocSignToolia voidaan nyt käyttää hiekkalaatikkotilassa.
5. Voit siirtyä takaisin tuotantotilaan poistamalla kommentit olemassa olevista ominaisuuksista ja poistamalla hiekkalaatikon ominaisuudet.

Valinnainen: Muunna OV-asiakirjan allekirjoitussertifikaatti sulkuvarmenteeksi

Huomautus: Tämä osio on tarkoitettu vain käyttäjille, jotka haluavat tehdä tiivistämisen. Asiakirjojen allekirjoittamisen automatisoimiseksi ja kertakäyttöisten salasanojen (OTP) välttämiseksi käyttäjät muuntavat organisaation vahvistus (OV) -asiakirjan allekirjoitusvarmenteensa SSL.com-tileillään sulkevaksi varmenteeksi. Ohjeet ovat alla:

1. Napauta määräys SSL.com-tilisi ylävalikosta. 
2. Etsi sertifikaattisi ja napsauta download / tiedot linkki.
3. Valitse POISTA 2FA painiketta.