签名工具 signtool.exe 参数简介

ゝ一世哀愁。 2021-08-27 14:34 528阅读 0赞

签名工具是一个命令行工具，用于对文件进行数字签名，以及验证文件和时间戳文件中的签名。

此工具会自动随 Visual Studio 一起安装。 若要运行此工具，请使用 Visual Studio 开发人员命令提示（或 Windows 7 中的 Visual Studio 命令提示）。 有关详细信息，请参阅[命令提示][Link 1]。

在命令提示符处，键入以下内容：

### 语法 ###

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

### 参数 ###

<table>  表 1  
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>command</code></td> 
   <td>指定要对文件执行的操作的四个命令（<code>catdb</code>、<code>sign</code>、<code>Timestamp</code>&nbsp;或&nbsp;<code>Verify</code>）之一。&nbsp;有关每个命令的说明，请参见下一个表。</td> 
  </tr> 
  <tr> 
   <td><code>options</code></td> 
   <td>用于修改命令的选项。&nbsp;除全局&nbsp;<code>/q</code>&nbsp;和&nbsp;<code>/v</code>&nbsp;选项之外，每个命令均支持一组唯一选项。</td> 
  </tr> 
  <tr> 
   <td><code>file_name</code></td> 
   <td>要进行签名的文件的路径。</td> 
  </tr> 
 </tbody> 
</table>

签名工具支持下列命令。 每个命令均与不同的选项集结合使用，这些选项集已在其各自的节中列出。

<table>  表 2  
 <thead> 
  <tr> 
   <th>命令</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>catdb</code></td> 
   <td>在目录数据库中添加或移除目录文件。&nbsp;目录数据库用于自动查找目录文件，并由 GUID 标识。&nbsp;有关&nbsp;<code>catdb</code>&nbsp;命令支持的选项列表，请参阅&nbsp;<a href="https://docs.microsoft.com/zh-cn/dotnet/framework/tools/signtool-exe#catdb" rel="nofollow">catdb 命令选项</a>。</td> 
  </tr> 
  <tr> 
   <td><code>sign</code></td> 
   <td>对文件进行数字签名。&nbsp;数字签名可以阻止文件被篡改，并且使用户能够基于签名证书验证签名者。&nbsp;有关&nbsp;<code>sign</code>&nbsp;命令支持的选项列表，请参阅&nbsp;<a href="https://docs.microsoft.com/zh-cn/dotnet/framework/tools/signtool-exe#sign" rel="nofollow">sign 命令选项</a>。</td> 
  </tr> 
  <tr> 
   <td><code>Timestamp</code></td> 
   <td>为文件添加时间戳。&nbsp;有关&nbsp;<code>TimeStamp</code>&nbsp;命令支持的选项列表，请参阅&nbsp;<a href="https://docs.microsoft.com/zh-cn/dotnet/framework/tools/signtool-exe#TimeStamp" rel="nofollow">TimeStamp 命令选项</a>。</td> 
  </tr> 
  <tr> 
   <td><code>Verify</code></td> 
   <td>通过确定签名证书是否由受信任的颁发机构颁发、是否已撤消签名证书，以及签名证书对于特定策略是否有效（可选）来验证文件的数字签名。&nbsp;有关&nbsp;<code>Verify</code>&nbsp;命令支持的选项列表，请参阅&nbsp;<a href="https://docs.microsoft.com/zh-cn/dotnet/framework/tools/signtool-exe#Verify" rel="nofollow">Verify 命令选项</a>。</td> 
  </tr> 
 </tbody> 
</table>

下列选项适用于所有签名工具命令。

<table>  表 3  
 <thead> 
  <tr> 
   <th>全局选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>/q</strong></td> 
   <td>如果命令运行成功，则不显示输出；如果命令运行失败，则显示最小输出。</td> 
  </tr> 
  <tr> 
   <td><strong>/v</strong></td> 
   <td>无论命令是否运行成功，都显示详细输出，并显示警告消息。</td> 
  </tr> 
  <tr> 
   <td><strong>/debug</strong></td> 
   <td>显示调试信息。</td> 
  </tr> 
 </tbody> 
</table>

### catdb 命令选项 ###

下表列出了可与 `catdb` 命令一起使用的选项。

<table>  表 4  
 <thead> 
  <tr> 
   <th>Catdb 选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>/d</code></td> 
   <td>指定更新默认目录数据库。&nbsp;如果&nbsp;<code>/d</code>&nbsp;和&nbsp;<code>/g</code>&nbsp;选项都未使用，则签名工具会更新系统组件和驱动程序数据库。</td> 
  </tr> 
  <tr> 
   <td><code>/g</code>&nbsp;GUID</td> 
   <td>指定由全局唯一标识符 GUID 标识的目录数据库已更新。</td> 
  </tr> 
  <tr> 
   <td><code>/r</code></td> 
   <td>从目录数据库中移除指定的目录。&nbsp;如果未指定该选项，签名工具将向目录数据库添加指定目录。</td> 
  </tr> 
  <tr> 
   <td><code>/u</code></td> 
   <td>指定自动为添加的目录文件生成唯一名称。&nbsp;如有必要，重命名目录文件以阻止与现有目录文件发生名称冲突。&nbsp;如果未指定该选项，签名工具将覆盖与所添加的目录同名的任何现有目录。</td> 
  </tr> 
 </tbody> 
</table>

### sign 命令选项 ###

下表列出了可与 `sign` 命令一起使用的选项。

<table>  表 5  
 <thead> 
  <tr> 
   <th>Sign 命令选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>/a</code></td> 
   <td>自动选择最佳签名证书。&nbsp;签名工具将查找满足所有指定条件的所有有效证书，并选择有效时间最长的证书。&nbsp;如果未提供该选项，签名工具仅查找一个有效的签名证书。</td> 
  </tr> 
  <tr> 
   <td><code>/ac</code>&nbsp;file</td> 
   <td>将 file 中的其他证书添加到签名块。</td> 
  </tr> 
  <tr> 
   <td><code>/as</code></td> 
   <td>追加此签名。&nbsp;如果不存在主签名，则改为使此签名成为主签名。</td> 
  </tr> 
  <tr> 
   <td><code>/c</code>&nbsp;CertTemplateName</td> 
   <td>指定用于对证书进行签名的证书模板名（一个 Microsoft 扩展）。</td> 
  </tr> 
  <tr> 
   <td><code>/csp</code>&nbsp;CSPName</td> 
   <td>指定包含私钥容器的加密服务提供程序 (CSP)。</td> 
  </tr> 
  <tr> 
   <td><code>/d</code>&nbsp;Desc</td> 
   <td>指定已签名内容的说明。</td> 
  </tr> 
  <tr> 
   <td><code>/du</code>&nbsp;URL</td> 
   <td>为已签名内容的详细说明指定统一资源定位器 (URL)。</td> 
  </tr> 
  <tr> 
   <td><code>/f</code>&nbsp;SignCertFile</td> 
   <td>指定文件中的签名证书。&nbsp;如果文件采用个人信息交换 (PFX) 格式且受密码保护，则使用&nbsp;<code>/p</code>&nbsp;选项指定密码。&nbsp;如果文件不包含私钥，则使用&nbsp;<code>/csp</code>&nbsp;和&nbsp;<code>/kc</code>&nbsp;选项指定 CSP 和私钥容器名。</td> 
  </tr> 
  <tr> 
   <td><code>/fd</code></td> 
   <td>指定要用于创建文件签名的文件摘要算法。&nbsp;默认值为 SHA1。</td> 
  </tr> 
  <tr> 
   <td><code>/i</code>&nbsp;IssuerName</td> 
   <td>指定签名证书的颁发者的名称。&nbsp;该值可以是整个颁发者名称的子字符串。</td> 
  </tr> 
  <tr> 
   <td><code>/kc</code>&nbsp;PrivKeyContainerName</td> 
   <td>指定私钥容器名。</td> 
  </tr> 
  <tr> 
   <td><code>/n</code>&nbsp;SubjectName</td> 
   <td>指定签名证书的主题的名称。&nbsp;该值可以是整个主题名称的子字符串。</td> 
  </tr> 
  <tr> 
   <td><code>/nph</code></td> 
   <td>如果支持，则取消可执行文件的页面哈希。&nbsp;默认值由 SIGNTOOL_PAGE_HASHES 环境变量和 wintrust.dll 版本决定。&nbsp;对于非 PE 文件，忽略此选项。</td> 
  </tr> 
  <tr> 
   <td><code>/p</code>&nbsp;Password</td> 
   <td>指定打开 PFX 文件时要使用的密码。&nbsp;（使用&nbsp;<code>/f</code>&nbsp;选项指定 PFX 文件。）</td> 
  </tr> 
  <tr> 
   <td><code>/p7</code>&nbsp;<em>路径</em></td> 
   <td>指定为每个指定的内容文件生成的公钥加密标准 (PKCS) #7 文件。&nbsp;PKCS #7 文件命名为 path\filename.p7。</td> 
  </tr> 
  <tr> 
   <td><code>/p7ce</code>&nbsp;Value</td> 
   <td>为已签名的 PKCS #7 内容指定选项。&nbsp;将 Value 设置为“嵌入的”，可将已签名内容嵌入到 PKCS #7 文件中；如果设置为“DetachedSignedData”，则可生成分离的 PKCS #7 文件的已签名数据部分。&nbsp;如果未使用&nbsp;<code>/p7ce</code>&nbsp;选项，默认情况下将嵌入已签名的内容。</td> 
  </tr> 
  <tr> 
   <td><code>/p7co</code>&nbsp;&lt;OID&gt;</td> 
   <td>指定标识已签名的 PKCS #7 内容的对象标识符 (OID)。</td> 
  </tr> 
  <tr> 
   <td><code>/ph</code></td> 
   <td>如果支持，则生成可执行文件的页面哈希。</td> 
  </tr> 
  <tr> 
   <td><code>/r</code>&nbsp;RootSubjectName</td> 
   <td>指定签名证书必须链接到的根证书的主题名称。&nbsp;该值可以是根证书的整个主题名称的子字符串。</td> 
  </tr> 
  <tr> 
   <td><code>/s</code>&nbsp;StoreName</td> 
   <td>指定要在搜索证书时打开的存储。&nbsp;如果未指定该选项，则打开&nbsp;<code>My</code>&nbsp;存储。</td> 
  </tr> 
  <tr> 
   <td><code>/sha1</code>&nbsp;Hash</td> 
   <td>指定签名证书的 SHA1 哈希。&nbsp;当多个证书满足剩余开关指定的条件时，通常会指定 SHA1 哈希。</td> 
  </tr> 
  <tr> 
   <td><code>/sm</code></td> 
   <td>指定使用计算机存储，而不是用户存储。</td> 
  </tr> 
  <tr> 
   <td><code>/t</code>&nbsp;URL</td> 
   <td>指定时间戳服务器的 URL。&nbsp;如果该选项（或&nbsp;<code>/tr</code>）不存在，将不会对签名文件执行时间戳操作。&nbsp;如果时间戳操作失败，将生成一个警告。&nbsp;此选项不能与&nbsp;<code>/tr</code>&nbsp;选项一起使用。</td> 
  </tr> 
  <tr> 
   <td><code>/td</code>&nbsp;alg</td> 
   <td>将此选项与&nbsp;<code>/tr</code>&nbsp;选项一起使用可请求 RFC 3161 时间戳服务器使用的摘要算法。</td> 
  </tr> 
  <tr> 
   <td><code>/tr</code>&nbsp;URL</td> 
   <td>指定 RFC 3161 时间戳服务器的 URL。&nbsp;如果该选项（或&nbsp;<code>/t</code>）不存在，将不会对签名文件执行时间戳操作。&nbsp;如果时间戳操作失败，将生成一个警告。&nbsp;此选项不能与&nbsp;<code>/t</code>&nbsp;选项一起使用。</td> 
  </tr> 
  <tr> 
   <td><code>/u</code>&nbsp;Usage</td> 
   <td>指定签名证书中必须存在的增强型密钥用法 (EKU)。&nbsp;可以通过 OID 或字符串指定该用法的值。&nbsp;默认用法为“代码签名”(1.3.6.1.5.5.7.3.3)。</td> 
  </tr> 
  <tr> 
   <td><code>/uw</code></td> 
   <td>指定“Windows 系统组件验证”(1.3.6.1.4.1.311.10.3.6) 的用法。</td> 
  </tr> 
 </tbody> 
</table>

有关用法示例，请参阅 [Using SignTool to Sign a File][]（使用 SignTool 为文件签名）。

### TimeStamp 命令选项 ###

下表列出了可与 `TimeStamp` 命令一起使用的选项。

<table>  表 6  
 <thead> 
  <tr> 
   <th>TimeStamp 选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>/p7</code></td> 
   <td>对 PKCS #7 文件执行时间戳操作。</td> 
  </tr> 
  <tr> 
   <td><code>/t</code>&nbsp;URL</td> 
   <td>指定时间戳服务器的 URL。&nbsp;要执行时间戳操作的文件必须在以前已进行签名。&nbsp;需要&nbsp;<code>/t</code>&nbsp;或&nbsp;<code>/tr</code>&nbsp;选项。</td> 
  </tr> 
  <tr> 
   <td><code>/td</code>&nbsp;alg</td> 
   <td>请求 RFC 3161 时间戳服务器使用的摘要算法。&nbsp;<code>/td</code>&nbsp;与&nbsp;<code>/tr</code>&nbsp;选项一起使用。</td> 
  </tr> 
  <tr> 
   <td><code>/tp</code>&nbsp;index</td> 
   <td>对 index 处的签名进行时间戳操作。</td> 
  </tr> 
  <tr> 
   <td><code>/tr</code>&nbsp;URL</td> 
   <td>指定 RFC 3161 时间戳服务器的 URL。&nbsp;要执行时间戳操作的文件必须在以前已进行签名。&nbsp;需要&nbsp;<code>/tr</code>&nbsp;或&nbsp;<code>/t</code>&nbsp;选项。</td> 
  </tr> 
 </tbody> 
</table>

有关使用示例，请参阅 [Adding Time Stamps to Previously Signed Files][]（向之前已签名的文件添加时间戳）。

### Verify 命令选项 ###

<table>  表 7  
 <thead> 
  <tr> 
   <th>Verify 选项</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>/a</code></td> 
   <td>指定可以使用所有方法来验证文件。&nbsp;首先，搜索目录数据库以确定是否在目录中对文件进行签名。&nbsp;如果未在任何目录中对文件进行签名，签名工具将尝试验证文件的嵌入签名。&nbsp;验证可以或不能在目录中进行签名的文件时，建议使用该选项。&nbsp;这些文件的示例包括 Windows 文件或驱动程序。</td> 
  </tr> 
  <tr> 
   <td><code>/ad</code></td> 
   <td>使用默认的目录数据库查找目录。</td> 
  </tr> 
  <tr> 
   <td><code>/ag</code>&nbsp;CatDBGUID</td> 
   <td>在由 CatDBGUID 标识的目录数据库中查找目录。</td> 
  </tr> 
  <tr> 
   <td><code>/all</code></td> 
   <td>验证包含多个签名的文件中的所有签名。</td> 
  </tr> 
  <tr> 
   <td><code>/as</code></td> 
   <td>使用系统组件（驱动程序）目录数据库查找目录。</td> 
  </tr> 
  <tr> 
   <td><code>/c</code>&nbsp;CatFile</td> 
   <td>通过名称指定目录文件。</td> 
  </tr> 
  <tr> 
   <td><code>/d</code></td> 
   <td>指定签名工具应打印描述和描述 URL。</td> 
  </tr> 
  <tr> 
   <td><code>/ds</code>&nbsp;Index</td> 
   <td>验证指定位置的签名。</td> 
  </tr> 
  <tr> 
   <td><code>/hash</code>&nbsp;(<code>SHA1</code>|<code>SHA256</code>)</td> 
   <td>指定在目录中搜索文件时要使用的可选哈希算法。</td> 
  </tr> 
  <tr> 
   <td><code>/kp</code></td> 
   <td>指定应使用内核模式驱动程序签名策略执行验证。</td> 
  </tr> 
  <tr> 
   <td><code>/ms</code></td> 
   <td>使用多个验证语义。&nbsp;这是 Windows 8 和更高版本上的&nbsp;<a href="https://docs.microsoft.com/zh-cn/windows/desktop/api/wintrust/nf-wintrust-winverifytrust" rel="nofollow">WinVerifyTrust</a>&nbsp;调用的默认行为。</td> 
  </tr> 
  <tr> 
   <td><code>/o</code>&nbsp;Version</td> 
   <td>按操作系统版本验证文件。&nbsp;版本具有以下格式：PlatformID：VerMajor.VerMinor.BuildNumber。&nbsp;PlatformID 表示&nbsp;<a href="https://docs.microsoft.com/zh-cn/dotnet/api/system.platformid" rel="nofollow">PlatformID</a>&nbsp;枚举成员的基础值。&nbsp;<strong>重要提示：</strong>&nbsp;建议使用&nbsp;<code>/o</code>&nbsp;开关。&nbsp;如果未指定&nbsp;<code>/o</code>，SignTool.exe 可能会返回意外的结果。&nbsp;例如，如果你未将&nbsp;<code>/o</code>&nbsp;开关包含在内，则能在旧版操作系统上正确验证的系统目录可能在新版操作系统上无法正确验证。</td> 
  </tr> 
  <tr> 
   <td><code>/p7</code></td> 
   <td>验证 PKCS #7 文件。&nbsp;无现有策略用于 PKCS #7 验证。&nbsp;该签名处于选中状态，并为签名证书生成了链。</td> 
  </tr> 
  <tr> 
   <td><code>/pa</code></td> 
   <td>指定应使用默认认证码验证策略。&nbsp;如果未指定&nbsp;<code>/pa</code>&nbsp;选项，签名工具将使用 Windows 驱动程序验证策略。&nbsp;此选项不能与&nbsp;<code>catdb</code>&nbsp;选项一起使用。</td> 
  </tr> 
  <tr> 
   <td><code>/pg</code>&nbsp;PolicyGUID</td> 
   <td>通过 GUID 指定验证策略。&nbsp;PolicyGUID 相当于验证策略的 ActionID。&nbsp;此选项不能与&nbsp;<code>catdb</code>&nbsp;选项一起使用。</td> 
  </tr> 
  <tr> 
   <td><code>/ph</code></td> 
   <td>指定签名工具应打印并验证页面哈希值。</td> 
  </tr> 
  <tr> 
   <td><code>/r</code>&nbsp;RootSubjectName</td> 
   <td>指定签名证书必须链接到的根证书的主题名称。&nbsp;该值可以是根证书的整个主题名称的子字符串。</td> 
  </tr> 
  <tr> 
   <td><code>/tw</code></td> 
   <td>指定在未对签名进行时间戳操作时应生成警告。</td> 
  </tr> 
 </tbody> 
</table>

有关用法示例，请参阅 [Using SignTool to Verify a File Signature][]（使用 SignTool 验证文件签名）。

### 返回值 ###

当其终止时，签名工具将返回下列退出代码之一。

<table>  表 8  
 <thead> 
  <tr> 
   <th>退出代码</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>0</td> 
   <td>执行成功。</td> 
  </tr> 
  <tr> 
   <td>1</td> 
   <td>执行失败。</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>执行完成，但出现警告。</td> 
  </tr> 
 </tbody> 
</table>

### 示例 ###

以下命令将目录文件 MyCatalogFileName.cat 添加到系统组件和驱动程序数据库中。 如有必要阻止替换名为 `/u` 的现有目录文件，`MyCatalogFileName.cat` 选项会生成唯一名称。

signtool catdb /v /u MyCatalogFileName.cat

以下命令通过使用最佳证书对文件进行自动签名。

signtool sign /a MyFile.exe

以下命令使用存储在受密码保护的 PFX 文件中的证书对文件进行数字签名。

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

以下命令对文件进行数字签名并加盖时间戳。 用于对文件进行签名的证书存储在 PFX 文件中。

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

以下命令通过使用位于 `My` 存储中的证书对文件进行签名，该证书的主题名为 `My Company Certificate`。

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

以下命令对 ActiveX 控件进行签名，并提供在系统提示用户安装此控件时由 Internet Explorer 显示的信息。

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

以下命令对已进行数字签名的文件加盖时间戳。

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

以下命令确认文件已签名。

signtool verify MyFile.exe

以下命令验证可能已在目录中签名的系统文件。

signtool verify /a SystemFile.dll

以下命令验证已在名为 `MyCatalog.cat` 目录中签名的系统文件。

signtool verify /c MyCatalog.cat SystemFile.dll

[Link 1]: https://docs.microsoft.com/zh-cn/dotnet/framework/tools/developer-command-prompt-for-vs
[Using SignTool to Sign a File]: https://docs.microsoft.com/zh-cn/windows/desktop/SecCrypto/using-signtool-to-sign-a-file
[Adding Time Stamps to Previously Signed Files]: https://docs.microsoft.com/zh-cn/windows/desktop/SecCrypto/adding-time-stamps-to-previously-signed-files
[Using SignTool to Verify a File Signature]: https://docs.microsoft.com/zh-cn/windows/desktop/SecCrypto/using-signtool-to-verify-a-file-signature