- mint_public_link:AI 只传文件名,core 在进程内直接 publicFiles.mint() 签出短命公网链接,返回单行 URL;校验 = base_url 已配 + resolveInTask 沙箱 + 确认是文件 + realpath 未跳出任务
目录
- 删除 routes/public-link.js 与 server.js 里的签发端口(PUBLIC_LINK_PORT/8081):该接口对 AI 已冗余(进程内签发不绕 HTTP,也不存在带不了凭据的问题);public_link 配置项收窄为 mint_public_link 的开关,不再监听额外端口
- 跟进:definitions.json/HANDLERS 注册;config.example.yml、config.js、public-files.js、download-token.js、routes/files.js 注释;ARCHITECTURE(目录树/部署图/关键约束/5.4 工具表)、DEPLOY 4.1、init.sh 自检改探 /p/<id>、两个 README(工具数 16、公网链接说明)
- 注:docker-compose.yml 一并带上此前工作区的 VIRTUAL_HOST/my-app-network 改动
47 lines
1.7 KiB
JavaScript
47 lines
1.7 KiB
JavaScript
// 临时链接签名(files.js 的浏览器下载链接用)。
|
||
//
|
||
// 设计要点:
|
||
// - 密钥进程内随机:重启后所有旧链接自动失效。公网链接本来就该短命,这是免费拿到的性质。
|
||
// - 签名覆盖「会话 + 路径 + 过期时间」三项,任何一项被改都会验签失败;
|
||
// 验签用 timingSafeEqual,不做按字节比较的旁路。
|
||
// - 这里只提供"怎么签";"给谁签、能签什么"由调用方决定(见 routes/files.js 的校验)。
|
||
'use strict';
|
||
|
||
const crypto = require('crypto');
|
||
|
||
const SECRET = crypto.randomBytes(32).toString('hex');
|
||
|
||
// 浏览器原生下载用:前端拿到后立刻 window.location.href 导航,5 分钟足够
|
||
const BROWSER_TTL_MS = 5 * 60 * 1000;
|
||
|
||
function signPayload(payload) {
|
||
return crypto.createHmac('sha256', SECRET).update(payload).digest('hex');
|
||
}
|
||
|
||
function sameHex(a, b) {
|
||
try {
|
||
return crypto.timingSafeEqual(Buffer.from(String(a), 'utf8'), Buffer.from(String(b), 'utf8'));
|
||
} catch (_) { return false; }
|
||
}
|
||
|
||
function validPayload(payload, expires, t) {
|
||
const exp = Number(expires);
|
||
if (!t || !Number.isFinite(exp) || exp < Date.now()) return false;
|
||
return sameHex(signPayload(payload), t);
|
||
}
|
||
|
||
// 下载链接的报文形状(唯一一份;files.js 签发与验签都走它,避免两边写歪)
|
||
function downloadPayload(sessionId, rel, expires) {
|
||
return sessionId + '\n' + rel + '\n' + expires;
|
||
}
|
||
|
||
function signDownload(sessionId, rel, expires) {
|
||
return signPayload(downloadPayload(sessionId, rel, expires));
|
||
}
|
||
|
||
function validDownload(sessionId, rel, expires, t) {
|
||
return validPayload(downloadPayload(sessionId, rel, expires), expires, t);
|
||
}
|
||
|
||
module.exports = { BROWSER_TTL_MS, signPayload, sameHex, validPayload, signDownload, validDownload };
|