.NET Core 8 Minimal API如何加载PFX格式自签名SSL证书？

以下是几种实用的加载方案，根据你的需求选择即可：

方案1：通过配置文件自动加载 #

修改项目根目录的appsettings.json，添加Kestrel的HTTPS证书配置，框架会自动读取并加载证书：

{
  "Kestrel": {
    "Endpoints": {
      "Https": {
        "Url": "https://localhost:5001",
        "Certificate": {
          "Path": "localhost.pfx",
          "Password": "你的PFX文件密码"
        }
      }
    }
  }
}

• 无需修改Program.cs代码，保持你已有的HTTPS重定向配置即可。

方案2：在代码中手动加载证书 #

如果需要更灵活的控制逻辑，可在Program.cs中直接读取PFX文件并配置给Kestrel：

var builder = WebApplication.CreateBuilder(args);

// 加载PFX证书
var certFilePath = Path.Combine(builder.Environment.ContentRootPath, "localhost.pfx");
var certPassword = "你的PFX文件密码";
var sslCertificate = new X509Certificate2(certFilePath, certPassword);

// 配置Kestrel使用该证书
builder.WebHost.ConfigureKestrel(options =>
{
    options.ListenAnyIP(5001, listenOpts =>
    {
        listenOpts.UseHttps(sslCertificate);
    });
});

// 保留你已有的HTTPS重定向配置
builder.Services.AddHttpsRedirection(options =>
{
    options.HttpsPort = 5001;
});

var app = builder.Build();

app.UseHttpsRedirection();

// 你的API端点配置
app.MapGet("/", () => "服务已启动");

app.Run();

• 注意：确保PFX文件被包含在发布输出中，可在项目的.csproj文件添加以下配置：

<Content Include="localhost.pfx">
  <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</Content>

方案3：通过环境变量传递证书密码 #

为避免明文存储密码，可将密码通过环境变量传递：

• Windows PowerShell设置环境变量：

$env:ASPNETCORE_Kestrel__Endpoints__Https__Certificate__Password="你的密码"

• 命令行设置环境变量：

set ASPNETCORE_Kestrel__Endpoints__Https__Certificate__Password=你的密码

• 此时appsettings.json只需保留证书路径：

{
  "Kestrel": {
    "Endpoints": {
      "Https": {
        "Url": "https://localhost:5001",
        "Certificate": {
          "Path": "localhost.pfx"
        }
      }
    }
  }
}

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