计算机网络 / 系统课时

WebSocket 握手阶段怎么鉴权

WebSocket 握手阶段怎么鉴权

WebSocket 建连先经过一次 HTTP Upgrade,因此最稳妥的鉴权点是在返回 101 Switching Protocols 之前。关键不是“能不能带令牌”,而是浏览器能控制哪些握手信息、凭证会暴露在哪里,以及服务端能否在升级前拒绝未授权连接。

学习目标

  • 区分 Cookie、Authorization、查询参数和子协议在浏览器 WebSocket 握手中的可用性。
  • 理解每种凭证传递方式的泄露面、跨站风险和适用边界。
  • 在服务端 Upgrade 阶段完成鉴权,并在失败时不建立 WebSocket 连接。

先分清浏览器能控制哪些握手信息

原生浏览器 API 的构造函数只有 URL 和可选子协议列表:new WebSocket(url, protocols)。浏览器可能自动携带符合 Cookie 规则的 Cookie,但前端 JavaScript 不能给原生 WebSocket 握手任意添加 Authorization 头。非浏览器客户端、移动端原生库或服务间连接通常没有这个限制。

WebSocket 握手鉴权时序

握手阶段应把“身份校验”和“升级协议”串成一个门禁:凭证无效、来源不可信或权限不足时直接返回 HTTP 错误,不要先升级再让未认证连接长期占用资源。

比较四种凭证传递方式

方式 浏览器原生 WebSocket 主要边界 更适合的场景
Cookie 可由浏览器自动携带 需防跨站 WebSocket 劫持,校验 Origin;会话 Cookie 应合理设置 HttpOnly、Secure、SameSite 同站 Web 应用、已有服务端 Session
Authorization 不能由浏览器原生 API 自定义 适用于允许自定义握手头的客户端 服务间连接、原生 App、专用 SDK
查询参数 可以 URL 可能进入代理或访问日志,不宜放长期 Bearer Token 一次性、短时效连接票据
Sec-WebSocket-Protocol 可以通过 protocols 参数发送 本意是子协议协商,服务端要回显被选中的协议;请求头也可能被日志记录 协议协商,不建议承载长期秘密

如果采用 Cookie,会话本身应可过期、撤销,并在服务端验证 Origin。仅仅“浏览器自动带 Cookie”并不等于请求可信,因为恶意站点也可以尝试发起跨站 WebSocket 连接。

查询参数更适合放由普通 HTTPS 接口先换取的短期、一次性 ticket,而不是直接复用长期 Access Token。这样即使 URL 被日志系统看到,凭证的可利用窗口也更小。

在 Upgrade 之前完成拒绝或放行

下面是 Node.js 中使用 ws 的片段示例。它依赖已有 HTTP 服务以及已安装的 ws 包,重点展示鉴权位置:先检查路径、Origin 和 Session Cookie,全部通过后才调用 handleUpgrade。

javascript
import http from "node:http";
import { WebSocketServer } from "ws";

const server = http.createServer();
const wss = new WebSocketServer({ noServer: true });

function reject(socket, status, message) {
  const body = `${message}\n`;
  socket.write(
    `HTTP/1.1 ${status}\r\n` +
    "Connection: close\r\n" +
    "Content-Type: text/plain; charset=utf-8\r\n" +
    `Content-Length: ${Buffer.byteLength(body)}\r\n` +
    "\r\n" +
    body
  );
  socket.destroy();
}

function readSessionId(cookieHeader = "") {
  const pair = cookieHeader
    .split(";")
    .map((item) => item.trim())
    .find((item) => item.startsWith("sid="));

  return pair ? decodeURIComponent(pair.slice(4)) : null;
}

server.on("upgrade", (req, socket, head) => {
  const url = new URL(req.url, "http://localhost");
  if (url.pathname !== "/ws") return reject(socket, 404, "not found");

  const origin = req.headers.origin;
  if (origin !== "https://app.example.com") {
    return reject(socket, 403, "origin rejected");
  }

  const sessionId = readSessionId(req.headers.cookie);
  // 演示值;生产环境应查询真实 Session 存储并检查过期、撤销和权限。
  if (sessionId !== "demo-session") {
    return reject(socket, 401, "unauthorized");
  }

  wss.handleUpgrade(req, socket, head, (ws) => {
    wss.emit("connection", ws, req);
  });
});

wss.on("connection", (ws) => {
  ws.send(JSON.stringify({ type: "ready" }));
});

server.listen(<PORT>);

生效行为与验证方法:把 <PORT> 替换为实际端口,通过反向代理或本地测试客户端发起 Upgrade。缺少有效 sid 时应在 HTTP 阶段得到 401;Origin 不匹配时应得到 403;只有两项都通过时才进入 connection 回调并收到 {"type":"ready"}。真实生产环境不要用固定字符串判断 Session。

把鉴权方式和客户端类型绑定

浏览器站点如果已经使用服务端 Session,Cookie 往往最自然,但必须同时做 Origin 校验和会话安全配置。若系统采用 Token,又必须使用原生浏览器 WebSocket,可以先通过普通 HTTPS API 换取短时一次性 ticket,再把 ticket 放入 WSS 查询参数,并在成功握手后立即作废。

对服务间或原生客户端,若库允许自定义握手头,Authorization: Bearer <TOKEN> 更容易和现有 HTTP 鉴权体系统一。Sec-WebSocket-Protocol 则应优先用于声明 chat.v1、json 之类真正的应用子协议,而不是当作隐蔽的密码通道。

无论选哪种方式,都应使用 wss://,在 101 之前完成身份、来源和权限校验,并对失败连接快速释放资源。这样鉴权边界清晰,代理层和应用层也更容易记录可追踪的拒绝原因。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

WebSocket 握手阶段怎么鉴权

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通