从 ASP.NET Core 中的不同 HTTP 标头读取 JWT 令牌

Question

在 ASP.NET Core API 项目中，我需要验证位于与 Authorization 标头不同的标头中的另一个 JWT Bearer 令牌。例如，假设发送一个 GET 请求来获取产品，/api/products并在名为 的标头中包含承载令牌AccessToken。

curl --location --request GET 'https://localhost/api/products' \
--header 'AccessToken: <bearer_token>'

我引用Microsoft.AspNetCore.Authentication.JwtBearer包并在 API 项目中设置身份验证，如下所示：

curl --location --request GET 'https://localhost/api/products' \
--header 'AccessToken: <bearer_token>'

但是，我在JwtBearerOptions Class中找不到有关标头名称的任何内容。

如何配置 JWT 身份验证以从名为“AccessToken”的标头读取 JWT？ 是否可以使用 Microsoft.AspNetCore.Authentication.JwtBearer 包？

Answer 1

解决方案似乎是使用JwtBearerEvents 类。其中，有一个名为 OnMessageReceived 的委托属性，它“在首次收到协议消息时调用”。该委托将传递MessageReceivedContext类型的对象，其中它有一个名为 Token 的属性，根据文档 “这将使应用程序有机会从备用位置检索令牌”。

创建一个继承自 JwtBearerEvents 的类，并在 OnMessageReceived 事件中将上下文对象中的令牌设置为标头“AccessToken”中的值。

/// <summary>
/// Singleton class handler of events related to JWT authentication
/// </summary>
public class AuthEventsHandler : JwtBearerEvents
{
    private const string BearerPrefix = "Bearer ";

    private AuthEventsHandler() => OnMessageReceived = MessageReceivedHandler;

    /// <summary>
    /// Gets single available instance of <see cref="AuthEventsHandler"/>
    /// </summary>
    public static AuthEventsHandler Instance { get; } = new AuthEventsHandler();

    private Task MessageReceivedHandler(MessageReceivedContext context)
    {
        if (context.Request.Headers.TryGetValue("AccessToken", out StringValues headerValue))
        {
            string token = headerValue;
            if (!string.IsNullOrEmpty(token) && token.StartsWith(BearerPrefix))
            {
                token = token.Substring(BearerPrefix.Length);
            }

            context.Token = token;
        }

        return Task.CompletedTask;
    }
}

最后，将事件类添加到 Startup 类的 JWT 身份验证中。

services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(JwtBearerDefaults.AuthenticationScheme, options => 
{
    Configuration.Bind("JwtSettings", options);
    options.Events = AuthEventsHandler.Instance;
});