一.简介
DotnetRSA 是一个利用 .NET Core 2.1 开发的 .NET Global Tool,是可以想npm全局安装一样,安装在你的系统中,只需敲一行命令便可以快速生成RSA加密算法所需的秘钥,目前支持三种格式的秘钥,分别为:xml、pkcs1、pkcs8。它还支持三种格式秘钥的相互转换。
二.安装
使用 DotnetRSA 需要你的系统具备.NET Core >=2.1 的环境,若没有请访问官网,按照提示进行安装:https://www.microsoft.com/net/learn/get-started/windows
输入一句命令便可以安装:
dotnet tool install -g dotnetrsa
安装成功会有如下提示:
同时输入命令 dotnetrsa
会出现如下提示:
三.使用
1.生成秘钥
生成秘钥使用命令 dontetrsa gen
,加入 -h
获取帮助:
Generate xml, pkcs1, pkcs8 keys.
Usage: dotnetrsa gen [options]
Options:
-h|--help Show help information
-f|--format Required.Gen keys's format.The value must be xml, pkcs1 ,pkcs8.
-s|--size <int> Key Size.Default 2048.
--pem Pem Format. true of false.Default false.
-o|--output <path> File output path.If you do not specify it will be output in the current directory.
-f 或者 --format:指需要生成的格式,可以为 xml、pkcs1、pkcs8
-s 或者 --size :指需要生成的秘钥长度,默认为2048
--pem :只是否带有pem格式,值为 true 或者 false,默认为 false
-o 或者 --output :指秘钥保存的路径,默认保存在当前文件夹
生成一个长度为2048的xml格式的秘钥示例:
dotnetrsa gen -s 2048 -f xml
2.转换秘钥
转换秘钥使用命令 dontetrsa convert ,加入
-h` 获取帮助:
Usage: dotnetrsa convert [arguments] [options]
Arguments:
KeyFilePath Required.Secret key file path.
Options:
-h|--help Show help information
-f|--from <format> Required.Source format.The value must be xml, pkcs1,pkcs8.
-t|--to <format> Required.Target format.The value must be xml, pkcs1,pkcs8.
-k Required.Key type.The value must be pri, pub.'pub' represents the public key.
-o|--output <path> File output path.If you do not specify it will be output in the current directory.
KeyFilePath:指定被转换的秘钥的路径
-f 或者 --from :该字段为必须指定,指被转换的秘钥的格式,值只能为 xml、pkcs1、pkcs8
-t 或者 --to:该字段为必须指定,指需要转换的目标格式,值只能为 xml、pkcs1、pkcs8
-k :指被转换的秘钥的类型,公钥或者私钥,值只能为 pri 或者 pub ,分别代表公钥和私钥
-o :转换的秘钥的输出路径,默认为当前目录
将一个格式为xml的私钥转换为pkcs1,示例:
dotnetrsa convert c:\xml_private.key -f xml -t pkcs1 -k pri
四.参考资料
DotnetRSA 生成和转换秘钥使用了开源项目 RSAUtil :https://github.com/stulzq/RSAUtil
DotnetRSA 的开源地址:https://github.com/stulzq/dotnetrsa