Aore.CipherKit 1.1.1

Aore.CipherKit

Aore.CipherKit 是一个面向 .NET 的生产级加密解密核心类库：一个 NuGet 包，覆盖常用加密、中国国密（SM2/SM3/SM4）、对称/非对称加密、哈希/KDF/口令哈希（bcrypt/scrypt/Argon2）、中文编码（GBK/GB2312/GB18030/Big5）与混淆脱敏。零外部依赖（全部算法为库内纯 C# 实现），API 高度统一，学会一个算法即会用所有算法。

• 目标框架：netstandard2.0 / net462 / net472 / net48 / net8.0 / net9.0 / net10.0
• 质量红线：全 TFM 0 错误 0 警告、540 例单元测试 × 4 测试框架全绿、覆盖率门槛固化、标准向量（KAT）+ BouncyCastle/python 官方库互验；v1.1.1 完成全量代码安全审查（77 项发现，33 项已修复含全部 P0/P1，见 docs/05 §1.1 状态清单）
• 许可：MIT

安装

dotnet add package Aore.CipherKit

30 秒上手

using Aore.CipherKit;

// ── 对称加密：所有 16 个算法同一套签名，AORK 自描述容器（随机 IV 自动生成）──
string box  = Cipher.Aes.Encrypt("机密数据", "任意长度字符串密钥");   // AES-256-GCM
string back = Cipher.Aes.Decrypt(box, "任意长度字符串密钥");          // "机密数据"
string sm4  = Cipher.Sm4.Encrypt("国密数据", "0123456789abcdef");    // 国密 SM4

// ── 摘要 ──
string sm3 = Hash.Sm3("文本");            // 国密 SM3
string sha = Hash.Sha256("文本");          // SHA-256

// ── 口令哈希（PHC 自描述，验证参数自适应）──
string hash = Cipher.Passwords.Argon2idHash("口令");
bool   ok   = Cipher.Passwords.Argon2idVerify("口令", hash);   // true

// ── 一键口令加密（PBKDF2 六十万次派生 + AES-256-GCM）──
string box2 = Cipher.Protect("敏感信息", "强口令");
string open = Cipher.Unprotect(box2, "强口令");                 // "敏感信息"

// ── 非对称（PEM/XML/Base64-DER/hex 自适应）──
var kp = Cipher.Rsa.GenerateKeyPair();
string enc   = Cipher.Rsa.Encrypt("机密", kp.PublicKey);
string sig   = Cipher.Rsa.Sign("报文", kp.PrivateKey);
bool   valid = Cipher.Rsa.Verify("报文", Convert.FromBase64String(sig), kp.PublicKey);

// ── 编码 / 混淆 / 脱敏 ──
string gbk   = Encode.ToGbkBase64("中文");            // 中文 → GBK → Base64
string id    = Obfuscate.EncodeId(10086L);           // Hashids ID 混淆
string morse = Obfuscate.Morse("SOS");               // "... --- ..."
string phone = Mask.Phone("13812345678");            // "138****5678"

API 清单（按门面）

Hash — 摘要与校验

Cipher — 加密解密（对称 12 算法统一梯队）

统一方法梯队（以 Aes 为例，其余算法完全相同）：

Cipher.Aes.Encrypt(string plain, string key)                     // → AORK 容器（Base64）
Cipher.Aes.Decrypt(string cipher, string key)
Cipher.Aes.EncryptBytes(byte[] data, byte[] key)                 // → AORK 容器（字节）
Cipher.Aes.EncryptBytes(byte[] data, CryptoOptions options)      // 指定模式/IV/关联数据
Cipher.Aes.EncryptStream(Stream in, Stream out, byte[] key)      // 64KB 分块恒定内存
Cipher.Aes.EncryptFile(string src, string dst, string key)
// Decrypt 同构。支持 ECB/CBC/CFB8/OFB/CTR/GCM + PKCS7 等填充。

新补齐算法用法完全相同（切换算法只需替换类名）：

```csharp
string box = Cipher.Camellia.Encrypt("机密文本", "myKey");   // Camellia-GCM 容器（Twofish/Serpent/Aria 同构）
string cast5 = Cipher.Cast5.Encrypt("旧系统文本", "myKey");  // CAST5-CBC 容器（64 位分组）
string zuc = Cipher.Zuc.Encrypt("国密流加密", "myKey");       // ZUC-EEA3 容器（16 字节 IV）
byte[] mac = Cipher.Zuc.MacEia3(data, key16, iv16);          // EIA3 完整性标签（4 字节）

Cipher — 非对称与证书

SM2 密钥交换与 SM9 标识密码（v1.1 补齐）：

// SM2DH：双方各自生成交换材料并派生一致密钥
var alice = Cipher.Sm2.KeyExchange.Generate("ALICE123@YAHOO.COM");
var bob = Cipher.Sm2.KeyExchange.Generate("BILL456@YAHOO.COM");
byte[] keyA = Cipher.Sm2.KeyExchange.Agree(alice, bob.StaticPublicKeyHex,
    bob.EphemeralPublicKeyHex, "BILL456@YAHOO.COM", 16, selfIsInitiator: true);
byte[] keyB = Cipher.Sm2.KeyExchange.Agree(bob, alice.StaticPublicKeyHex,
    alice.EphemeralPublicKeyHex, "ALICE123@YAHOO.COM", 16, selfIsInitiator: false);
// keyA == keyB

// SM9：KGC 派生用户密钥 → 标识加解密/签名（无需交换证书）
var encMaster = Cipher.Sm9.GenerateEncryptionMasterKey();
var sigMaster = Cipher.Sm9.GenerateSignatureMasterKey();
var decKey = encMaster.GenerateUserKey("Bob");
string box = Cipher.Sm9Ops.Encrypt("Hello, SM9!", encMaster.MasterPublicKeyHex, "Bob");
string plain = Cipher.Sm9Ops.Decrypt(box, decKey);
var signKey = sigMaster.GenerateUserKey("Alice");
string sig = Cipher.Sm9Ops.Sign("Hello, SM9!", signKey);
bool ok = Cipher.Sm9Ops.Verify("Hello, SM9!", sig, sigMaster, "Alice");

Cipher.Passwords — 口令哈希

Cipher.Protect — 一键口令加密

Cipher.Protect(plain, password) / Unprotect(box, password)      // 文本
Cipher.ProtectBytes(data, password) / UnprotectBytes(box, password)  // 字节

Encode / Encoders — 编码

Obfuscate — 混淆

Mask — 脱敏

Phone（保前3后4）、IdCard（保前6后4）、Name（保姓）、Email（保域名）、BankCard（保尾4）、Ip（保前2段）、Custom(text, keepStart, keepEnd, maskChar)。

基础设施（Aore.CipherKit.Security / Abstractions）

SecureRandom.GetBytes(n)（CSPRNG）、ConstantTime.Equals/Zeroize（恒时比较/清零）、Keys.Normalize/ParseIv（密钥规整）、CryptoOptions（模式/填充/IV/关联数据）。

特性总览

许可

MIT © 2026 WEI.ZHOU (Willis)