Spaces:
Running
Running
Download lib/entitlement-verify.js from XWX-AI/api-server: direct link, hf CLI and curl.
- Browser
- Download file 3.95 kB
-
https://huggingface.co/spaces/XWX-AI/api-server/resolve/main/lib/entitlement-verify.js
- Command line
-
hf download hf://spaces/XWX-AI/api-server/lib/entitlement-verify.js
-
curl -L -o entitlement-verify.js https://huggingface.co/spaces/XWX-AI/api-server/resolve/main/lib/entitlement-verify.js
3.95 kB
| /** | |
| * 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 <token>` 送到本服务; | |
| * 本模块用公钥**本地验签**(零网络回源),验过且 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,绝不打印)。 | |
| */ | |
| ; | |
| 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 }; | |