using System; using System.Security.Cryptography; using System.Text; namespace ClassNotify.Shared.Security; /// /// 客户端在线升级包数字签名与验签工具 (基于 NIST P-256 ECDSA 与 SHA-256) /// 发布机离线保存私钥签名;客户端与 UpdateAgent 仅内置公钥验签 /// public static class UpdatePackageSigner { private static readonly Lazy<(string priv, string pub)> _defaultTestKey = new(() => GenerateKeyPair()); /// /// 测试与默认部署环境预置的 ECDSA P-256 公钥 (SubjectPublicKeyInfo Base64) /// public static string DefaultTestPublicKeyBase64 => _defaultTestKey.Value.pub; /// /// 测试与离线发布环境预置的 ECDSA P-256 私钥 (PKCS#8 Base64) /// 注意:生产环境此私钥严格仅存在于离线发布机器,绝不部署到服务器与终端 /// public static string DefaultTestPrivateKeyBase64 => _defaultTestKey.Value.priv; /// /// 生成一对全新的 ECDSA NIST P-256 密钥对 (供发布者离线建钥) /// public static (string privateKeyPkcs8Base64, string publicKeySpkiBase64) GenerateKeyPair() { using var ecdsa = ECDsa.Create(ECCurve.NamedCurves.nistP256); var privBytes = ecdsa.ExportPkcs8PrivateKey(); var pubBytes = ecdsa.ExportSubjectPublicKeyInfo(); return (Convert.ToBase64String(privBytes), Convert.ToBase64String(pubBytes)); } /// /// 使用 ECDSA P-256 私钥对数据哈希进行数字签名,返回 Base64 签名串 /// public static string SignHashHex(string hashHex, string privateKeyPkcs8Base64) { if (string.IsNullOrWhiteSpace(hashHex)) throw new ArgumentException("Hash string cannot be empty.", nameof(hashHex)); var dataToSign = Encoding.UTF8.GetBytes(hashHex.Trim().ToLowerInvariant()); var privBytes = Convert.FromBase64String(privateKeyPkcs8Base64); using var ecdsa = ECDsa.Create(); ecdsa.ImportPkcs8PrivateKey(privBytes, out _); var signatureBytes = ecdsa.SignData(dataToSign, HashAlgorithmName.SHA256); return Convert.ToBase64String(signatureBytes); } /// /// 使用 ECDSA P-256 公钥校验签名是否合法有效 /// public static bool VerifyHashHex(string hashHex, string signatureBase64, string publicKeySpkiBase64) { if (string.IsNullOrWhiteSpace(hashHex) || string.IsNullOrWhiteSpace(signatureBase64) || string.IsNullOrWhiteSpace(publicKeySpkiBase64)) { return false; } try { var data = Encoding.UTF8.GetBytes(hashHex.Trim().ToLowerInvariant()); var signatureBytes = Convert.FromBase64String(signatureBase64.Trim()); var pubBytes = Convert.FromBase64String(publicKeySpkiBase64.Trim()); using var ecdsa = ECDsa.Create(); ecdsa.ImportSubjectPublicKeyInfo(pubBytes, out _); return ecdsa.VerifyData(data, signatureBytes, HashAlgorithmName.SHA256); } catch { return false; } } }