eSigner DocSignTool 명령 가이드

DocSign 도구 다음을 사용하여 PDF 파일에 원격으로 서명하기위한 안전한 개인 정보 보호 지향 다중 플랫폼 Java 명령 줄 유틸리티입니다. 전자 서명 문서 서명 인증서. 문서 자체가 전송되지 않도록 서명을 위해 문서의 해시가 SSL.com으로 전송됩니다. 이는 민감한 문서에 서명해야 하지만 서명을 위해 유선으로 전송해서는 안 되는 경우에 이상적입니다. DocSignTool은 또한 대량 서명 또는 기존 문서 작업흐름과의 통합을 위한 자동화된 일괄 프로세스에도 이상적입니다.

DocSignTool 설치

현재 버전의 DocSignTool을 설치하려면 OS에 맞는 올바른 파일을 다운로드하고 압축을 풉니 다.

• Windows
• Linux 및 macOS

Windows 다운로드에는 Java 런타임이 포함되어 있지만 Linux / macOS 버전을 사용하려면 컴퓨터에 Java 런타임을 설치해야합니다. Windows 버전의 명령은 배치 파일 (DocSignTool.bat) Linux / macOS 버전은 셸 스크립트 (DocSignTool.sh).

DocSignTool 사용 개요

용법: DocSignTool [-hV] [COMMAND] [PARAMETERS]

옵션 :

• -h, --help: 도움말 메시지를 표시하고 종료합니다.
• -V, --version: 버전 정보를 표시하고 종료합니다.

명령 :

• get_credential_ids: 특정 사용자와 관련된 전자 서명자 자격 증명 ID 목록을 출력합니다.
• credential_info: 자격 증명 ID와 관련된 키 및 인증서 정보를 출력합니다.
• sign: PDF 파일에 서명하고 타임 스탬프를 찍습니다.
• batch_sign: 하나의 OTP로 여러 PDF 파일에 서명하고 타임 스탬프합니다.
• hash: 나중에 사용할 수 있도록 해시를 미리 계산합니다. batch_hash_sign 명령.
• batch_sign_hash: 미리 계산 된 서명 해시 hash 명령.

매개 변수 :

• -access_token=<TOKEN>: OAuth 액세스 토큰.
• -contact_info=<CONTACT_INFO>: 연락처 정보.
• -credential_id=<CREDENTIAL_ID>: 인증서 서명을위한 자격 증명 ID입니다.
• -input_dir_path=<PATH>: 서명 할 PDF 파일의 디렉토리를 입력하거나, 해시를 계산하거나, 서명되지 않은 파일과 해당 해시를 선택하여 서명합니다.
• -input_file_path=<PATH>: 서명 할 PDF 파일의 경로입니다.
• -otp=<OTP>: 인증 앱의 OAuth OTP 값입니다.
• -output_dir_path=<PATH>: 서명 된 PDF 파일이 작성 될 디렉토리입니다.
• -page_no=<PAGE_NUMBER>: 서명이 보이는 PDF 문서의 페이지입니다.
• -password=<PASSWORD>: SSL.com 계정 비밀번호입니다.
• -sig_field_position=<X, Y, WIDTH, HEIGHT>: PDF에서 보이는 서명의 위치.
• -signing_location=<SIGNING_LOCATION>: 문서가 서명 된 위치입니다.
• signing_reason=<SIGNING_REASON>: 서명 이유.
• -totp_secret=<TOTP_SECRET>: OAuth TOTP 비밀
• -username=<USERNAME>: SSL.com 계정 사용자 이름

DocSignTool 명령

get_credential_ids

특정 사용자와 연관된 eSigner 신임 ID 목록을 출력하십시오. 매개 변수 -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 필수 매개 변수가 없으면 명령에 대한 사용법 정보가 표시됩니다.

credential_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 - 인증서 만료: Sat Feb 11 14:52:59 EST 2023 - 발급자 DN: CN=SSL.com 클라이언트 인증서 중간 CA RSA R2, O=SSL Corp, L=Houston , 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>]

선택적 매개 변수 :

• If -credential_id 생략되고 사용자에게 하나의 eSigner 문서 서명 인증서 만있는 경우 DocSignTool은 기본적으로이를 사용합니다. 사용자에게 둘 이상의 문서 서명 인증서가있는 경우이 매개 변수는 필수입니다.
• If -output_dir_path 생략 된 경우 -input_file_path 서명 된 파일로 덮어 씁니다. DocSignTool은 파일을 덮어 쓰기 전에 사용자에게 메시지를 표시합니다.
• If -signing_location 있는 경우 지정된 위치가 디지털 서명에 추가됩니다.
• If -signing_reason 있는 경우 지정된 서명 이유가 디지털 서명에 추가됩니다.
• If -contact_info 있는 경우 지정된 텍스트가 디지털 시가 처에 추가됩니다. 서명에 포함되어 있지만이 정보는 표시되는 서명 주석 (있는 경우)에 포함되지 않습니다.
• If -sig_field_position 표시되는 서명 주석이 지정된 페이지의 문서에 추가됩니다. -page_no. 직위와 서명은 형식으로 제공되어야합니다. "x, y, width, height".
• -page_no 보이는 서명을 만들 때만 필요합니다. -sig_field_position 표시되는 서명 주석이 표시 될 문서의 페이지를 지정합니다.
• If -totp_secret DocSignTool이 있으면 서명을위한 시간 기반 OTP를 계산하여 도구를 자동으로 사용할 수 있습니다. 이 매개 변수가 없으면 사용자에게 OTP를 수동으로 입력하라는 메시지가 표시됩니다.

예 :

가시적 서명이있는 수동 OTP 입력 :

DocSignTool 서명 -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, 70" -page_no=1 -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 필수 매개 변수가 없으면 명령에 대한 사용법 정보가 표시됩니다.

배치 _ 서명

하나의 OTP로 최대 100 개의 PDF 파일에 서명하고 타임 스탬프를 찍습니다. 매개 변수 -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>]

선택적 매개 변수 :

• If -credential_id 생략되고 사용자에게 하나의 eSigner 문서 서명 인증서 만있는 경우 DocSignTool은 기본적으로이를 사용합니다. 사용자에게 둘 이상의 문서 서명 인증서가있는 경우이 매개 변수는 필수입니다.
• If -output_dir_path 생략되면에 지정된 파일 -input_dir_path 서명 된 파일로 덮어 씁니다. DocSignTool은 파일을 덮어 쓰기 전에 사용자에게 메시지를 표시합니다.
• If -signing_location 있는 경우 지정된 위치가 디지털 서명에 추가됩니다.
• If -signing_reason 있는 경우 지정된 서명 이유가 디지털 서명에 추가됩니다.
• If -contact_info 있는 경우 지정된 텍스트가 디지털 시가 처에 추가됩니다. 이 정보는 서명에 포함되어 있지만 표시되는 서명 주석 (있는 경우)에는 포함되지 않습니다.
• If -sig_field_position 표시되는 서명 주석이 지정된 페이지의 문서에 추가됩니다. -page_no. 직위와 서명은 형식으로 제공되어야합니다. "x, y, width, height".
• -page_no 보이는 서명을 만들 때만 필요합니다. -sig_field_position 표시되는 서명 주석이 나타날 문서의 페이지를 지정합니다.
• If -totp_secret DocSignTool이 있으면 서명을위한 시간 기반 OTP를 계산하여 도구를 자동으로 사용할 수 있습니다. 이 매개 변수가 없으면 사용자에게 OTP를 수동으로 입력하라는 메시지가 표시됩니다.

예:

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 approved" -contact_info="support@ssl.com" OTP를 입력하세요. 계속하려면 enter를 누르세요: 455145 일괄 서명 명령이 성공적으로 실행되었습니다. 서명된 파일의 출력 디렉토리: output

입력 DocSignTool batch_sign 필수 매개 변수가 없으면 명령에 대한 사용법 정보가 표시됩니다.

해시

나중에 사용할 수 있도록 해시를 미리 계산합니다. 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>]

선택적 매개 변수 :

• If -program_name MSI 설치 프로그램에 서명 할 때이 값이 프로그램 이름으로 확인 대화 상자에 표시됩니다.
• If -signing_location 있는 경우 지정된 위치가 생성 될 때 디지털 서명에 추가됩니다.
• If -signing_reason 있는 경우 지정된 서명 이유가 생성 될 때 디지털 서명에 추가됩니다.
• If -contact_info 있는 경우 지정된 텍스트가 생성 될 때 디지털 시가 처에 추가됩니다. 이 정보는 서명에 포함되어 있지만 표시되는 서명 주석 (있는 경우)에는 포함되지 않습니다.
• If -sig_field_position 표시되는 서명 주석이 지정된 페이지의 문서에 추가됩니다. -page_no 서명이 생성 될 때. 직위와 서명은 형식으로 제공되어야합니다. "x, y, width, height".
• -page_no 보이는 서명을 만들 때만 필요합니다. -sig_field_position 표시되는 서명 어노테이션이 생성 될 때 표시 될 문서의 페이지를 지정합니다.

예:

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 필수 매개 변수가 없으면 명령에 대한 사용법 정보가 표시됩니다.

배치_서명_해시

미리 계산 된 서명 해시 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>

선택적 매개 변수 :

• If -credential_id 생략되고 사용자에게 하나의 eSigner 문서 서명 인증서 만있는 경우 DocSignTool은 기본적으로이를 사용합니다. 사용자에게 둘 이상의 문서 서명 인증서가있는 경우이 매개 변수는 필수입니다.

예:

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. 파일에 다음 속성을 추가합니다.
   • 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. 파일을 저장합니다. 저장 후 이제 DocSignTool을 샌드박스 모드에서 사용할 수 있습니다.
5. 프로덕션 모드로 다시 전환하려면 기존 속성의 주석 처리를 해제하고 샌드박스 속성을 삭제하세요.

선택 사항: OV 문서 서명 인증서를 봉인 인증서로 변환합니다.

참고 : 이 섹션은 씰링을 원하는 사용자만을 위한 것입니다.. 문서 서명을 자동화하고 OTP(일회용 비밀번호) 메시지가 표시되지 않도록 사용자는 OV(조직 유효성 검사) 문서 서명 인증서를 SSL.com 계정의 봉인 인증서로 자체 변환합니다. 지침은 다음과 같습니다.

1. 주문 SSL.com 계정의 상단 메뉴에 있습니다. 
2. 인증서를 찾아 다음을 클릭하세요. 다운로드 / 세부 사항 링크를 클릭하십시오.
3. 클릭 2FA 제거 버튼을 클릭합니다.