.NET Core 6部署于RHEL Apache环境HTTPS内部API调用异常求助

问题根源 #

Apache作为反向代理时，默认不会将HTTPS相关请求头传递给后端.NET Core应用，导致应用误以为当前运行在HTTP环境下，生成的内部API调用URL和日志路径都使用HTTP协议，进而引发TLS/SSL连接错误。

解决方案 #

1. 配置Apache传递HTTPS转发头 #

编辑Apache HTTPS虚拟主机配置文件（通常位于/etc/httpd/conf.d/[your-domain].conf），添加以下配置以传递HTTPS标识头：

# 启用请求头模块（若未启用）
LoadModule headers_module modules/mod_headers.so

<VirtualHost *:443>
    # 现有SSL配置（证书、密钥等）
    SSLCertificateFile /path/to/your/wildcard.crt
    SSLCertificateKeyFile /path/to/your/wildcard.key

    # 添加转发头，告知后端应用当前为HTTPS请求
    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-Forwarded-SSL "on"

    # 反向代理配置（示例）
    ProxyPass / http://localhost:5000/
    ProxyPassReverse / http://localhost:5000/
</VirtualHost>

保存配置后，重启Apache服务：

systemctl restart httpd

2. 配置.NET Core应用识别转发头 #

修改Program.cs，添加转发头处理配置，让应用识别来自Apache的HTTPS标识：

var builder = WebApplication.CreateBuilder(args);

// 配置转发头选项
builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
    options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
    // 添加Apache服务器的IP到信任列表（本地部署可填127.0.0.1，生产环境建议指定具体IP）
    options.KnownProxies.Add(System.Net.IPAddress.Parse("127.0.0.1"));
});

var app = builder.Build();

// 必须在其他中间件之前启用转发头中间件
app.UseForwardedHeaders();

// 启用HTTPS重定向（可选，确保HTTP请求跳转到HTTPS）
app.UseHttpsRedirection();

// 其余应用中间件配置
app.UseStaticFiles();
app.UseRouting();
// ... 你的授权、端点映射等配置

3. 强制应用生成HTTPS链接（可选） #

如果上述配置后仍存在URL生成问题，可在Program.cs中添加中间件强制请求Scheme为HTTPS：

app.Use(async (context, next) =>
{
    context.Request.Scheme = "https";
    await next();
});

4. 检查内部API调用的URL生成方式 #

确保应用内部调用API时使用框架提供的URL生成方法（如Url.Action、IUrlHelper），避免硬编码HTTP协议的URL：

// 正确示例：通过框架生成符合当前请求Scheme的URL
var apiEndpoint = Url.Action("GetData", "Api");
// 错误示例：硬编码HTTP URL（需避免）
// var apiEndpoint = "http://[domain]/Api/GetData";

5. 验证修复效果 #

重启.NET Core应用和Apache服务，测试浏览器访问后查看数据库日志，确认记录的访问路径已变为https://[mydomain]/DashBoard/Index，同时内部API调用的TLS/SSL错误应消失。

内容的提问来源于stack exchange，提问作者Md. Ehasanul Kabir