/** * Entitlement token 本地验签(144 号方案 P1.1:服务端 PRO 优先级)。 * * 来源链路:插件登录后,网站(llm-tools)在 /api/desktop/auth/* 的响应体里 * 下发 `entitlement` 字段 —— 一枚 **EdDSA(Ed25519) 签名的 JWT**(jose SignJWT, * lib/auth/token.ts)。claims 含 plan("pro"|"free")/products/sub/exp。插件把它 * 存入 storage 并随 PDF 作业提交头 `Authorization: Bearer ` 送到本服务; * 本模块用公钥**本地验签**(零网络回源),验过且 plan==="pro" 即享受高优先级。 * * 为什么用 jose 而不是手写 crypto.verify:行业共识(NextAuth 等同款库,社区 * 充分测试)——alg 混淆攻击防护、claims 校验、base64url 边角由它兜住;手写 * 需要自己钉死 alg==='EdDSA' 并处理 small-order key 等已知边角(bun#46252)。 * * 安全与失效语义(刻意保守,绝不因验签把付费用户挡在门外): * - 环境变量 AUTH_SIGNING_PUBLIC_KEY 未配置 ⇒ 功能关闭,所有人按 free 处理 * (灰度上线默认态,与现有行为完全一致); * - 验签任何失败(格式/签名/过期>60s 容差)⇒ 返回 free,**绝不拒绝请求**; * - 只读 plan claim,不落日志不落盘(token 内含 email PII,绝不打印)。 */ 'use strict'; const crypto = require('node:crypto'); const { jwtVerify } = require('jose'); /** base64url(raw 32B 公钥) → Node KeyObject;非法输入返回 null */ function loadPublicKey(b64url) { try { const x = String(b64url || '').trim().replace(/-/g, '+').replace(/_/g, '/'); const raw = Buffer.from(x, 'base64'); if (raw.length !== 32) return null; return crypto.createPublicKey({ key: { kty: 'OKP', crv: 'Ed25519', x: Buffer.from(raw).toString('base64url') }, format: 'jwk', }); } catch { return null; } } /** * @param {Object} [opts] * @param {string} [opts.publicKeyB64Url] 默认读 env AUTH_SIGNING_PUBLIC_KEY; * 测试注入用。空 ⇒ verifyTier 恒返回 'free'(功能关闭态)。 * @param {(m:string)=>void} [opts.log] * @returns {{ verifyTier: (authHeader:string|null|undefined)=>Promise<'pro'|'free'>, * enabled: boolean }} */ function createTierVerifier(opts = {}) { const log = opts.log || ((m) => console.log(m)); const key = loadPublicKey(opts.publicKeyB64Url ?? process.env.AUTH_SIGNING_PUBLIC_KEY); const enabled = key !== null; if (opts.publicKeyB64Url ?? process.env.AUTH_SIGNING_PUBLIC_KEY) { if (!enabled) log('[TIER] AUTH_SIGNING_PUBLIC_KEY set but not a valid Ed25519 raw key — PRO priority disabled'); } if (!enabled) log('[TIER] AUTH_SIGNING_PUBLIC_KEY not set — PRO priority disabled (all jobs free tier)'); async function verifyTier(authHeader) { if (!enabled) return 'free'; const token = typeof authHeader === 'string' && authHeader.startsWith('Bearer ') ? authHeader.slice(7).trim() : null; if (!token) return 'free'; try { const { payload } = await jwtVerify(token, key, { algorithms: ['EdDSA'], clockTolerance: 60 }); // PRO 判据与插件侧 isPro 同口径(entitlement.js isPro):plan==='pro' // **或** products 含 'exporter'。token 的 plan 是 Backup 域语义——只买 // Chat Exporter(exporter)未买 Backup 的付费用户 plan 恒为 'free', // 若只认 plan 会把这部分付费 PRO 判成 free(2026-11-07 本地实测发现)。 if (!payload) return 'free'; const products = Array.isArray(payload.products) ? payload.products : []; return (payload.plan === 'pro' || products.includes('exporter')) ? 'pro' : 'free'; } catch { // 过期/被改/非本服务票据 → 按 free 放行(不拦截、不告警刷屏) return 'free'; } } return { verifyTier, enabled }; } module.exports = { createTierVerifier, loadPublicKey };