Ubuntu 22.10下ASP.NET Core 7 Web API配置HTTPS端点失败求助

1. 生成包含私钥的自签证书 #

使用openssl生成包含证书与私钥的PFX格式文件，执行以下命令：

# 生成CRT证书和KEY私钥文件
openssl req -x509 -newkey rsa:4096 -sha256 -days 365 -nodes \
  -keyout localhost.key -out localhost.crt -subj "/CN=localhost" \
  -addext "subjectAltName=DNS:localhost,DNS:*.localhost,IP:127.0.0.1"

# 合并为PFX文件（设置密码，后续配置需使用）
openssl pkcs12 -export -out localhost.pfx -inkey localhost.key -in localhost.crt

将生成的localhost.pfx放到项目的Certificates目录（无则创建），并设置合理权限确保应用可读取：

sudo chmod 644 /path/to/your/project/Certificates/localhost.pfx

2. 配置Kestrel使用证书 #

方式一：通过appsettings.json配置 #

在appsettings.json中添加Kestrel的HTTPS端点配置：

"Kestrel": {
  "Endpoints": {
    "Https": {
      "Url": "https://localhost:5001",
      "Certificate": {
        "Path": "Certificates/localhost.pfx",
        "Password": "你生成PFX时设置的密码"
      }
    }
  }
}

方式二：通过Program.cs代码配置 #

测试环境下可直接在代码中指定证书：

var builder = WebApplication.CreateBuilder(args);

// 配置Kestrel监听HTTPS端口并加载证书
builder.WebHost.ConfigureKestrel(options =>
{
    options.ListenAnyIP(5001, listenOptions =>
    {
        listenOptions.UseHttps("Certificates/localhost.pfx", "你生成PFX时设置的密码");
    });
});

// 其他服务注册
builder.Services.AddControllers();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// 中间件配置
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

3. 信任自签证书 #

将证书添加到系统信任库，避免浏览器和Swagger的SSL验证错误：

sudo cp localhost.crt /usr/local/share/ca-certificates/localhost.crt
sudo update-ca-certificates

4. Apache反向代理的额外配置（若使用） #

如果Apache作为反向代理转发请求到Kestrel，需配置Apache的SSL规则，示例配置文件/etc/apache2/sites-available/your-api.conf：

<VirtualHost *:443>
    ServerName localhost

    SSLEngine on
    SSLCertificateFile /path/to/localhost.crt
    SSLCertificateKeyFile /path/to/localhost.key

    ProxyPreserveHost On
    ProxyPass / https://localhost:5001/
    ProxyPassReverse / https://localhost:5001/
</VirtualHost>

启用必要模块并重启Apache：

sudo a2enmod ssl proxy proxy_http
sudo systemctl restart apache2

常见问题排查 #

• 证书路径：优先使用绝对路径测试，避免相对路径的工作目录歧义
• 密码验证：确保PFX密码与生成时一致，注意大小写
• 文件权限：避免证书文件设置为root独占权限，应用进程需具备读取权限

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