EggEgg.XC.RSAUtil
136.1.0-rc54
dotnet add package EggEgg.XC.RSAUtil --version 136.1.0-rc54
NuGet\Install-Package EggEgg.XC.RSAUtil -Version 136.1.0-rc54
<PackageReference Include="EggEgg.XC.RSAUtil" Version="136.1.0-rc54" />
<PackageVersion Include="EggEgg.XC.RSAUtil" Version="136.1.0-rc54" />
<PackageReference Include="EggEgg.XC.RSAUtil" />
paket add EggEgg.XC.RSAUtil --version 136.1.0-rc54
#r "nuget: EggEgg.XC.RSAUtil, 136.1.0-rc54"
#addin nuget:?package=EggEgg.XC.RSAUtil&version=136.1.0-rc54&prerelease
#tool nuget:?package=EggEgg.XC.RSAUtil&version=136.1.0-rc54&prerelease
EN | 中文
Notice
This package is not the official version of GitHub Repository stulzq/RSAUtil but a custom fork. Please go to NuGet XC.RSAUtil for the official one.
RSAUtil
A .NET Core RSA tool that provides the ability of data encryption, decryption, signing and verifying signature. It supports using and converting RSA keys of formats, namely: .xml
, .pem
, .der
.
Installation via NuGet
Install-Package EggEgg.XC.RSAUtil
Documentation
Here is the English translation of the provided text:
What are the special features of this fork?
- The
RSAUtilBase.LoadRSAKey(byte[])
method can quickly load any supported format of private and public keys, automatically detecting the format, key size, and other parameters, so you don't need to worry about the underlying details of RSA operations. - Added comprehensive support for PKCS#1 RSA public keys.
• Supports the
.der
binary key format. - Together with the
RsaKeyFeature
class and theRSAUtilBase.TreatRSAKeyType(byte[])
method, compared to the original implementation's hard-coded approach, you can more flexibly handle RSA key operations. - Added unit tests to ensure the correctness of the package's behavior.
Generating keys
Use the "RsaKeyGenerator" class. The result returned is a
BinaryKeyResult
containingKeySize
,Format
,Padding
,PrivateKey
andPublicKey
.
Like this:
var keys = RsaKeyGenerator.GetKey(RsaKeyFormat.Pem, RsaKeyPadding.Pkcs1, 2048);
// or use RsaKeyFeature class
// var keys = RsaKeyGenerator.GetKey(new RsaKeyFeature { Format = RsaKeyFormat.Der, Padding = RsaKeyPadding.Pkcs1 }, 2048);
byte[] privateKey = keys.PrivateKey;
byte[] publicKey = key.PublicKey;
// You can directly use it also:
var rsa = keys.GetRSAInstance();
// Or save key and load next time:
rsa = RSAUtilBase.LoadRSAKey(privateKey);
RSA key conversion
You can freely convert key formats using RsaKeyConvert.Format()
. For example:
RsaKeyConvert.Format(key,
new RsaKeyFeature { IsPrivate = true; Format = RsaKeyFormat.Xml; Padding = RsaKeyPadding.Xml },
new RsaKeyFeature { IsPrivate = true; Format = RsaKeyFormat.Der; Padding = RsaKeyPadding.Pkcs1 });
RsaKeyConvert.Format(key,
new RsaKeyFeature { IsPrivate = false; Format = RsaKeyFormat.Xml; Padding = RsaKeyPadding.Xml },
new RsaKeyFeature { IsPrivate = false; Format = RsaKeyFormat.Pem; Padding = RsaKeyPadding.Pkcs1 });
RsaKeyConvert.Format(key,
new RsaKeyFeature { IsPrivate = true; Format = RsaKeyFormat.Pem; Padding = RsaKeyPadding.Pkcs1 },
new RsaKeyFeatire { IsPrivate = false; Format = RsaKeyFormat.Pem; Padding = RsaKeyPadding.Pkcs8 });
Other hardcoded conversion methods can also be used under the RsaKeyConvert
class.
Encryption, decryption, signing, and signature verification
Load any key via RSAUtilBase.LoadRSAKey(byte[])
, then:
- Encryption:
RSAUtilBase.RsaEncrypt()
- Decryption:
RSAUtilBase.RsaDecrypt()
- Sign:
RSAUtilBase.SignData()
- Verification:
RSAUtilBase.VerifyData()
Open-source components used
bc-csharp - onovotny
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
.NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.1 is compatible. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.1
- Portable.BouncyCastle (>= 1.9.0)
-
net8.0
- Portable.BouncyCastle (>= 1.9.0)
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
136.1.0-rc54 | 9 | 4/17/2024 |
136.1.0-rc53 | 1 | 3/20/2024 |
136.1.0-rc52 | 4 | 3/20/2024 |
136.1.0-rc51 | 3 | 3/19/2024 |
136.1.0-rc50 | 3 | 3/18/2024 |
136.0.0-rc01 | 2 | 12/11/2023 |
0.136.0-rc03 | 3 | 12/7/2023 |
0.136.0-rc02 | 3 | 12/7/2023 |
0.136.0-rc01 | 2 | 12/6/2023 |
0.136.0-beta01 | 2 | 12/6/2023 |
Notice: This package is not the official version of GitHub Repository stulzq/RSAUtil but a custom modified version. Please go to https://www.nuget.org/packages/XC.RSAUtil for the official one.