身份认证与房间权限
🎯 引言
上一篇用房间隔离了消息,但所有客户端都可以选择 room1 或 room2。现在增加一条规则:room1 允许用户A和用户B进入,room2 只允许用户A进入。后端需要先判断连接属于谁,再决定这个用户能做什么。
🧱 先识别用户,再检查权限
身份认证解决“你是谁”。客户端携带凭证,服务端验证后取得用户身份。权限检查解决“你能做什么”。例如用户B的身份有效,可以连接服务,但进入 room2 的请求会被拒绝。
本篇沿用上一节的项目,只增加认证和权限代码。预期行为如下:
| 客户端凭证 | 服务端识别的用户 | 能否连接 | room1 | room2 |
|---|---|---|---|---|
| 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,每次结束旧客户端后重新运行。
- token 为 demo-token-a,room 为 room2。
- 加入结果为成功。
- 收到
[用户A] 你好。 - 发送结果为成功。
- token 为 demo-token-b,room 为 room2。
- 加入结果为
{ ok: false, error: '无权加入该房间' }。 - 没有聊天消息和发送成功输出,因为客户端在加入失败后结束回调。
- 加入结果为
- 保持 demo-token-b,把 room 改为 room1。
- 加入与发送成功。
- 收到
[用户B] 你好。
把结果与开头的权限表逐项核对,确认身份验证和房间授权分别起到了作用。
🎉 服务端现在能识别用户,并按身份决定是否允许加入和发送消息。
