SignTool

  • 아티클

SignTool은 파일에 디지털 서명하고, 파일의 서명을 확인하고, 타임스탬프를 만드는 명령줄 도구입니다. 서명 파일이 중요한 이유에 대한 자세한 내용은 코드 서명 소개를 참조하세요.

이 도구는 Microsoft SDK(Windows 소프트웨어 개발 키트) 설치 경로의 \Bin 폴더에 설치됩니다(예: C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64\signtool.exe.

SignTool은 Windows SDK에서 다운로드할 수 있는 Windows SDK의 일부로 사용할 수 있습니다.

참고

Windows 10 SDK, Windows 10 HLK, Windows 10 WDK 및 Windows 10 ADK 빌드 20236 이상에서는 다이제스트 알고리즘을 지정해야 합니다. SignTool sign 명령을 사용하려면 서명 및 타임스탬프를 각각 지정하는 동안 파일 다이제스트 알고리즘 옵션(/fd)과 타임스탬핑 다이제스트 알고리즘 옵션(/td)이 필요합니다.

서명 중에 가 지정되지 않고 타임스탬프를 지정하는 동안 지정되지 않은 경우 /fd/td 명령은 처음에 경고 오류 코드 0을 throw합니다. 이후 버전의 SignTool에서는 경고가 오류가 됩니다. SHA256을 사용하는 것이 좋습니다. 업계에서 SHA1보다 더 안전한 것으로 간주됩니다.

구문

signtool [command] [options] [file_name | ...]

매개 변수

인수 Description
command 파일 catdb에서 수행할 작업을 지정하는 네 가지 명령 중 하나인 , sign, timestamp또는 verify입니다. 각 명령의 설명에 대해서는 다음 표를 참조하세요.
options 명령을 수정하는 옵션입니다. 전역 /q 및 /v 옵션 이외에도 각 명령은 고유한 옵션 집합을 지원합니다.
file_name 서명할 파일 경로입니다.

SignTool은 다음 명령을 지원합니다.

명령 설명
catdb 카탈로그 데이터베이스에서 카탈로그 파일을 추가하거나 제거합니다. 카탈로그 데이터베이스는 카탈로그 파일의 자동 조회에 사용되며 GUID를 통해 식별됩니다. 명령에서 지원하는 catdb 옵션 목록은 catdb 명령 옵션을 참조하세요.
sign 파일에 디지털 서명을 수행합니다. 디지털 서명은 파일이 변조되지 않도록 보호하고 사용자가 서명 인증서를 기반으로 서명자를 확인할 수 있도록 합니다. 명령에서 지원하는 sign 옵션 목록은 명령 옵션 서명을 참조하세요.
timestamp 타임스탬프는 파일입니다. 명령에서 지원하는 timestamp 옵션 목록은 타임스탬프 명령 옵션을 참조하세요.
verify 파일의 디지털 서명을 확인합니다. 신뢰할 수 있는 기관에서 서명 인증서를 발급했는지 여부, 서명 인증서가 해지되었는지 여부 및 필요에 따라 서명 인증서가 특정 정책에 유효한지 여부를 결정합니다. 명령에서 지원하는 verify 옵션 목록은 명령 옵션 확인을 참조하세요.

다음 옵션은 모든 SignTool 명령에 적용됩니다.

전역 옵션 설명
/q 명령이 성공적으로 실행되는 경우 출력을 표시하지 않고, 명령이 실패하는 경우 최소 출력을 표시합니다.
/v 명령이 성공적으로 실행되는지 또는 실패하는지 여부와 상관없이 자세한 정보 출력을 표시하고 경고 메시지를 표시합니다.
/debug 디버깅 정보를 표시합니다.

Catdb 명령 옵션

다음 표에는 catdb 명령에 사용할 수 있는 옵션이 나열되어 있습니다.

Catdb 옵션 설명
/d 기본 카탈로그 데이터베이스가 업데이트되도록 지정합니다. 또는 /g를 사용하지 /d 않는 경우 SignTool은 시스템 구성 요소 및 드라이버 데이터베이스를 업데이트합니다.
/gGUID GUID로 식별된 카탈로그 데이터베이스가 업데이트되도록 지정합니다.
/r 카탈로그 데이터베이스에서 지정된 카탈로그를 제거합니다. 이 옵션을 지정하지 않으면 SignTool은 카탈로그 데이터베이스에 지정된 카탈로그를 추가합니다.
/u 추가된 카탈로그 파일에 대해 고유한 이름이 자동으로 생성되도록 지정합니다. 필요한 경우 기존 카탈로그 파일과의 이름 충돌을 방지하기 위해 카탈로그 파일의 이름을 바꿉니다. 이 옵션을 지정하지 않으면 SignTool은 지정된 카탈로그와 이름이 같은 기존 카탈로그를 덮어씁니다.

참고

카탈로그 데이터베이스는 카탈로그 파일의 자동 조회에 사용됩니다.

Sign 명령 옵션

다음 표에는 sign 명령에 사용할 수 있는 옵션이 나열되어 있습니다.

Sign 명령 옵션 설명
/a 가장 적합한 서명 인증서를 자동으로 선택합니다. SignTool은 지정된 모든 조건을 충족하는 모든 유효한 인증서를 찾고 가장 오랫동안 유효한 인증서를 선택합니다. 이 옵션이 없으면 SignTool은 유효한 서명 인증서를 하나만 찾아야 합니다.
/acfile 파일의 다른 인증서를 서명 블록에 추가합니다.
/as 이 서명을 추가합니다. 기본 서명이 없는 경우 이 서명은 대신 기본 서명이 됩니다.
/cCertTemplateName 서명 인증서의 인증서 템플릿 이름(Microsoft 확장명)을 지정합니다.
/cspCSPName 프라이빗 키 컨테이너를 포함하는 CSP(암호화 서비스 공급자)를 지정합니다.
/dDesc 서명된 콘텐츠에 대한 설명을 지정합니다.
/dg경로 서명할 다이제스트와 서명되지 않은 PKCS7 파일을 생성합니다. 출력 다이제스트 및 PKCS7 파일은 Path>\<FileName.dig> 및 Path\FileName.p7u<>입니다.<>< 추가 XML 파일을 출력하려면 를 사용합니다 /dxml.
/di경로 서명되지 않은 PKCS7 파일에 서명된 다이제스트를 수집하여 서명을 만듭니다. 입력 서명된 다이제스트 및 서명되지 않은 PKCS7 파일은 Path>\<FileName.dig.signed> 및 Path\FileName.p7u여야 합니다<.><><
/dlibDll 다이제스트에 서명할 함수를 AuthenticodeDigestSign 구현하는 DLL을 지정합니다. 이 옵션은 , /ds및 /di 옵션과 함께 SignTool을 /dg별도로 사용하는 것과 같습니다. 이 옵션은 세 가지를 모두 하나의 원자성 연산으로 호출합니다.
/dmdf파일 옵션과 함께 /dg 사용하면 파일의 내용을 수정하지 않고 함수에 AuthenticodeDigestSign 전달합니다.
/ds 다이제스트에만 서명합니다. 입력 파일은 옵션에서 생성된 다이제스트 /dg 여야 합니다. 출력 파일은 File.signed>입니다<.
/duURL 서명한 콘텐츠의 부연 설명에 대한 URL(Uniform Resource Locator)을 지정합니다.
/dxml 옵션과 함께 /dg 사용할 경우 는 XML 파일을 생성합니다. 출력 파일은 Path>\<FileName>.dig.xml입니다<.
/fSignCertFile 파일에 있는 서명 인증서를 지정합니다. 파일이 PFX(개인 정보 교환) 형식이면서 암호로 보호되는 경우, /p 옵션을 사용하여 암호를 지정합니다. 파일에 프라이빗 키가 없는 경우 및 /kc 옵션을 사용하여 /csp CSP 및 프라이빗 키 컨테이너 이름을 지정합니다.
/fdalg 파일 서명을 만드는 데 사용할 파일 다이제스트 알고리즘을 지정합니다. 참고: 서명하는 /fd 동안 옵션을 지정하지 않으면 명령에서 오류가 발생합니다.
/fd certHash "certHash" 문자열을 지정하면 명령이 서명 인증서에 지정된 알고리즘을 사용합니다. 참고: 서명하는 /fd 동안 옵션을 지정하지 않으면 명령에서 오류가 발생합니다.
/iIssuerName 서명 인증서의 발급자 이름을 지정합니다. 이 값은 발급자의 전체 이름에서 부분 문자열이 될 수 있습니다.
/kcPrivKeyContainerName 프라이빗 키 컨테이너 이름을 지정합니다.
/nSubjectName 서명 인증서의 주체 이름을 지정합니다. 이 값은 주체의 전체 이름에서 부분 문자열이 될 수 있습니다.
/nph 지원되는 경우 실행 파일에 대한 페이지 해시를 억제합니다. 기본값은 SIGNTOOL_PAGE_HASHES 환경 변수 및 wintrust.dll 버전에 따라 결정됩니다. PE 파일이 아닌 경우 이 옵션이 무시됩니다.
/pPassword PFX 파일을 열 때 사용할 암호를 지정합니다. 옵션을 /f 사용하여 PFX 파일을 지정합니다.
/p7경로 지정된 각 콘텐츠 파일에 대한 PKCS(공개 키 암호화 표준) #7 파일이 생성되도록 지정합니다. PKCS #7 파일의 이름은 <path>\<filename.p7>입니다.
/p7ceValue 서명된 PKCS #7 콘텐츠에 대한 옵션을 지정합니다. PKCS #7 파일에 서명된 콘텐츠를 포함하거나 분리된 PKCS #7 파일의 서명된 데이터 부분을 생성하려면 DetachedSignedData값을Embedded 로 설정합니다. /p7ce 옵션을 지정하지 않으면 기본적으로 서명된 콘텐츠가 포함됩니다.
/p7co<OID> 서명된 PKCS #7 콘텐츠를 식별하는 OID(개체 식별자)를 지정합니다.
/ph 지원되지 않는 경우 실행 파일에 대한 페이지 해시를 생성합니다.
/rRootSubjectName 서명 인증서와 연결해야 하는 루트 인증서의 주체 이름을 지정합니다. 이 값은 루트 인증서 주체의 전체 이름에서 부분 문자열이 될 수 있습니다.
/sStoreName 명령이 인증서를 검색할 때 열 저장소를 지정합니다. 이 옵션을 지정하지 않으면 명령은 저장소를 My 엽니다.
/sha1해시 서명 인증서의 SHA1 해시를 지정합니다. SHA1 해시는 여러 인증서가 나머지 옵션에 지정된 조건을 충족하는 경우에 일반적으로 사용됩니다.
/sm 명령이 사용자 저장소 대신 머신 저장소를 사용하게 지정합니다.
/tURL 타임스탬프 서버의 URL을 지정합니다. 이 옵션 또는 /tr 이 지정되지 않은 경우 서명된 파일은 타임스탬프를 지정하지 않습니다. 타임스탬핑이 실패하면 명령은 경고를 생성합니다. 이 옵션은 옵션과 함께 /tr 사용할 수 없습니다.
/tdalg /tr 옵션을 사용하여 RFC 3161 타임스탬프 서버에서 사용하는 다이제스트 알고리즘을 요청합니다. 참고: 타임스탬프를 지정하는 동안 지정되지 않은 경우 /td 명령은 오류를 생성합니다.
/trURL RFC 3161 타임스탬프 서버의 URL을 지정합니다. 이 옵션 또는 /t 이 지정되지 않은 경우 서명된 파일은 타임스탬프를 지정하지 않습니다. 타임스탬핑이 실패하면 명령은 경고를 생성합니다. 이 옵션은 옵션과 함께 /t 사용할 수 없습니다.
/uUsage EKU(확장된 키 사용)가 서명 인증서에 있도록 지정합니다. 용도 값은 OID 또는 문자열로 지정될 수 있습니다. 기본 사용법은 또는 1.3.6.1.5.5.7.3.3입니다Code Signing.
/uw 또는 1.3.6.1.4.1.311.10.3.6의 Windows System Component Verification 사용을 지정합니다.

사용 예제는 SignTool을 사용하여 파일에 서명을 참조하세요.

타임스탬프 명령 옵션

다음 표에는 timestamp 명령에 사용할 수 있는 옵션이 나열되어 있습니다.

타임스탬프 옵션 설명
/p7 파일에 PKCS #7 타임스탬프를 기록합니다.
/tURL 타임스탬프 서버의 URL을 지정합니다. 타임스탬프가 기록되는 파일은 이전에 서명되었어야 합니다. /t 또는 /tr 옵션이 필요합니다.
/tdalg /tr 옵션을 사용하여 RFC 3161 타임스탬프 서버에서 사용하는 다이제스트 알고리즘을 요청합니다. 참고: 타임스탬프를 지정하는 동안 지정되지 않은 경우 /td 명령은 경고를 생성합니다.
/tpindex index에서 시그니처에 타임스탬프를 지정합니다.
/trURL RFC 3161 타임스탬프 서버의 URL을 지정합니다. 타임스탬프가 기록되는 파일은 이전에 서명되었어야 합니다. /tr 또는 /t 옵션이 필요합니다.

명령 옵션 확인

옵션 확인 설명
/a 모든 메서드를 사용하여 파일을 확인할 수 있도록 지정합니다. 먼저 SignTool은 카탈로그 데이터베이스를 검색하여 파일이 카탈로그에 로그인되어 있는지 여부를 확인합니다. 파일이 카탈로그에 서명되지 않은 경우 SignTool은 파일의 포함된 서명을 확인하려고 시도합니다. 카탈로그에서 서명되거나 서명되지 않을 수 있는 파일을 확인할 때 이 옵션을 사용하는 것이 좋습니다. 서명되거나 서명되지 않을 수 있는 파일의 예로는 Windows 파일 또는 드라이버가 있습니다.
/ad 기본 카탈로그 데이터베이스를 사용하여 카탈로그를 찾습니다.
/all 여러 서명이 있는 파일의 모든 서명을 확인합니다.
/as 시스템 구성 요소(드라이버) 카탈로그 데이터베이스를 사용하여 해당 카탈로그를 찾습니다.
/agCatDBGUID GUID로 식별된 카탈로그 데이터베이스에서 카탈로그를 찾습니다.
/cCatFile 이름별로 카탈로그 파일을 지정합니다.
/d 설명 및 설명 URL을 인쇄합니다. Windows Vista 및 이전 버전: 이 옵션은 지원되지 않습니다.
/dsIndex 특정 위치에서 서명을 확인합니다.
/hash{SHA1|SHA256} 카탈로그에서 파일을 검색할 때 사용할 선택적 해시 알고리즘을 지정합니다.
/kp x64 커널 모드 드라이버 서명 정책을 사용하여 확인을 수행합니다.
/ms 여러 확인 의미 체계를 사용합니다. 이 동작은 WinVerifyTrust 호출의 기본값입니다.
/oVersion 운영 체제 버전별로 파일을 확인합니다. version 매개 변수는 PlatformID>:<VerMajor> 형식<입니다.< VerMinor>.< BuildNumber>. 옵션을 사용하는 /o 것이 좋습니다. 를 지정하지 않으면 /o SignTool에서 예기치 않은 결과를 반환할 수 있습니다. 예를 들어 를 포함하지 /o않는 경우 이전 운영 체제에서 올바르게 유효성을 검사하는 시스템 카탈로그가 최신 운영 체제에서 올바르게 유효성을 검사하지 못할 수 있습니다.
/p7 PKCS #7 파일을 확인합니다. PKCS #7 유효성 검사에 기존 정책이 사용되지 않습니다. SignTool은 서명을 확인하고 서명 인증서에 대한 체인을 빌드합니다.
/pa 기본 인증 확인 정책이 사용되도록 지정합니다. /pa 옵션을 지정하지 않으면 SignTool은 Windows 드라이버 확인 정책을 사용합니다. 이 옵션은 옵션과 함께 catdb 사용할 수 없습니다.
/pgPolicyGUID GUID를 기준으로 확인 정책을 지정합니다. GUID는 확인 정책의 에 해당합니다 ActionID . 이 옵션은 옵션과 함께 catdb 사용할 수 없습니다.
/ph 페이지 해시 값을 인쇄하고 확인합니다. Windows Vista 및 이전 버전: 이 옵션은 지원되지 않습니다.
/rRootSubjectName 서명 인증서와 연결해야 하는 루트 인증서의 주체 이름을 지정합니다. 이 값은 루트 인증서 주체의 전체 이름에서 부분 문자열이 될 수 있습니다.
/tw 서명에 타임스탬프를 지정하지 않으면 명령이 경고를 생성할 수 있도록 지정합니다.

SignTool verify 명령은 신뢰할 수 있는 기관에서 서명 인증서를 발급했는지 여부, 서명 인증서가 해지되었는지 여부 및 필요에 따라 서명 인증서가 특정 정책에 유효한지 여부를 결정합니다.

SignTool verify 명령은 , , /ad/as, /ag또는 /c와 같은 /a카탈로그를 검색하는 옵션을 지정하지 않는 한 포함된 서명 상태 출력합니다.

반환 값

SignTool은 종료 시 다음 종료 코드 중 하나를 반환합니다.

종료 코드 설명
0 실행이 완료되었습니다.
1 실행하지 못했습니다.
2 실행이 경고와 함께 완료되었습니다.

예

다음 명령은 MyCatalogFileName.cat 카탈로그 파일을 시스템 구성 요소 및 드라이버 데이터베이스에 추가합니다. 이 /u 옵션은 필요한 경우 고유한 이름을 생성하여 MyCatalogFileName.cat 라는 기존 카탈로그 파일을 대체하지 못하도록 합니다.

signtool catdb /v /u MyCatalogFileName.cat

다음 명령은 가장 적합한 인증서를 사용하여 파일에 자동으로 서명합니다.

signtool sign /a /fd SHA256 MyFile.exe

다음 명령은 암호로 보호된 PFX 파일에 저장된 인증서를 사용하여 파일에 디지털 서명을 합니다.

signtool sign /f MyCert.pfx /p MyPassword /fd SHA256 MyFile.exe

다음 명령은 파일을 디지털 서명하고 타임스탬프를 지정합니다. 파일에 서명하는 데 사용할 인증서는 PFX 파일로 저장됩니다.

signtool sign /f MyCert.pfx /t http://timestamp.digicert.com /fd SHA256 MyFile.exe

다음 명령은 My의 주체 이름이 있는 My Company Certificate 저장소에 위치한 인증서를 사용하여 파일에 서명합니다.

signtool sign /n "My Company Certificate" /fd SHA256 MyFile.exe

다음 명령은 ActiveX 컨트롤에 서명하고 사용자에게 컨트롤을 설치하라는 메시지가 표시되면 브라우저에 표시되는 정보를 제공합니다.

signtool sign /f MyCert.pfx /d: "MyControl" /du http://www.example.com/MyControl/info.html /fd SHA256 MyControl.exe

다음 명령은 이미 디지털 서명된 파일을 타임스탬프로 지정합니다.

signtool timestamp /t http://timestamp.digicert.com MyFile.exe

다음 명령은 RFC 3161 타임스탬프를 사용하여 파일을 타임스탬프로 지정합니다.

signtool timestamp /tr http://timestamp.digicert.com /td SHA256 MyFile.exe

다음 명령은 파일이 서명되었는지를 확인합니다.

signtool verify MyFile.exe

다음 명령은 카탈로그에 서명할 수 있는 시스템 파일을 확인합니다.

signtool verify /a SystemFile.dll

다음 명령은 MyCatalog.cat라는 카탈로그에서 서명된 시스템 파일을 확인합니다.

signtool verify /c MyCatalog.cat SystemFile.dll