PromptConduit 修补登录与会话安全边界
PromptConduit 分享了基于 Cloudflare Workers 的 TypeScript API 登录加固实践,涉及网页 OAuth 和命令行设备授权。修复围绕账号停用、自动化登录请求泛滥,以及会话令牌经 URL 或日志泄露的风险。
AI 深度解读
员工停用后,手里的 JWT、会话 Cookie 和 API Key 还能用多久?PromptConduit 的作者在代码审查中发现,三种凭证都能绕过账户停用和软删除。他们团队随后合并了三项改动,把账户状态检查放进每次鉴权,给匿名登录入口限流,并用一次性兑换码把会话 JWT 移出跳转 URL。
这套服务为 Claude Code、Cursor、Copilot 等 AI 编程工具汇总团队使用数据。对负责登录的前端和全栈同学,最值得看的是两个细节:现有凭证如何随账户停用一起失效,以及浏览器如何在 OAuth 跳转后接收会话。
停用账户要拦住已经签发的凭证
PromptConduit 是跑在 Cloudflare Workers 上的 TypeScript API,使用 D1。网页支持 Google 和 GitHub OAuth,CLI 的 promptconduit login 走 RFC 8628 设备授权流程。系统没有密码登录、刷新令牌和 SAML。作者记录的三个 PR(#244、#245、#247)于 2026 年 10 月 14 日合入私有仓库。
修复前,getUserById 忽略了 is_active 和 deleted_at。用户即使被停用,手里的 Bearer JWT、会话 Cookie 或 API Key 仍能通过鉴权。#244 把账户状态判断放进三种凭证共用的 authenticateRequest 路径。设备授权审批也走这条路径,所以停用用户无法继续签发 CLI 密钥,软删除时也省掉了为阻断访问而逐把吊销 API Key 的步骤。
下面这段查询沿用每次请求原本就有的用户读取,在返回用户前补上状态判断。
const user = await db.select(/* … */).from(users)
.where(eq(users.id, userId))
.get();
// A soft-deleted or deactivated user loses access through every credential
// (JWTs, session cookies, API keys), not just new sign-ins. NULL is_active is
// treated as active, matching the column default, so legacy rows keep access.
if (!user || user.isActive === false || user.deletedAt) return null;
最后一行用 === false 保留了旧数据的行为:is_active 为 NULL 的用户仍视为启用,但只要存在 deleted_at,就会被拦下。
作者用 fake D1 和真实的 Drizzle 调用链跑了 11 个用例。三种凭证分别覆盖启用、停用、软删除,再加一条状态为 NULL 的旧记录和一个未知用户。撤回修复后,停用和软删除对应的 6 个用例失败。
登录入口限流要兼顾数据库和 CLI
每次发起 OAuth 登录都会向 D1 写一行状态记录。大量匿名请求即使没走完登录,也会消耗数据库写入。#245 用 Cloudflare Workers 的限流绑定,按 cf-connecting-ip 计数,封装成 rateLimited(binding, period, handler, onLimited?)。它覆盖 GET /v1/auth/google、GET /v1/auth/github、设备码创建、设备令牌轮询和设备授权。#247 又加上 POST /v1/auth/exchange,Google 和 GitHub 回调保持不限流。
通常超过限制会返回 HTTP 429 和 Retry-After。设备令牌轮询则返回 RFC 8628 的 slow_down,因为 CLI 收到它会放慢轮询,而其他非 400 状态会被当成登录失败。设备授权入口的限制也能放慢对 user_code 的猜测。过期且未使用的 OAuth 状态和设备码由定时任务清理。
阈值按生产流量设定,作者说考虑了办公室共用出口 IP 的场景,但没有公布具体值。Cloudflare 各地点的计数是近似值,适合压住短时洪峰。
PKCE 和一次性兑换码解决的是两段交接
#247 先补上 Google 和 GitHub 登录的 PKCE。发起登录时,服务端生成由 32 个随机字节经 Base64URL 编码得到的 code_verifier,存进有效期为 5 分钟的 oauth_states。发给提供方的是 code_challenge,算法通过 code_challenge_method=S256 指定。回调时再通过 grant_type=authorization_code 兑换授权码,并提交原始 code_verifier。校验值始终留在服务端,提供方据此核对兑换请求是否对应最初发起的登录。
部署时已经发起的登录没有保存 code_verifier,回调代码允许这批请求在状态到期前完成。部署冒烟测试要求提供方的跳转 URL 带上 S256 challenge。CLI 继续走设备授权流程,不使用 PKCE。
另一段交接发生在 PromptConduit 和浏览器之间。原来的 /oauth/callback?token=<JWT>&provider=…&email=…&isNewUser=… 可能让 JWT 进入浏览器历史、日志和 Referer。现在只跳转到 /oauth/callback?code=<exchange code>。前端用 history.replaceState 清掉地址栏里的码,再发起 POST /v1/auth/exchange。兑换码来自 32 个随机字节,有效期为 60 秒,只能用一次,数据库仅存 SHA-256 哈希。
这段代码负责消费兑换码,让同时到达的请求最多有一个拿到记录。
export async function redeemExchangeCode(db: Database, code: string, now = new Date()) {
const row = await db
.delete(oauthExchangeCodes)
.where(eq(oauthExchangeCodes.codeHash, await hashCode(code)))
.returning()
.get();
if (!row || new Date(row.expiresAt).getTime() <= now.getTime()) return null;
return { userId: row.userId, provider: row.provider, isNewUser: row.isNewUser };
}
.delete() 和 .returning() 组成一条 DELETE … RETURNING,避免两个请求先后读到同一条未消费记录。兑换码过期或用户已停用时,接口返回 401。成功时 JWT 从响应体返回,email 和 isNewUser 也从 URL 移除。
我的判断
最有说服力的是账户停用的回归测试。它验证了三类旧凭证在账户状态变化后都能被拒绝,撤回改动还能复现问题。这里的成本前提是服务本来就逐请求读用户表。如果团队当前只做 JWT 本地验签,短有效期可以缩短旧凭证还能使用的时间,逐请求查状态则可以更快生效,但会增加一次读取。另一个前提是身份提供方的离职事件得先反映到应用自己的账户状态里,原文没有交代这一步。
限流阈值的选择属于团队经验。作者没有提供上线前后的 D1 写入量、误限比例或对照数据,能借鉴的是按入口成本设限,以及保留 CLI 能理解的重试语义。一次性兑换码适合需要在浏览器中接收 JWT 的流程。如果产品可以在 OAuth 回调响应里直接设置 HttpOnly 会话 Cookie,再跳转回站内页面,就能省掉一次前端兑换请求,具体取决于前端和 API 的域名部署及会话设计。
能拿来做什么
- 给 Node API 写一组停用账户的回归用例。先取得 JWT、会话 Cookie 和 API Key,再停用测试用户,用原来的凭证请求受保护接口。
- 给 OAuth 回调加浏览器测试。检查最终地址栏和跳转 URL,确认没有 JWT,再用同一个兑换码发两次并发请求,验证最多成功一次。
- 给带网页登录的 CLI 测一次设备轮询限流。确认客户端收到
slow_down后会延长等待时间,并能接着完成登录。