如何在C#中实现带密钥的MD5字符串哈希函数以满足API认证需求？

你好！其实不用纠结Bouncy Castle，.NET框架本身就提供了完整的MD5和HMAC-MD5实现，完全能满足你的需求。我给你两种常见的实现方案，你可以根据API的具体要求选择：

方案1：输入与密钥拼接后计算MD5 #

如果API要求的是将输入字符串和密钥直接拼接后计算MD5哈希，这个实现很直接：

using System;
using System.Security.Cryptography;
using System.Text;

public class HashHelper
{
    public string CreateMD5Hash(string input, string secretKey)
    {
        // 1. 拼接输入和密钥（注意顺序：有些API要求密钥在前，输入在后，可根据需求调整）
        string combinedInput = input + secretKey;
        
        // 2. 将字符串转为字节数组（编码要和API要求一致，通常用UTF8）
        byte[] inputBytes = Encoding.UTF8.GetBytes(combinedInput);
        
        // 3. 计算MD5哈希
        using (MD5 md5 = MD5.Create())
        {
            byte[] hashBytes = md5.ComputeHash(inputBytes);
            
            // 4. 将哈希字节数组转为十六进制字符串
            StringBuilder sb = new StringBuilder();
            foreach (byte b in hashBytes)
            {
                // 转为两位小写十六进制，若需大写则用 "X2"
                sb.Append(b.ToString("x2"));
            }
            return sb.ToString();
        }
    }
}

方案2：使用HMAC-MD5（更安全的密钥哈希方式） #

如果API要求的是基于HMAC的MD5哈希（这是更标准的密钥结合哈希方案，避免简单拼接的安全隐患），可以用HMACMD5类来实现：

using System;
using System.Security.Cryptography;
using System.Text;

public class HashHelper
{
    public string CreateMD5Hash(string input, string secretKey)
    {
        // 1. 将输入和密钥转为字节数组
        byte[] inputBytes = Encoding.UTF8.GetBytes(input);
        byte[] keyBytes = Encoding.UTF8.GetBytes(secretKey);
        
        // 2. 计算HMAC-MD5哈希
        using (HMACMD5 hmacMd5 = new HMACMD5(keyBytes))
        {
            byte[] hashBytes = hmacMd5.ComputeHash(inputBytes);
            
            // 3. 转为十六进制字符串
            StringBuilder sb = new StringBuilder();
            foreach (byte b in hashBytes)
            {
                sb.Append(b.ToString("x2"));
            }
            return sb.ToString();
        }
    }
}

关键注意点： #

• 编码一致性：确保你使用的编码（比如UTF8）和API文档要求的完全一致，否则哈希结果会不匹配。
• 大小写问题：有些API要求哈希字符串是大写的，只需要把"x2"改成"X2"即可。
• 拼接顺序：如果是方案1，一定要确认API要求的是输入+密钥还是密钥+输入，顺序错了哈希结果肯定不对。

这两种方案都不需要依赖第三方库，直接用.NET内置的加密类就能完成，比Bouncy Castle更省心。

内容的提问来源于stack exchange，提问作者Nabil Mashrief