基于AAD认证的网站：能否离线提供OpenID配置及全局代理设置

1. 能否手动下载OpenID配置并离线提供？ #

可以实现，但存在关键限制需注意：

• 先手动访问https://login.microsoftonline.com/{tenant}/v2.0/.well-known/openid-configuration，下载JSON配置内容，保存到应用的本地文件（如wwwroot/openid-configuration.json）或内嵌资源中。
• 修改认证配置，指定MetadataAddress为本地配置的访问路径，同时建议手动确认关键端点配置（避免本地文件缺失字段）。
• 注意：AAD的密钥、端点信息可能会更新，离线配置会失去自动刷新能力，需定期手动同步配置文件，否则可能引发认证失败。

修改后的认证配置示例：

builder.Services.AddAuthentication(OpenIdConnectDefaults.AuthenticationScheme)
    .AddMicrosoftIdentityWebApp(options =>
    {
        builder.Configuration.Bind("AzureAd", options);
        // 指定本地配置文件路径（以wwwroot下的文件为例）
        options.MetadataAddress = "~/openid-configuration.json";
        
        // 可选：手动覆盖核心端点（确保配置有效性）
        // options.Authority = "https://login.microsoftonline.com/{tenantId}";
        // options.AuthorizationEndpoint = "https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/authorize";
        // options.TokenEndpoint = "https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token";
    });

2. 如何全局设置代理信息？ #

有两种实用方式为应用全局配置代理：

方式一：直接注册全局HttpClientHandler #

在Program.cs中定义全局HttpClientHandler并指定代理，让Microsoft Identity组件使用该实例：

// 注册带代理的全局HttpClient
builder.Services.AddHttpClient("ProxyEnabledClient")
    .ConfigurePrimaryHttpMessageHandler(() =>
    {
        return new HttpClientHandler
        {
            Proxy = new WebProxy("http://your-proxy-server:port")
            {
                Credentials = new NetworkCredential("proxy-username", "proxy-password")
            },
            UseProxy = true
        };
    });

// 配置认证组件使用上述HttpClient
builder.Services.AddAuthentication(OpenIdConnectDefaults.AuthenticationScheme)
    .AddMicrosoftIdentityWebApp(options =>
    {
        builder.Configuration.Bind("AzureAd", options);
        options.BackchannelHttpClientName = "ProxyEnabledClient";
    });

方式二：通过配置文件加载代理信息 #

在appsettings.json中添加代理配置：

"ProxySettings": {
  "Address": "http://your-proxy-server:port",
  "UseDefaultCredentials": false,
  "UserName": "proxy-username",
  "Password": "proxy-password"
}

然后在Program.cs中读取配置并应用：

// 绑定代理配置
var proxyConfig = builder.Configuration.GetSection("ProxySettings").Get<ProxyConfig>();

// 注册带代理的HttpClient
builder.Services.AddHttpClient("ProxyEnabledClient")
    .ConfigurePrimaryHttpMessageHandler(() =>
    {
        var handler = new HttpClientHandler();
        if (proxyConfig != null)
        {
            handler.Proxy = new WebProxy(proxyConfig.Address)
            {
                Credentials = new NetworkCredential(proxyConfig.UserName, proxyConfig.Password),
                UseDefaultCredentials = proxyConfig.UseDefaultCredentials
            };
            handler.UseProxy = true;
        }
        return handler;
    });

// 配置认证组件使用该HttpClient
builder.Services.AddAuthentication(OpenIdConnectDefaults.AuthenticationScheme)
    .AddMicrosoftIdentityWebApp(options =>
    {
        builder.Configuration.Bind("AzureAd", options);
        options.BackchannelHttpClientName = "ProxyEnabledClient";
    });

// 定义配置绑定类
public class ProxyConfig
{
    public string Address { get; set; }
    public bool UseDefaultCredentials { get; set; }
    public string UserName { get; set; }
    public string Password { get; set; }
}

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