DocSignTool egy biztonságos, adatvédelem-orientált, több platformos Java parancssori segédprogram a PDF fájlok távoli aláírására a eAláíró dokumentum-aláíró tanúsítványok. A dokumentumok kivonatát a rendszer elküldi az SSL.com-nak aláírásra, így maga a dokumentum nem kerül elküldésre. Ez ideális olyan esetekben, amikor bizalmas dokumentumokat kell aláírni, de ne küldje el őket aláírásra. A DocSignTool ideális automatizált kötegelt folyamatokhoz is nagy mennyiségű aláíráshoz vagy meglévő dokumentum-munkafolyamatokba való integráláshoz.
Ha esignert szeretne használni a kód és a végrehajtható fájlok aláírására, kérjük olvassa el ezt a CodeSignTool útmutatót.
DocSignTool telepítés
A DocSignTool jelenlegi verziójának telepítéséhez egyszerűen töltse le és csomagolja ki az operációs rendszerhez tartozó megfelelő fájlt:
Ne feledje, hogy a Windows-letöltés tartalmazza a Java futási idejét, de a Linux / macOS verzióhoz Java futásidejű telepítés szükséges. A parancs Windows verziója kötegelt fájl (DocSignTool.bat
), a Linux / macOS verzió pedig shell parancsfájl (DocSignTool.sh
).
A DocSignTool használatának áttekintése
Használat: DocSignTool [-hV] [COMMAND] [PARAMETERS]
Opciók:
-h
,--help
: Súgó üzenet megjelenítése és kilépés.-V
,--version
: A verzióinformációk megjelenítése és kilépés.
parancsok:
get_credential_ids
: Adja meg az adott felhasználóhoz társított eSigner hitelesítő adatok azonosítóinak listáját.credential_info
: A hitelesítő adatok azonosítójához kapcsolódó kimeneti kulcs és tanúsítvány adatai.sign
: Jel és időbélyeg PDF filr.batch_sign
: Több PDF fájl aláírása és időbélyegzése egy OTP-vel.hash
: Előre kiszámítja a kivonatokat, hogy később felhasználhassa őketbatch_hash_sign
parancs.batch_sign_hash
: Jelkivonat (ok) előre kiszámítvahash
parancs.
paraméterek:
-access_token=<TOKEN>
: OAuth hozzáférési token.-contact_info=<CONTACT_INFO>
: Elérhetőség.-credential_id=<CREDENTIAL_ID>
: Hitelesítő azonosító a tanúsítvány aláírásához.-input_dir_path=<PATH>
: Írja be az aláírandó PDF fájlok könyvtárát, számolja ki a kivonatokat, vagy válasszon aláíratlan fájlokat és a megfelelő kivonatokat az aláíráshoz.-input_file_path=<PATH>
: Aláírandó PDF fájl elérési útja.-otp=<OTP>
: OAuth OTP-érték a hitelesítési alkalmazásból.-output_dir_path=<PATH>
: Könyvtár, ahova az aláírt PDF fájl (ok) íródnak.-page_no=<PAGE_NUMBER>
: A PDF dokumentum oldala, ahol látható aláírás jelenik meg.-password=<PASSWORD>
: SSL.com fiók jelszó.-sig_field_position=<X, Y, WIDTH, HEIGHT>
: A látható aláírás helye a PDF-en.-signing_location=<SIGNING_LOCATION>
: A dokumentum aláírásának helye.signing_reason=<SIGNING_REASON>
: Az aláírás oka.-totp_secret=<TOTP_SECRET>
: OAuth TOTP titok-username=<USERNAME>
: SSL.com fiók felhasználónév
-password="P!@^^ssword12"
).DocSignTool parancsok
get_credential_ids
Adja meg az adott felhasználóhoz társított eSigner hitelesítő adatok azonosítóinak listáját. Paraméterek -username
és a -password
szükségesek.
Használat: DocSignTool [-hV] get_credential_ids -username=<USERNAME> -password=<PASSWORD>
Példa:
DocSignTool get_credential_ids -username=john.doe@example.com -password="P0z9@lxo41" Credential ID(s): - fe537ace-e132-52a9-c2e7-egcd2ac3f1e6
Belépés DocSignTool get_credential_ids
a szükséges paraméterek nélkül megjeleníti a parancs használati információit.
hitelesítő_info
A hitelesítő adatok azonosítójával kapcsolatos kimeneti kulcs és tanúsítvány adatai. Paraméterek -credential_id
, -username
és -password
szükségesek.
Használat: DocSignTool [-hV] credential_info -credential_id=<CREDENTIAL_ID> -username=<USERNAME> -password=<PASSWORD>
Példa:
DocSignTool credential_info -credential_id=fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -username=john.doe@example.com -password="P0z9@lxo41" Aláíró tanúsítvány = ODNSSL, CNJ, Tárgy információ: , L=Houston, ST=Texas, C=USA – Tanúsítvány lejárata: Szo Feb 11, 14:52:59 EST 2023 – Kibocsátó DN: CN=SSL.com Ügyféltanúsítvány Középfokú CA RSA R2, O=SSL Corp, L=Houston , ST=Texas, C=US
Belépés DocSignTool credential_info
a szükséges paraméterek nélkül megjeleníti a parancs használati információit.
<p></p>
Aláírás és időbélyeg PDF fájl. Paraméterek -username
, -password
és -input_file_path
szükségesek. -credential_id
csak egynél több eSigner dokumentum-aláíró tanúsítvánnyal rendelkező felhasználók számára szükséges. -output_dir_path
, -signing_location
, -signing-reason
, -contact_info
, -sig_field_position
, -page_no
és -totp_secret
választhatóak.
Használat: 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>]
Opcionális paraméterek:
- If
-credential_id
el van hagyva, és a felhasználónak csak egy eSigner dokumentum-aláíró tanúsítványa van, a DocSignTool alapértelmezés szerint ezt állítja be. Ha a felhasználónak több dokumentum-aláíró tanúsítványa van, akkor ez a paraméter kötelező. - If
-output_dir_path
el van hagyva, a fájlban megadott fájl-input_file_path
felülíródik az aláírt fájllal. A DocSignTool felszólítja a felhasználót, mielőtt felülírná a fájlt. - If
-signing_location
jelen van, a megadott hely hozzáadódik a digitális aláíráshoz. - If
-signing_reason
jelen van, a megadott aláírás oka bekerül a digitális aláírásba. - If
-contact_info
jelen van, a megadott szöveg hozzáadódik a digitális aláíráshoz. Bár az aláírással együtt szerepelnek, ezeket az információkat nem tartalmazzák a látható aláírási kommentárok (ha vannak). - If
-sig_field_position
jelen van, látható aláírási kommentár kerül a dokumentumhoz az által megadott oldalon-page_no
. A pozíciót és az aláírást formátumban kell megadni"x, y, width, height"
. -page_no
csak akkor szükséges, ha látható aláírást hoz létre a-sig_field_position
és meghatározza a dokumentum azon oldalát, amelyen a látható aláírási feljegyzés megjelenik.- If
-totp_secret
jelen van, a DocSignTool kiszámítja az időalapú OTP-t az aláíráshoz, lehetővé téve az eszköz automatizált használatát. Ha ez a paraméter nincs megadva, a felhasználó kéri az OTP kézi beírását.
Példák:
Kézi OTP bevitel látható aláírással:
DocSignTool jel -credential_id = fe537ace-e132-52a9-c2e7-egcd2ac3f1e6 -felhasználónév=john.doe@example.com -password = "P0z9 @ lxo41" -output_dir_path = aláírt -input_fájl_path = teszt.pdf = 100.pdf -sig " 200, 150 "-page_no = 70 -signing_location =" Houston, Texas "-signing_reason =" dokumentum jóváhagyása "-contact_info ="support@ssl.com"Írja be az OTP-t - nyomja meg az Enter billentyűt a folytatáshoz: 884646 PDF sikeresen aláírva: output \ test.pdf
Automatizált OTP-generálás, látható aláírás nélkül:
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
Belépés DocSignTool sign
a szükséges paraméterek nélkül megjeleníti a parancs használati információit.
Error: invalid otp
egy fájl aláírásának megkísérlésekor a következő problémák egy vagy több oka lehet:
- A hitelesítő alkalmazásba beolvasott QR-kód nem egyezik meg a parancs felhasználónevével, jelszavával és / vagy hitelesítő adatainak azonosítójával. Ez akkor történhet meg, ha:
- Több fiókja van konfigurálva a 2FA-hoz az eszközén, és rosszat választott.
- Ön megpróbálja használni a bejelentkezési adatait a megosztott tanúsítvány, de beolvasott egy QR-kódot, amelyet egy csapattárs osztott meg a fiókjából.
- A beírt OTP már lejárt.
- A parancs érvénytelen TOTP titkot tartalmaz.
kötegelt_jel
Legfeljebb 100 PDF fájl aláírása és időbélyegzése egy OTP segítségével. Paraméterek -username
, -password
és -input_dir_path
szükségesek. -credential_id
csak egynél több eSigner dokumentum-aláíró tanúsítvánnyal rendelkező felhasználók számára szükséges. -output_dir_path
, -signing_location
, -signing-reason
, -contact_info
, -sig_field_position
, -page_no
és -totp_secret
választhatóak.
Használat: 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>]
Opcionális paraméterek:
- If
-credential_id
el van hagyva, és a felhasználónak csak egy eSigner dokumentum-aláíró tanúsítványa van, a DocSignTool alapértelmezés szerint ezt állítja be. Ha a felhasználónak több dokumentum-aláíró tanúsítványa van, akkor ez a paraméter kötelező. - If
-output_dir_path
el van hagyva, a fájlban megadott fájlok-input_dir_path
felülíródik az aláírt fájlokkal. A DocSignTool felszólítja a felhasználót, mielőtt felülírná a fájlokat. - If
-signing_location
jelen van, a megadott hely hozzáadódik a digitális aláírásokhoz. - If
-signing_reason
jelen van, a megadott aláírás oka bekerül a digitális aláírásokba. - If
-contact_info
jelen van, a megadott szöveg hozzáadódik a digitális jelekhez. Bár az aláírással együtt szerepelnek, ezeket az információkat nem tartalmazzák a látható aláírási megjegyzések (ha vannak). - If
-sig_field_position
jelen van, látható aláírási kommentár kerül a dokumentumokhoz az által megadott oldalon-page_no
. A pozíciót és az aláírást formátumban kell megadni"x, y, width, height"
. -page_no
csak akkor szükséges, ha látható aláírást hoz létre a-sig_field_position
és meghatározza a dokumentumok azon oldalát, amelyen a látható aláírási kommentárok megjelennek.- If
-totp_secret
jelen van, a DocSignTool kiszámítja az időalapú OTP-t az aláíráshoz, lehetővé téve az eszköz automatizált használatát. Ha ez a paraméter nincs megadva, a felhasználó kéri az OTP kézi beírását.
Példa:
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"Írja be az OTP-t - nyomja meg az Entert a folytatáshoz: 455145 Kötegelt aláírás parancs sikeres végrehajtása. Kimeneti könyvtár az aláírt fájlokhoz: output
Belépés DocSignTool batch_sign
a szükséges paraméterek nélkül megjeleníti a parancs használati információit.
hash
- A PDF-könyvtárra szükség van a PDF-nek a hash-bevitelhez való manipulálásához, majd a PKCS#7 beágyazásához a PDF-dokumentumba. (pl. ApachePDFBox Java nyelven).
- Kriptokönyvtár PKCS#7 létrehozásához az eSigner API-tól kapott nyers aláírásokból (pl. BouncyCastle Java nyelven).
Előre kiszámítja a kivonatokat, hogy később felhasználhassa őket batch_hash_sign
parancs. Paraméterek -access_token
és a -input_dir_path
szükségesek. -credential_id
csak egynél több eSigner dokumentum-aláíró tanúsítvánnyal rendelkező felhasználók számára szükséges. -signing_location
, -signing-reason
, -contact_info
, -sig_field_position
és -page_no
, nem kötelezőek.
Használat: 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>]
Opcionális paraméterek:
- If
-program_name
jelen van az MSI telepítő aláírásakor, az érték a megerősítő párbeszédpanelen jelenik meg programnévként. - If
-signing_location
jelen van, a megadott hely hozzáadásra kerül a digitális aláírásokhoz, amikor létrehozzák őket. - If
-signing_reason
jelen van, a megadott aláírás oka a létrehozáskor hozzáadódik a digitális aláírásokhoz. - If
-contact_info
jelen van, akkor a megadott szöveg a digitális jelekhez kerül hozzáadásukkor. Bár az aláírással együtt szerepelnek, ezeket az információkat nem tartalmazzák a látható aláírási megjegyzések (ha vannak). - If
-sig_field_position
jelen van, látható aláírási kommentár kerül a dokumentumokhoz az által megadott oldalon-page_no
amikor az aláírások keletkeznek. A pozíciót és az aláírást formátumban kell megadni"x, y, width, height"
. -page_no
csak akkor szükséges, ha látható aláírást hoz létre a-sig_field_position
és meghatározza a dokumentumok azon oldalát, amelyen a látható aláírási kommentárok megjelennek a létrehozásukkor.
Példa:
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
Belépés DocSignTool hash
a szükséges paraméterek nélkül megjeleníti a parancs használati információit.
batch_sign_hash
Jelkivonat (ok) előre kiszámítva hash
parancs. Paraméterek -access_token
, input_dir_path
, -otp
és output_dir_path
szükségesek. -credential_id
csak egynél több eSigner dokumentum-aláíró tanúsítvánnyal rendelkező felhasználók számára szükséges.
Használat: DocSignTool [-hV] batch_sign_hash -access_token=<ACCESS_TOKEN> [-credential_id=<CREDENTIAL_ID>] -input_dir_path=<PATH> -output_dir_path=<PATH> -otp=<OTP>
Opcionális paraméterek:
- If
-credential_id
el van hagyva, és a felhasználónak csak egy eSigner dokumentum-aláíró tanúsítványa van, a DocSignTool alapértelmezés szerint ezt állítja be. Ha a felhasználónak több dokumentum-aláíró tanúsítványa van, akkor ez a paraméter kötelező.
Példa:
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
Belépés DocSignTool batch_sign_hash
a szükséges paraméterek nélkül megjeleníti a parancs használati információit.
A DocSignTool tesztelése sandbox módban
- A DocSignTool kiadásában lépjen a következőre:
conf
mappát és nyissa megdoc_sign_tool.properties
filé - Írja megjegyzésbe a meglévő tulajdonságokat hozzáadással
#
szimbólum minden tulajdonság előtt - Adja hozzá a következő tulajdonságokat a fájlhoz:
CLIENT_ID
=qOUeZCCzSqgA93acB3LYq6lBNjgZdiOxQc-KayC3UMwOAUTH2_ENDPOINT
=https://oauth-sandbox.ssl.com/oauth2/tokenCSC_API_ENDPOINT
=https://cs-try.ssl.comTSA_URL
=http://ts.ssl.com
- Mentse el a fájlt. Mentés után a DocSignTool már használható sandbox módban.
- Az éles módba való visszatéréshez törölje a meglévő tulajdonságok megjegyzését, és törölje a sandbox tulajdonságait.
Nem kötelező: Alakítsa át az OV-dokumentum-aláíró tanúsítványt lezáró tanúsítványra
Jegyzet: Ez a rész csak azoknak a felhasználóknak szól, akik tömítést szeretnének végezni. A dokumentumok aláírásának automatizálása érdekében, és ne az egyszeri jelszavak (OTP) kérjék őket, a felhasználók saját maguk alakítják át szervezetellenőrzési (OV) dokumentum-aláíró tanúsítványukat lezáró tanúsítványra az SSL.com-fiókjukon. Az utasítások alább találhatók:
- Kattints Megrendelés SSL.com-fiókja felső menüjében.
- Keresse meg a tanúsítványt, és kattintson a gombra letöltés / részletek link.
- Kattintson az 2FA eltávolítása gombot.