强名称工具 (Sn.exe)

更新:2007 年 11 月

强名称工具 (Sn.exe) 有助于使用强名称对程序集进行签名。Sn.exe 提供用于密钥管理、签名生成和签名验证的选项。

sn [-quiet][option [parameter(s)]]

参数

选项

说明

-c [csp]

将默认加密服务提供程序 (CSP) 设置为用于强名称签名。此设置应用于整台计算机。如果不指定 CSP 名称,则 Sn.exe 将清除当前设置。

-d container

从强名称 CSP 中删除指定的密钥容器。

-D assembly1 assembly2

验证两个程序集是否只是签名不同。这经常用作使用不同的密钥对重新为程序集创建签名后的检查。

-e assembly outfile

assembly 中提取公钥并将其存储在 outfile 中。

-h

显示该工具的命令语法和选项。

-i infile container

从指定密钥容器中的 infile 安装密钥对。密钥容器位于强名称 CSP 中。

-k [keysize] outfile

生成一个指定大小的新 RSACryptoServiceProvider 密钥并将其写入指定的文件。公钥和私钥都写入该文件。

如果不指定密钥大小,并且已安装了 Microsoft Enhanced Cryptographic Provider,则默认情况下生成 1,024 位的密钥;否则,生成 512 位的密钥。

如果安装了 Microsoft Enhanced Cryptographic Provider,则 keysize 参数支持 384 位至 16,384 位(增量为 8 位)的密钥长度。如果安装了 Microsoft Base Cryptographic Provider,则支持 384 位至 512 位(增量为 8 位)的密钥长度。

-m [y|n]

指定密钥容器是特定于计算机的还是特定于用户的。如果指定 y,则密钥容器是特定于计算机的。如果指定 n,则密钥容器是特定于用户的。

如果既没有指定 y 也没有指定 n,则此选项显示当前设置。

-o infile [outfile]

infile 中提取公钥并将其存储在 .csv 文件中。公钥的每一字节都由逗号分隔。这种格式对于在源代码中将公钥的硬编码引用作为初始化数组很有用。如果不指定 outfile,则此选项将输出放到剪贴板上。

说明:

此选项不验证输入的是否只是公钥。如果 infile 包含带有私钥的密钥对,则会同时提取私钥。

-p infile outfile

infile 中的密钥对提取公钥并将其存储在 outfile 中。此公钥可用于通过程序集链接器 (Al.exe)/delaysign+/keyfile 选项对程序集进行延迟签名。如果对程序集进行延迟签名,则在编译时只设置公钥,并在文件中为以后知道私钥时添加的签名保留空间。

-pc container outfile

container 中的密钥对中提取公钥并将其存储在 outfile 中。

-Pb [y|n]

指定是否强制执行强名称跳过策略。如果指定 y,则在将完全信任程序集加载到完全信任 AppDomain 时,不验证这些程序集的强名称。如果指定 n,则会验证强名称的正确性,但是不会针对特定强名称进行验证。StrongNameIdentityPermission 对完全信任程序集不起作用。您必须自己对强名称是否匹配进行检查。

如果既没有指定 y 也没有指定 n,则此选项显示当前设置。其默认值为 y。

说明:

在 64 位计算机上,必须同时在 Sn.exe 的 32 位和 64 位实例中设置此参数。

-q[uiet]

指定安静模式;取消显示成功消息。

-R[aassembly infile

使用 infile 中的密钥对,重新签名先前已签名的程序集或延迟签名的程序集。

如果使用 -Ra,则重新计算程序集中所有文件的哈希。

-Rc[aassembly container

使用 container 中的密钥对,重新签名先前已签名的程序集或延迟签名的程序集。

如果使用 -Rca,则重新计算程序集中所有文件的哈希。

-Rh assembly

重新计算程序集中所有文件的哈希值。

-t[p] infile

显示存储在 infile 中的公钥的标记。infile 的内容必须是以前使用 -p 从密钥对文件生成的公钥。不要使用 -t[p] 选项直接从密钥对文件提取该标记。

Sn.exe 使用公钥的哈希函数计算该标记。为节省空间,公共语言运行时在记录对具有强名称的程序集的依赖性时,将公钥标记存储在清单中,作为对另一个程序集的引用的一部分。-tp 选项除显示标记外还显示公钥。

请注意,此选项不验证程序集签名,而且不应用于做出信任决策。此选项仅显示原始公钥标记数据。

-T[p] assembly

显示 assembly 的公钥标记。assembly 必须是包含程序集清单的文件的名称。

Sn.exe 使用公钥的哈希函数计算该标记。为节省空间,公共语言运行时在记录对具有强名称的程序集的依赖性时,将公钥标记存储在清单中,作为对另一个程序集的引用的一部分。-Tp 选项除显示标记外还显示公钥。

请注意,此选项不验证程序集签名,而且不应用于做出信任决策。此选项仅显示原始公钥标记数据。

-TSassembly infile

使用 infile 中的密钥对,对已签名或部分签名的 assembly 进行测试签名。

-TSc assembly container

使用密钥容器 container 中的密钥对,对已签名或部分签名的 assembly 进行测试签名。

-v assembly

验证 assembly 中的强名称,其中 assembly 是包含程序集清单的文件名。

-vf assembly

验证 assembly 中的强名称。与 -v 选项不同,-vf 会强制实施验证,即使已使用 -Vr 选项禁用了验证。

-Vl

列出此计算机上的强名称验证的当前设置。

-Vr assembly [userlist] [infile]

注册 assembly 以跳过验证。或者,可以指定用逗号分隔的用户名列表。如果指定 infile,则验证保持启用,但 infile 中的公钥将用于验证操作。可以 *, strongname 的形式指定程序集,以注册所有具有指定强名称的程序集。Strongname 应指定为十六进制数字的字符串以表示标记形式的公钥。参见 -t-T 选项以显示公钥标记。

警告:

仅在开发期间使用此选项。将程序集添加到跳过验证列表会产生安全漏洞。如果将某程序集添加到跳过验证列表中,则恶意的程序集可以通过使用该程序集的完全限定程序集名称来隐藏身份,完全限定程序集名称由程序集名称、版本、区域性和公钥标记组成。这使恶意程序集也可以跳过验证。

-Vu assembly

注销 assembly,不跳过验证。应用于 -Vr 的同一程序集命名规则也应用于 -Vu

-Vx

移除所有验证跳过项。

-?

显示该工具的命令语法和选项。

说明:

所有 Sn.exe 选项都区分大小写,并且必须完全按上面显示的样子键入才可以被此工具识别。

备注

-R–Rc 选项对延迟签名的程序集很有用。在这种情况下,编译时只设置公钥,在以后知道私钥时执行签名。

示例

下面的命令创建一个新的随机密钥对并将其存储在 keyPair.snk 中。

sn -k keyPair.snk

下面的命令将 keyPair.snk 中的密钥存储在强名称 CSP 中的容器 MyContainer 中。

sn -i keyPair.snk MyContainer

下面的命令从 keyPair.snk 中提取公钥并将其存储在 publicKey.snk 中。

sn -p keyPair.snk publicKey.snk

下面的命令显示公钥和 publicKey.snk 包含的公钥的标记。

sn -tp publicKey.snk

下面的命令验证程序集 MyAsm.dll。

sn -v MyAsm.dll

下面的命令从默认 CSP 中删除 MyContainer。

sn -d MyContainer

请参见

概念

具有强名称的程序集

参考

.NET Framework 工具

程序集链接器 (Al.exe)

SDK 命令提示