身份认证与房间权限

用连接中间件识别用户,在加入和发送消息时检查房间权限。

🎯 引言

上一篇用房间隔离了消息,但所有客户端都可以选择 room1 或 room2。现在增加一条规则:room1 允许用户A和用户B进入,room2 只允许用户A进入。后端需要先判断连接属于谁,再决定这个用户能做什么。


🧱 先识别用户,再检查权限

身份认证解决“你是谁”。客户端携带凭证,服务端验证后取得用户身份。权限检查解决“你能做什么”。例如用户B的身份有效,可以连接服务,但进入 room2 的请求会被拒绝。

本篇沿用上一节的项目,只增加认证和权限代码。预期行为如下:

客户端凭证服务端识别的用户能否连接room1room2
demo-token-a用户A允许允许允许
demo-token-b用户B允许允许拒绝
wrong无法识别拒绝无法请求无法请求

token 是客户端携带的身份凭证。实际应用通常在登录成功后发给客户端,连接 Socket.IO 时再提交。本课用固定的两条凭证模拟已经完成的登录,先把 Socket.IO 如何接收和校验凭证讲清楚。


🛠 在接受连接前验证凭证

在 server.mjs 中,创建 io 之后、注册 connection 监听之前,加入以下代码。

const sessions = new Map([
    ['demo-token-a', { userId: 'A' }],
    ['demo-token-b', { userId: 'B' }]
]);

io.use((socket, next) => {
    const token = socket.handshake.auth?.token;
    const session = sessions.get(token);

    if (!session) {
        next(new Error('UNAUTHENTICATED'));
        return;
    }

    socket.data.userId = session.userId;
    next();
});

sessions 是凭证到用户的对应表,sessions.get(token) 根据凭证查找用户,找不到时得到 undefined。这个固定表只用于练习,正式登录系统还需要处理有效期、注销和用户禁用。

io.use 注册连接中间件,也就是接受连接前执行的检查函数。客户端连接时提交的 auth 数据可以从 socket.handshake.auth 读取,?. 让未提交 auth 时也能安全读取。

中间件通过 next 告诉 Socket.IO 检查结果:

  • 调用 next(),继续建立连接,成功后进入服务端的 connection 回调。
  • 调用 next(error),拒绝这次连接,客户端收到 connect_error,服务端不会为它执行 connection 回调。

认证成功后,把用户 ID 写入 socket.data.userId,后续业务直接读取这个服务端已经确认的身份。中间件文档

客户端怎样提交 token

在 client.mjs 中,用下面代码替换原来的 socket 创建语句。已有的事件监听继续保留。

const socket = io('http://localhost:3000', {
    auth: {
        token: 'demo-token-a'
    }
});

执行 io 时仍会自动发起连接,auth 随连接请求提交。客户端无须另发一个“登录事件”。

重启服务端,再运行客户端,先用有效凭证验证能加入原来的房间。然后把 token 改为 wrong,结束客户端进程后重新运行。

  • 有效凭证:客户端继续执行 connect 回调,请求加入房间。
  • 无效凭证:已有的 connect_error 监听打印 连接失败 UNAUTHENTICATED。
  • 无效凭证的客户端不会执行 connect 回调,所以不会继续请求加入或发送消息。

测试结束后恢复有效 token。


🔐 在加入和发送时检查权限

在服务端 connection 回调外定义下面的函数,加入与发送操作都会使用它。

function canAccess(userId, room) {
    return room === 'room1' || (room === 'room2' && userId === 'A');
}

它返回布尔值:room1 允许已认证用户访问,room2 只允许 ID 为 A 的用户,其他房间返回 false。

加入房间前检查

在 room:join 监听中,房间名校验之后、当前房间检查之前,插入以下代码。

if (!canAccess(socket.data.userId, name)) {
    reply({ ok: false, error: '无权加入该房间' });
    return;
}

只有权限检查通过,后面的 join 才会执行。用户B请求加入 room2 时,连接仍保持,当前房间也不会变化,只是这次加入请求被拒绝。

发送消息前再次检查

在 chat:send 监听中,“请先加入房间”的检查之后、文本校验之前,加入以下代码。

if (!canAccess(socket.data.userId, socket.data.room)) {
    reply({ ok: false, error: '无权在该房间发送消息' });
    return;
}

本课权限固定不变。实际群聊可能在用户已连接时移除其成员资格,因此执行操作时还要检查当时的权限。若用户被撤销接收权限,服务端也应把相应连接移出房间,防止继续收到推送。

用已认证身份标记发送者

把原来的广播语句替换为下面这段。senderId 取自服务端认证结果。

io.to(socket.data.room).emit('chat:message', {
    senderId: socket.data.userId,
    text: text.trim()
});

上一篇的客户端只打印文字。要同时看到身份,把 chat:message 监听替换为:

socket.on('chat:message', (message) => {
    console.log(`[用户${message.senderId}] ${message.text}`);
});

用户A发送“你好”时,应打印 [用户A] 你好。即使把消息文字改成“我是用户B”,显示的发送者仍是用户A,因为文字内容不会改变认证结果。


❓ 知识问答

Q1:连接认证成功后,每次发消息还会执行 io.use 吗?

不会。这里的中间件在连接建立时执行,后续消息由各自的事件监听处理。正式应用中,登录会话可能过期或被撤销,业务应按需要在操作前复查会话,或主动断开失效会话的连接。

Q2:能用 socket.id 作为用户身份吗?

socket.id 标识一次连接,用户重新连接通常会获得新的值,同一用户也可以同时拥有多条连接。本篇的 userId 来自凭证验证,用它表示业务用户。


🧪 小练习

使用上一节的客户端代码,确保 connect 回调仍然是在加入成功后发送消息。若此前做过退出实验,先恢复这个回调。设置 text 为“你好”,分别修改 token 和 room,每次结束旧客户端后重新运行。

  1. token 为 demo-token-a,room 为 room2。
    • 加入结果为成功。
    • 收到 [用户A] 你好。
    • 发送结果为成功。
  2. token 为 demo-token-b,room 为 room2。
    • 加入结果为 { ok: false, error: '无权加入该房间' }。
    • 没有聊天消息和发送成功输出,因为客户端在加入失败后结束回调。
  3. 保持 demo-token-b,把 room 改为 room1。
    • 加入与发送成功。
    • 收到 [用户B] 你好。

把结果与开头的权限表逐项核对,确认身份验证和房间授权分别起到了作用。


🎉 服务端现在能识别用户,并按身份决定是否允许加入和发送消息。