萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 字串加密解密工具箱:MD5、SHA1、DES、AES(Rijndael) 完整封裝與最佳實務

前言:加密分類與選型指南

類別演算法可逆用途關鍵長度
雜湊 (單向)MD5, SHA1, SHA256, SHA512否密碼儲存(加鹽)、完整性驗證、數位簽章固定輸出長度
對稱加密DES, 3DES, AES (Rijndael)是大量資料加密、設定檔保護、Token 加密DES 64bit, AES 128/192/256bit
非對稱加密RSA, ECDSA是金鑰交換、數位簽章、憑證1024-4096bit
⚠️ **MD5/SHA1 已不安全**,新專案密碼雜湊請用 **PBKDF2/Argon2/bcrypt**,完整性驗證用 **SHA256+**。本文保留 MD5/SHA1 供舊系統相容參考。

命名空間準備

using System;
using System.IO;
using System.Security.Cryptography;
using System.Text;
using System.Web.Security; // 需參考 System.Web.dll (舊專案)

一、雜湊演算法 (單向)

1. 簡易版 (System.Web.Security) — 僅限舊專案

public static class LegacyHash
{
    public static string Md5(string input) =>
        FormsAuthentication.HashPasswordForStoringInConfigFile(input, "MD5");

    public static string Sha1(string input) =>
        FormsAuthentication.HashPasswordForStoringInConfigFile(input, "SHA1");
}

2. 現代標準版 (System.Security.Cryptography) — 推薦

public static class ModernHash
{
    // 通用雜湊
    public static string ComputeHash(string input, HashAlgorithmName alg, Encoding encoding = null)
    {
        encoding = encoding ?? Encoding.UTF8;
        using (var hashAlg = HashAlgorithm.Create(alg.Name))
        {
            byte[] bytes = hashAlg.ComputeHash(encoding.GetBytes(input));
            return BytesToHex(bytes);
        }
    }

    public static string Md5(string input) => ComputeHash(input, HashAlgorithmName.MD5);
    public static string Sha1(string input) => ComputeHash(input, HashAlgorithmName.SHA1);
    public static string Sha256(string input) => ComputeHash(input, HashAlgorithmName.SHA256);
    public static string Sha512(string input) => ComputeHash(input, HashAlgorithmName.SHA512);

    // 密碼專用:PBKDF2 (RFC 2898)
    public static string Pbkdf2(string password, byte[] salt, int iterations = 100000, int hashSize = 32)
    {
        using (var pbkdf2 = new Rfc2898DeriveBytes(password, salt, iterations, HashAlgorithmName.SHA256))
        {
            return Convert.ToBase64String(pbkdf2.GetBytes(hashSize));
        }
    }

    // 驗證 PBKDF2
    public static bool VerifyPbkdf2(string password, string storedHash, byte[] salt, int iterations = 100000)
    {
        string computed = Pbkdf2(password, salt, iterations);
        return CryptographicOperations.FixedTimeEquals(
            Convert.FromBase64String(storedHash), Convert.FromBase64String(computed));
    }

    private static string BytesToHex(byte[] bytes)
    {
        var sb = new StringBuilder(bytes.Length * 2);
        foreach (byte b in sb) sb.Append(b.ToString("x2"));
        return sb.ToString();
    }
}

二、對稱加密 (可逆) — AES (Rijndael) 最佳實務

public static class AesEncryption
{
    // 金鑰派生:密碼 + 鹽 → 256-bit Key + 128-bit IV
    private static (byte[] Key, byte[] IV) DeriveKeyIv(string password, byte[] salt)
    {
        using (var pbkdf2 = new Rfc2898DeriveBytes(password, salt, 100000, HashAlgorithmName.SHA256))
        {
            return (pbkdf2.GetBytes(32), pbkdf2.GetBytes(16)); // AES-256 + 128-bit IV
        }
    }

    public static string Encrypt(string plainText, string password)
    {
        // 產生隨機鹽
        byte[] salt = new byte[16];
        using (var rng = RandomNumberGenerator.Create()) rng.GetBytes(salt);

        var (key, iv) = DeriveKeyIv(password, salt);

        using (var aes = Aes.Create())
        {
            aes.Key = key;
            aes.IV = iv;
            aes.Mode = CipherMode.CBC;
            aes.Padding = PaddingMode.PKCS7;

            using (var ms = new MemoryStream())
            {
                // 寫入鹽 (前 16 位元組),解密時讀取
                ms.Write(salt, 0, salt.Length);

                using (var cs = new CryptoStream(ms, aes.CreateEncryptor(), CryptoStreamMode.Write))
                using (var sw = new StreamWriter(cs, Encoding.UTF8))
                {
                    sw.Write(plainText);
                }
                return Convert.ToBase64String(ms.ToArray());
            }
        }
    }

    public static string Decrypt(string cipherTextB64, string password)
    {
        byte[] full = Convert.FromBase64String(cipherTextB64);
        if (full.Length < 16) throw new ArgumentException("Invalid cipher text");

        byte[] salt = new byte[16];
        Buffer.BlockCopy(full, 0, salt, 0, 16);
        byte[] cipher = new byte[full.Length - 16];
        Buffer.BlockCopy(full, 16, cipher, 0, cipher.Length);

        var (key, iv) = DeriveKeyIv(password, salt);

        using (var aes = Aes.Create())
        {
            aes.Key = key;
            aes.IV = iv;
            aes.Mode = CipherMode.CBC;
            aes.Padding = PaddingMode.PKCS7;

            using (var ms = new MemoryStream(cipher))
            using (var cs = new CryptoStream(ms, aes.CreateDecryptor(), CryptoStreamMode.Read))
            using (var sr = new StreamReader(cs, Encoding.UTF8))
            {
                return sr.ReadToEnd();
            }
        }
    }
}

三、DES/3DES (舊系統相容)

public static class DesEncryption
{
    // 固定 IV (不安全,僅相容)
    private static readonly byte[] FixedIV = { 0x12, 0x34, 0x56, 0x78, 0x90, 0xAB, 0xCD, 0xEF };

    public static string Encrypt(string plain, string key8)
    {
        if (key8.Length != 8) throw new ArgumentException("DES key must be 8 chars");
        byte[] key = Encoding.UTF8.GetBytes(key8);

        using (var des = DES.Create())
        using (var ms = new MemoryStream())
        using (var cs = new CryptoStream(ms, des.CreateEncryptor(key, FixedIV), CryptoStreamMode.Write))
        using (var sw = new StreamWriter(cs, Encoding.UTF8))
        {
            sw.Write(plain);
        }
        return Convert.ToBase64String(ms.ToArray());
    }

    public static string Decrypt(string cipherB64, string key8)
    {
        if (key8.Length != 8) throw new ArgumentException("DES key must be 8 chars");
        byte[] key = Encoding.UTF8.GetBytes(key8);
        byte[] cipher = Convert.FromBase64String(cipherB64);

        using (var des = DES.Create())
        using (var ms = new MemoryStream(cipher))
        using (var cs = new CryptoStream(ms, des.CreateDecryptor(key, FixedIV), CryptoStreamMode.Read))
        using (var sr = new StreamReader(cs, Encoding.UTF8))
        {
            return sr.ReadToEnd();
        }
    }
}

四、對稱加密通用封裝 (支援 AES/DES/3DES 切換)

public sealed class SymmetricCrypto : IDisposable
{
    private readonly SymmetricAlgorithm _alg;

    public SymmetricCrypto(SymmetricAlgorithm algorithm = null)
    {
        _alg = algorithm ?? Aes.Create(); // 預設 AES
    }

    public void SetKeyIv(byte[] key, byte[] iv)
    {
        _alg.Key = key;
        _alg.IV = iv;
    }

    public string Encrypt(string plain, Encoding encoding = null)
    {
        encoding = encoding ?? Encoding.UTF8;
        byte[] input = encoding.GetBytes(plain);
        using (var ms = new MemoryStream())
        using (var cs = new CryptoStream(ms, _alg.CreateEncryptor(), CryptoStreamMode.Write))
        {
            cs.Write(input, 0, input.Length);
            cs.FlushFinalBlock();
            return Convert.ToBase64String(ms.ToArray());
        }
    }

    public string Decrypt(string cipherB64, Encoding encoding = null)
    {
        encoding = encoding ?? Encoding.UTF8;
        byte[] input = Convert.FromBase64String(cipherB64);
        using (var ms = new MemoryStream(input))
        using (var cs = new CryptoStream(ms, _alg.CreateDecryptor(), CryptoStreamMode.Read))
        using (var sr = new StreamReader(cs, encoding))
        {
            return sr.ReadToEnd();
        }
    }

    public void Dispose() => _alg?.Dispose();
}

五、安全清單 (必讀)

  1. **永不硬編碼金鑰**:使用 Azure Key Vault、AWS KMS、HashiCorp Vault 或環境變數注入。
  2. **每次加密產生新 IV**:CBC 模式 IV 必須隨機且唯一,隨密文儲存(如上例前綴 Salt+IV)。
  3. **認證加密 (AEAD)**:.NET Core 3.0+ 支援 AesGcm / ChaCha20Poly1305,**強烈建議取代 CBC**。
  4. **密碼雜湊**:**禁用 MD5/SHA1**,使用 Rfc2898DeriveBytes (PBKDF2) 或 Argon2 (第三方庫)。
  5. **時序攻擊防禦**:比較雜湊/密文用 CryptographicOperations.FixedTimeEquals。
  6. **金鑰輪換**:設計版本化金鑰結構,支援舊資料解密、新資料加密。

結語

C# 加密工具箱核心:**雜湊用 SHA256+/PBKDF2、對稱用 AES-256-CBC/GCM、非對稱用 RSA/ECDSA**。封裝時務必處理 **隨機 IV、金鑰派生、Base64 序列化、資源釋放**。本文提供的 ModernHash、AesEncryption、SymmetricCrypto 可直接納入專案共用庫,並依安全清單逐項檢核。

copyright © 萬盛學電腦網 all rights reserved