.NET强名称工具(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,则此选项将输出放到剪贴板上。
-p infile outfile
从 infile 中的密钥对提取公钥并将其存储在 outfile 中。此公钥可用于通过程序集链接器 (Al.exe) 的 /delaysign+ 和 /keyfile 选项对程序集进行延迟签名。如果延迟创建程序集的签名,则在编译时只设置公钥,并在文件中为以后知道公钥时添加的签名保留空间。
-pc container outfile
从 container 中的密钥对中提取公钥并将其存储在 outfile 中。
-q[uiet]
指定安静模式;取消显示成功消息。
-R[a] assembly infile
使用 infile 中的密钥对,重新签名先前已签名的程序集或延迟已签名的程序集。
如果使用 -Ra,则重新计算程序集中所有文件的哈希。
-Rc[a] assembly container
使用容器中的密钥对,重新签名先前已签名的程序集或延迟已签名的程序集。
如果使用 -Rca,则重新计算程序集中所有文件的哈希。
-Rh assembly
重新计算程序集中所有文件的哈希。
-t[p] infile
显示存储在 infile 中的公钥的标记。infile 的内容必须是以前使用 -p 从密钥对文件生成的公钥。不要使用 -t[p] 选项直接从密钥对文件提取该标记。
Sn.exe 使用公钥中的哈希函数计算该标记。为节省空间,公共语言运行库在记录对具有强名称的程序集的依赖性时,将公钥标记存储在清单中,作为对另一个程序集的引用的一部分。-tp 选项除显示标记外还显示公钥。
请注意,此选项不验证程序集签名,而且不应用于做出信任决策。此选项仅显示原始公钥标记数据。
-T[p] assembly
显示 assembly 的公钥标记。assembly 必须是包含程序集清单的文件的名称。
Sn.exe 使用公钥中的哈希函数计算该标记。为节省空间,公共语言运行库在记录对具有强名称的程序集的依赖性时,将公钥标记存储在清单中,作为对另一个程序集的引用的一部分。-Tp 选项除显示标记外还显示公钥。
请注意,此选项不验证程序集签名,而且不应用于做出信任决策。此选项仅显示原始公钥标记数据。