using System.Security;
using System.Security.Cryptography;
namespace MeloongCore;
public static class CryptographyUtils {
#region Hash
public enum HashMethod {
///
/// 使用 算法。在 16 进制下哈希为 32 长度字符串。
///
Md5,
///
/// 使用 算法。在 16 进制下哈希为 40 长度字符串。
///
Sha1,
///
/// 使用 算法。在 16 进制下哈希为 64 长度字符串。
///
Sha256,
///
/// 使用 算法。在 16 进制下哈希为 128 长度字符串。
///
Sha512
}
private static HashAlgorithm GetHashAlgorithm(HashMethod method) => method switch {
HashMethod.Md5 => MD5.Create(),
HashMethod.Sha1 => SHA1.Create(),
HashMethod.Sha256 => SHA256.Create(),
HashMethod.Sha512 => SHA512.Create(),
_ => throw new ArgumentOutOfRangeException(nameof(method))
};
///
/// 计算文件的 Hash。返回 16 进制小写字符串。
///
public static string ComputeFileHash(string filePath, HashMethod method = HashMethod.Md5) {
using HashAlgorithm hashImpl = GetHashAlgorithm(method);
Logger.Trace($"计算文件 {method}:{filePath}");
using var file = FileUtils.ReadAsStream(filePath);
return BitConverter.ToString(hashImpl.ComputeHash(file)).Replace("-", "").Lower();
}
///
/// 计算字节数组的 Hash。返回 16 进制小写字符串。
///
public static string ComputeHash(byte[] input, HashMethod method = HashMethod.Md5) {
using HashAlgorithm hashImpl = GetHashAlgorithm(method);
return BitConverter.ToString(hashImpl.ComputeHash(input)).Replace("-", "").Lower();
}
///
/// 计算字符串的 Hash。返回 16 进制小写字符串。
/// 使用 UTF-8 将字符串转换为字节数组。
///
public static string ComputeHash(string input, HashMethod method = HashMethod.Md5)
=> ComputeHash(Encoding.UTF8.GetBytes(input), method);
#endregion
#region AES 对称加解密
private const byte AesDataVersion = 1;
///
/// 使用 AES-256-CBC 对称加密字符串。
///
/// 加密后的 Base64 字符串。若输入为空字符串或 null,则原样返回空字符串或 null。
public static string? AesEncrypt(string? sourceString, string key = "EncryptKey") {
if (string.IsNullOrEmpty(sourceString)) return sourceString; // 原样返回空字符串或 null
byte[] iv = new byte[AesIvSize];
using var rng = RandomNumberGenerator.Create();
rng.GetBytes(iv);
byte[] cipherBytes;
using var sha256 = SHA256.Create();
byte[] aesKey = sha256.ComputeHash(Encoding.UTF8.GetBytes(key));
byte[] hmacKey = sha256.ComputeHash(Encoding.UTF8.GetBytes("AES-HMAC|" + key));
using Aes aes = Aes.Create();
aes.Mode = CipherMode.CBC;
aes.Padding = PaddingMode.PKCS7;
using ICryptoTransform encryptor = aes.CreateEncryptor(aesKey, iv);
byte[] sourceBytes = Encoding.UTF8.GetBytes(sourceString);
cipherBytes = encryptor.TransformFinalBlock(sourceBytes, 0, sourceBytes.Length);
// 格式:版本 [1 字节] | IV [16 字节] | 密文 [N 字节] | 校验 [4 字节]
byte[] encryptedBytes = new byte[1 + iv.Length + cipherBytes.Length + AesCheckSize];
encryptedBytes[0] = AesDataVersion;
Array.Copy(iv, 0, encryptedBytes, 1, iv.Length);
Array.Copy(cipherBytes, 0, encryptedBytes, 1 + iv.Length, cipherBytes.Length);
using var hmac = new HMACSHA256(hmacKey);
byte[] checkBytes = hmac.ComputeHash(encryptedBytes, 0, 1 + iv.Length + cipherBytes.Length);
Array.Copy(checkBytes, 0, encryptedBytes, 1 + iv.Length + cipherBytes.Length, AesCheckSize);
return Convert.ToBase64String(encryptedBytes);
}
///
/// 使用 AES-256-CBC 对称解密字符串。
/// 如果输入数据有误,则确保会抛出 。
///
/// 解密后的字符串。若输入为空字符串或 null,则原样返回空字符串或 null。
public static string? AesDecrypt(string? encryptedString, string key = "EncryptKey") {
if (string.IsNullOrEmpty(encryptedString)) return encryptedString; // 原样返回空字符串或 null
byte[] encryptedBytes;
try {
encryptedBytes = Convert.FromBase64String(encryptedString);
} catch (FormatException ex) {
throw new CryptographicException($"数据不是一个有效的 Base64 字符串({encryptedString})", ex);
}
if (encryptedBytes.Length == 0) throw new CryptographicException($"对称加密数据长度有误({encryptedString})");
int cipherSize = encryptedBytes.Length - 1 - AesIvSize - AesCheckSize;
if (encryptedBytes[0] != AesDataVersion || cipherSize < 16 || cipherSize % 16 != 0)
throw new CryptographicException($"对称加密数据长度有误({encryptedString})");
using var sha256 = SHA256.Create();
byte[] hmacKey = sha256.ComputeHash(Encoding.UTF8.GetBytes("AES-HMAC|" + key));
using var hmac = new HMACSHA256(hmacKey);
byte[] checkBytes = hmac.ComputeHash(encryptedBytes, 0, 1 + AesIvSize + cipherSize);
int checkOffset = 1 + AesIvSize + cipherSize;
int checkDiff = 0;
for (int i = 0; i < AesCheckSize; i++)
checkDiff |= encryptedBytes[checkOffset + i] ^ checkBytes[i];
if (checkDiff != 0) throw new CryptographicException($"对称加密数据校验失败({encryptedString})");
byte[] aesKey = sha256.ComputeHash(Encoding.UTF8.GetBytes(key));
byte[] iv = new byte[AesIvSize];
Array.Copy(encryptedBytes, 1, iv, 0, iv.Length);
using Aes aes = Aes.Create();
aes.Mode = CipherMode.CBC;
aes.Padding = PaddingMode.PKCS7;
using ICryptoTransform decryptor = aes.CreateDecryptor(aesKey, iv);
byte[] output = decryptor.TransformFinalBlock(encryptedBytes, 1 + iv.Length, cipherSize);
return Encoding.UTF8.GetString(output);
}
private const int AesIvSize = 16;
private const int AesCheckSize = 4;
#endregion
#region ECDSA 非对称加密签名
///
/// 使用 ECDSA 算法,验证一个字符串的签名是否使用私钥生成。
/// 如果验证失败则抛出 。
///
public static void EcdsaVerify(string sourceString, string sign, string publicKey) {
using var sha256 = GetHashAlgorithm(HashMethod.Sha256);
byte[] hash = sha256.ComputeHash(Encoding.UTF8.GetBytes(sourceString));
IntPtr algorithmHandle = IntPtr.Zero;
IntPtr keyHandle = IntPtr.Zero;
// 直接调用 DLL,以避免 .NET API 依赖的系统服务存在问题
try {
int status = BCryptOpenAlgorithmProvider(out algorithmHandle, "ECDSA_P256", null, 0);
if (status < 0) throw new CryptographicException($"{nameof(BCryptOpenAlgorithmProvider)} 失败,错误码 {status}");
status = BCryptImportKeyPair(algorithmHandle, IntPtr.Zero, "ECCPUBLICBLOB", out keyHandle, Convert.FromBase64String(publicKey), 72, 0);
if (status < 0) throw new CryptographicException($"{nameof(BCryptImportKeyPair)} 失败,错误码 {status}");
status = BCryptVerifySignature(keyHandle, IntPtr.Zero, hash, hash.Length, Convert.FromBase64String(sign), 64, 0);
if (status == unchecked((int) 0xC000A000)) throw new SecurityException("签名验证失败");
if (status < 0) throw new CryptographicException($"{nameof(BCryptVerifySignature)} 失败,错误码 {status}");
} finally {
if (keyHandle != IntPtr.Zero) BCryptDestroyKey(keyHandle);
if (algorithmHandle != IntPtr.Zero) BCryptCloseAlgorithmProvider(algorithmHandle, 0);
}
}
///
/// 使用 ECDSA 算法,为一个双方均知晓的字符串生成签名。
///
public static string EcdsaSign(string sourceString, string privateKey) {
using var sha256 = GetHashAlgorithm(HashMethod.Sha256);
byte[] hash = sha256.ComputeHash(Encoding.UTF8.GetBytes(sourceString));
byte[] privateKeyBytes = Convert.FromBase64String(privateKey);
IntPtr algorithmHandle = IntPtr.Zero;
IntPtr keyHandle = IntPtr.Zero;
// 直接调用 DLL,避免 .NET API 依赖的系统服务存在问题
try {
int status = BCryptOpenAlgorithmProvider(out algorithmHandle, "ECDSA_P256", null, 0);
if (status < 0) throw new CryptographicException($"{nameof(BCryptOpenAlgorithmProvider)} 失败,错误码 {status}");
status = BCryptImportKeyPair(algorithmHandle, IntPtr.Zero, "ECCPRIVATEBLOB", out keyHandle, privateKeyBytes, privateKeyBytes.Length, 0);
if (status < 0) throw new CryptographicException($"{nameof(BCryptImportKeyPair)} 失败,错误码 {status}");
status = BCryptSignHash(keyHandle, IntPtr.Zero, hash, hash.Length, null, 0, out int signSize, 0);
if (status < 0) throw new CryptographicException($"{nameof(BCryptSignHash)} 失败,错误码 {status}");
byte[] sign = new byte[signSize];
status = BCryptSignHash(keyHandle, IntPtr.Zero, hash, hash.Length, sign, sign.Length, out int actualSignSize, 0);
if (status < 0) throw new CryptographicException($"{nameof(BCryptSignHash)} 失败,错误码 {status}");
if (actualSignSize != sign.Length) Array.Resize(ref sign, actualSignSize);
return Convert.ToBase64String(sign);
} finally {
if (keyHandle != IntPtr.Zero) BCryptDestroyKey(keyHandle);
if (algorithmHandle != IntPtr.Zero) BCryptCloseAlgorithmProvider(algorithmHandle, 0);
}
}
[DllImport("bcrypt.dll", CharSet = CharSet.Unicode)] private static extern int BCryptOpenAlgorithmProvider(out IntPtr algorithmHandle, string algorithmId, string? implementation, int flags);
[DllImport("bcrypt.dll", CharSet = CharSet.Unicode)] private static extern int BCryptImportKeyPair(IntPtr algorithmHandle, IntPtr importKey, string blobType, out IntPtr keyHandle, byte[] input, int inputSize, int flags);
[DllImport("bcrypt.dll")] private static extern int BCryptVerifySignature(IntPtr keyHandle, IntPtr paddingInfo, byte[] hash, int hashSize, byte[] signature, int signatureSize, int flags);
[DllImport("bcrypt.dll")] private static extern int BCryptDestroyKey(IntPtr keyHandle);
[DllImport("bcrypt.dll")] private static extern int BCryptCloseAlgorithmProvider(IntPtr algorithmHandle, int flags);
[DllImport("bcrypt.dll")] private static extern int BCryptSignHash(IntPtr keyHandle, IntPtr paddingInfo, byte[] hash, int hashSize, byte[]? signature, int signatureSize, out int resultSize, int flags);
#endregion
}