如何为.NET Core 6中ITFoxtec SAML2配置代理访问Azure AD身份提供商？

方法1：使用命名HttpClient（推荐，不影响其他服务） #

ITFoxtec SAML库支持指定自定义的命名HttpClient，我们可以给这个客户端配置代理，步骤如下：

1. 创建配置实体类，用来读取appsettings里的代理配置：

public class ProxySettings
{
    public string Address { get; set; }
    public bool BypassOnLocal { get; set; }
    public bool UseDefaultCredentials { get; set; }
}

2. 在Program.cs中注册带代理配置的命名HttpClient：

// 绑定appsettings中的ProxySettings配置
builder.Services.Configure<ProxySettings>(builder.Configuration.GetSection("ProxySettings"));

// 注册命名HttpClient并配置代理逻辑
builder.Services.AddHttpClient("SamlProxyClient")
    .ConfigurePrimaryHttpMessageHandler(sp =>
    {
        var proxySettings = sp.GetRequiredService<IOptions<ProxySettings>>().Value;
        var handler = new HttpClientHandler();

        if (!string.IsNullOrEmpty(proxySettings.Address))
        {
            handler.Proxy = new WebProxy(proxySettings.Address)
            {
                BypassProxyOnLocal = proxySettings.BypassOnLocal,
                UseDefaultCredentials = proxySettings.UseDefaultCredentials
            };
            handler.UseProxy = true;
        }

        return handler;
    });

3. 配置SAML服务时指定使用这个命名客户端：

builder.Services.AddSaml2(Configuration)
    .AddSaml2HttpClient("SamlProxyClient");

此后ITFoxtec所有涉及元数据拉取、SSO请求的HTTP操作都会走该代理。

方法2：全局配置代理（影响所有HttpClient） #

如果你的应用所有HTTP请求都需要走代理，可以全局配置HttpClient的Handler，ITFoxtec的默认HttpClient会自动继承这个配置：

builder.Services.Configure<ProxySettings>(builder.Configuration.GetSection("ProxySettings"));

builder.Services.AddHttpClient()
    .ConfigurePrimaryHttpMessageHandler(sp =>
    {
        var proxySettings = sp.GetRequiredService<IOptions<ProxySettings>>().Value;
        var handler = new HttpClientHandler();

        if (!string.IsNullOrEmpty(proxySettings.Address))
        {
            handler.Proxy = new WebProxy(proxySettings.Address)
            {
                BypassProxyOnLocal = proxySettings.BypassOnLocal,
                UseDefaultCredentials = proxySettings.UseDefaultCredentials
            };
            handler.UseProxy = true;
        }

        return handler;
    });

注意：该方式会让应用内所有默认HttpClient都走代理，若有其他服务不需要代理，谨慎使用。

额外注意事项 #

• 确保appsettings.json中的代理地址格式正确，需包含协议，比如http://proxy-server:8080或https://proxy-server:8443
• 测试时可通过抓包工具验证请求是否确实通过代理发送

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