使用Microsoft Identity Web的IDownstreamApi能否自定义底层HTTP客户端消息处理链？

完全可以自定义底层HTTP客户端的消息处理链，且存在符合库设计规范的实现方式，无需绕过抽象层。针对客户端凭据流的场景，以下是两种常用的实现方案：

1. 配置全局复用的自定义HTTP客户端 #

在依赖注入阶段，先构建带有自定义消息处理链的HttpClient，再将其关联到Microsoft Identity Web的下游API服务：

// 第一步：配置带有弹性重试等策略的自定义HttpClient
builder.Services.AddHttpClient("GlobalCustomClient")
    // 添加Polly弹性重试策略（处理瞬时网络错误）
    .AddPolicyHandler(HttpPolicyExtensions
        .HandleTransientHttpError()
        .WaitAndRetryAsync(3, retryAttempt => TimeSpan.FromSeconds(Math.Pow(2, retryAttempt))))
    // 可添加其他自定义消息处理程序，比如日志、请求头修改等
    .AddHttpMessageHandler<CustomRequestLoggingHandler>();

// 第二步：注册Microsoft Identity Web并关联自定义HttpClient
builder.Services.AddMicrosoftIdentityWebApiAuthentication(builder.Configuration)
    .AddInMemoryTokenCaches()
    .AddDownstreamApi("MyDownstreamApi", builder.Configuration.GetSection("DownstreamApi"))
    // 将下游API绑定到之前配置的自定义HttpClient
    .AddHttpClientForDownstreamApi("MyDownstreamApi", "GlobalCustomClient");

2. 为特定下游API配置专属HTTP客户端 #

如果仅需针对某一个下游API做定制化处理，可以直接在注册该下游API时配置其专属的HttpClient：

builder.Services.AddMicrosoftIdentityWebApiAuthentication(builder.Configuration)
    .AddInMemoryTokenCaches()
    .AddDownstreamApi("SpecificDownstreamApi", builder.Configuration.GetSection("SpecificDownstreamApi"))
    // 直接为该下游API配置HttpClient及处理链
    .AddHttpClientForDownstreamApi("SpecificDownstreamApi")
    .AddPolicyHandler(GetCustomRetryPolicy());

// 自定义重试策略示例
private static IAsyncPolicy<HttpResponseMessage> GetCustomRetryPolicy()
{
    return Policy
        .HandleResult<HttpResponseMessage>(r => r.StatusCode == HttpStatusCode.RequestTimeout)
        .OrTransientHttpError()
        .WaitAndRetryAsync(2, _ => TimeSpan.FromSeconds(1));
}

核心注意点 #

• IDownstreamApi的设计原生支持关联自定义HttpClient，上述方式完全符合库的规范，无需直接访问底层隐藏的客户端实例。
• 客户端凭据流场景下，Microsoft Identity Web会自动完成令牌的获取、缓存与附加，与你配置的消息处理链完全兼容。
• 若需更细粒度的控制，也可通过IDownstreamApiOptions的HttpMessageHandler属性直接指定处理程序，但推荐使用依赖注入配置HttpClient的方式，更贴合ASP.NET Core的设计模式。

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