SignalR Core（Alpha版）Hub的JWT认证实现技术问询

哥们，我太懂你在SignalR Core Alpha版里卡壳的滋味了——这阶段API说变就变，折腾好几个小时完全正常。我给你把客户端传JWT、服务端验证+获取用户数据的实操步骤理清楚，都是适配Alpha版的方案：

服务端配置步骤 #

首先得把身份验证和SignalR的授权逻辑搭起来，Alpha版的配置和正式版有些细节差异，别踩坑：

1. 配置JWT身份验证服务
   在Program.cs里先注册JWT验证，重点是要处理SignalR的消息提取Token的逻辑：

builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options =>
    {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidateAudience = true,
            ValidateLifetime = true,
            ValidateIssuerSigningKey = true,
            ValidIssuer = builder.Configuration["Jwt:Issuer"], // 替换成你的Issuer
            ValidAudience = builder.Configuration["Jwt:Audience"], // 替换成你的Audience
            IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(builder.Configuration["Jwt:Key"])) // 替换成你的密钥
        };

        // 关键！Alpha版SignalR必须加这个事件处理
        // 因为WebSocket握手时没法在Header里传Authorization，得从查询字符串提取Token
        options.Events = new JwtBearerEvents
        {
            OnMessageReceived = context =>
            {
                var accessToken = context.Request.Query["access_token"];
                var hubPath = context.HttpContext.Request.Path;
                if (!string.IsNullOrEmpty(accessToken) && hubPath.StartsWithSegments("/hubs"))
                {
                    context.Token = accessToken;
                }
                return Task.CompletedTask;
            }
        };
    });

// 别忘了添加授权服务
builder.Services.AddAuthorization();

// 注册SignalR服务
builder.Services.AddSignalR();

2. 给Hub添加授权特性
   在你的Hub类上加上[Authorize]，这样只有带有效JWT的客户端才能连接：

[Authorize]
public class ChatHub : Hub
{
    // 在Hub里直接通过Context.User获取用户数据
    public async Task SendPublicMessage(string message)
    {
        // 从Claims里拿用户ID、用户名等信息
        var userId = Context.User.FindFirst(ClaimTypes.NameIdentifier)?.Value;
        var userName = Context.User.Identity?.Name;
        
        await Clients.All.SendAsync("ReceiveMessage", userId, userName, message);
    }
}

3. 配置中间件顺序
   中间件的顺序很重要，必须先加身份验证，再加授权，最后映射Hub：

app.UseAuthentication();
app.UseAuthorization();

// 映射你的Hub端点
app.MapHub<ChatHub>("/hubs/chat");

客户端配置步骤 #

分JS和.NET客户端两种情况，都是适配Alpha版的传Token方式：

JavaScript客户端（浏览器） #

用@microsoft/signalr包的话，直接用accessTokenFactory来自动传递Token，它会帮你把Token加到查询字符串的access_token参数里，刚好对应服务端的提取逻辑：

import * as signalR from "@microsoft/signalr";

// 创建Hub连接
const connection = new signalR.HubConnectionBuilder()
    .withUrl("/hubs/chat", {
        // 这里返回你的JWT Token，实际项目里从本地存储/后端接口获取
        accessTokenFactory: () => "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
    })
    .build();

// 启动连接
connection.start().catch(err => console.error(err.toString()));

// 调用Hub方法示例
connection.invoke("SendPublicMessage", "Hello from client!").catch(err => console.error(err));

.NET客户端 #

.NET客户端的配置类似，用AccessTokenProvider来传递Token：

using Microsoft.AspNetCore.SignalR.Client;

var connection = new HubConnectionBuilder()
    .WithUrl("https://your-api-domain/hubs/chat", options =>
    {
        // 返回你的JWT Token，实际项目里从认证接口获取
        options.AccessTokenProvider = () => Task.FromResult("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...");
    })
    .Build();

await connection.StartAsync();

// 调用Hub方法
await connection.InvokeAsync("SendPublicMessage", "Hello from .NET client!");

几个注意事项 #

• Alpha版的SignalR API可能随时变动，如果碰到编译错误，优先看你用的那个Alpha版本的代码注释或者官方更新日志，别硬套正式版的写法
• 确保你的JWT Token里包含需要的Claims（比如NameIdentifier、Name），这样才能在Hub的Context.User里拿到正确的用户数据
• 测试时可以先用JWT生成工具生成一个符合你服务端验证规则的Token，替换到客户端代码里验证功能是否正常

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