.NET 3.5下用CNG证书通过RS256算法生成JWT令牌问题

核心问题分析 #

1. 私钥提取错误：你当前导出的是X509ContentType.Cert，这仅包含公钥证书，完全没有私钥。同时.NET 3.5原生X509Certificate2不支持CNG类型私钥，所以证书的私钥字段会显示"Invalid provider type"。
2. 签名逻辑错误：RS256算法要求用私钥签名，你用公钥生成的JWT自然无法通过服务端验证，导致授权失败。

解决步骤 #

步骤1：通过P/Invoke调用CNG原生API获取私钥签名能力 #

.NET 3.5没有托管的CNG支持，必须直接调用Windows系统的CNG函数来实现私钥签名：

using System.Runtime.InteropServices;
using System.Security.Cryptography;

public static class CngKeyHelper
{
    [DllImport("ncrypt.dll", CharSet = CharSet.Unicode)]
    private static extern int NCryptOpenStorageProvider(out IntPtr hProvider, string pszProviderName, uint dwFlags);

    [DllImport("ncrypt.dll", CharSet = CharSet.Unicode)]
    private static extern int NCryptOpenKey(IntPtr hProvider, out IntPtr hKey, string pszKeyName, uint dwLegacyKeySpec, uint dwFlags);

    [DllImport("ncrypt.dll")]
    private static extern int NCryptSignHash(IntPtr hKey, IntPtr pPaddingInfo, byte[] pbHashValue, int cbHashValue, byte[] pbSignature, int cbSignature, out int pcbResult, uint dwFlags);

    [DllImport("ncrypt.dll")]
    private static extern int NCryptFreeObject(IntPtr hObject);

    private const uint NCRYPT_SILENT_FLAG = 0x00000040;
    private const uint NCRYPT_PAD_PKCS1_FLAG = 0x00000001;

    public static byte[] SignData(byte[] data, string keyContainerName)
    {
        IntPtr hProvider = IntPtr.Zero;
        IntPtr hKey = IntPtr.Zero;
        try
        {
            // 打开默认CNG密钥存储提供器
            int result = NCryptOpenStorageProvider(out hProvider, null, 0);
            if (result != 0)
                throw new System.ComponentModel.Win32Exception(result);

            // 打开目标私钥容器
            result = NCryptOpenKey(hProvider, out hKey, keyContainerName, 0, NCRYPT_SILENT_FLAG);
            if (result != 0)
                throw new System.ComponentModel.Win32Exception(result);

            // 对数据做SHA256哈希（RS256要求的哈希算法）
            SHA256 sha256 = new SHA256Managed();
            byte[] hash = sha256.ComputeHash(data);

            // 分配签名缓冲区（2048位RSA签名固定256字节长度）
            byte[] signature = new byte[256];
            int signatureLength;

            // 执行PKCS#1填充的签名（符合RS256规范）
            result = NCryptSignHash(hKey, IntPtr.Zero, hash, hash.Length, signature, signature.Length, out signatureLength, NCRYPT_PAD_PKCS1_FLAG);
            if (result != 0)
                throw new System.ComponentModel.Win32Exception(result);

            // 截断到实际签名长度
            Array.Resize(ref signature, signatureLength);
            return signature;
        }
        finally
        {
            // 释放资源
            if (hKey != IntPtr.Zero)
                NCryptFreeObject(hKey);
            if (hProvider != IntPtr.Zero)
                NCryptFreeObject(hProvider);
        }
    }
}

获取密钥容器名：运行certutil -v -yourcertthumbprint命令，找到输出中的"Key Container"字段值，这就是要传入keyContainerName的内容。

步骤2：修改JWT编码器，替换签名逻辑 #

将原JWTCreator的RS256分支逻辑替换为CNG签名，同时确保依赖兼容的JSON序列化库（使用Newtonsoft.Json v10.0.3，这是最后支持.NET 3.5的版本）：

using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Text;

public static class JWTCreator
{
    public enum JwtHashAlgorithm
    {
        RS256
    }

    public static string Encode(IDictionary<string, object> payload, string keyContainerName, JwtHashAlgorithm algorithm)
    {
        if (algorithm != JwtHashAlgorithm.RS256)
            throw new NotSupportedException("仅支持RS256算法");

        // 构造JWT头部
        var header = new Dictionary<string, object>
        {
            { "alg", "RS256" },
            { "typ", "JWT" }
        };

        // 序列化头部和载荷
        string headerJson = JsonConvert.SerializeObject(header);
        string payloadJson = JsonConvert.SerializeObject(payload);

        // Base64URL编码
        string encodedHeader = Base64UrlEncode(Encoding.UTF8.GetBytes(headerJson));
        string encodedPayload = Base64UrlEncode(Encoding.UTF8.GetBytes(payloadJson));

        // 构造签名输入串
        string signatureInput = $"{encodedHeader}.{encodedPayload}";
        byte[] signatureData = Encoding.UTF8.GetBytes(signatureInput);

        // 使用CNG私钥签名
        byte[] signature = CngKeyHelper.SignData(signatureData, keyContainerName);
        string encodedSignature = Base64UrlEncode(signature);

        return $"{encodedHeader}.{encodedPayload}.{encodedSignature}";
    }

    // 标准Base64URL实现
    private static string Base64UrlEncode(byte[] input)
    {
        string output = Convert.ToBase64String(input);
        output = output.Split('=')[0]; // 移除填充字符
        output = output.Replace('+', '-'); // 替换URL不安全字符
        output = output.Replace('/', '_'); // 替换URL不安全字符
        return output;
    }
}

步骤3：权限配置 #

确保运行程序的用户拥有该证书私钥的读取/签名权限：

1. 打开certmgr.msc，找到目标证书
2. 右键→所有任务→管理私钥
3. 添加运行程序的用户，授予"读取"和"完全控制"权限

验证方法 #

生成JWT后，可通过JWT格式验证工具检查签名有效性，公钥使用证书导出的公钥（转换为PEM格式）。

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