feat: 遮蔽后台静态产物中的 Taro 指纹
Traefik 把 wechat.app.que01.top 上除 /api、/media 以外的路径直接转发到 Admin 静态 服务器且没有鉴权,因此 /admin/assets/*.js 可以被任意下载。后台产物里的模板 renderer glob 路径(packages/template-*/taro/index.tsx)与按钮尺寸令牌(--taro-button-height) 同样暴露技术栈,此前只遮蔽了 Taro 双端产物。 - mask-taro.cjs 增加 admin 目标,覆盖 apps/admin/dist,接入根脚本 build:admin:preview; - deploy:package 在后台构建后校验 apps/admin/dist,命中指纹即中止打包; - 补充遮蔽目标测试与文档(ADR 0025、README、部署说明、交付清单)。 验证:后台产物遮蔽后 glob key 与运行时查找同步改名;未遮蔽/已遮蔽产物用生产静态 服务器跑同一套后台浏览器测试,失败内容逐字节一致(既有失败与本改动无关);H5 预览 11 项浏览器回归全部通过;admin 构建、lint、typecheck、deploy 与 API 测试通过。
This commit is contained in:
1 parent
9ad2776515
commit
4d1cd8f365
8 files changed
+63
-8
No files matched your search
+2
-1
@@ -37,10 +37,11 @@ TEMPLATE_KEY=linjing-editorial pnpm --filter @personal-brand/taro build:weapp
|
||||
|
||||
## 构建产物遮蔽
|
||||
|
||||
生产构建会调用构建后处理脚本 `config/mask-taro.cjs`,按 `config/mask.config.json` 替换产物里的 Taro 标识符(文件名与内容使用同一张表),遮蔽后仍命中 `forbidden` 词表时构建失败。`build:h5`、`build:weapp`、`build:preview` 都已接入;`dev:h5`、`dev:preview` 保持原始命名便于调试。改架构名只改 `config/mask.config.json`;复核某次产物是否干净用:
|
||||
生产构建会调用构建后处理脚本 `config/mask-taro.cjs`,按 `config/mask.config.json` 替换产物里的 Taro 标识符(文件名与内容使用同一张表),遮蔽后仍命中 `forbidden` 词表时构建失败。`build:h5`、`build:weapp`、`build:preview` 都已接入,后台静态产物由根脚本 `pnpm build:admin:preview` 用 `admin` 目标覆盖;`dev:h5`、`dev:preview` 保持原始命名便于调试。改架构名只改 `config/mask.config.json`;复核某次产物是否干净用:
|
||||
|
||||
```sh
|
||||
TEMPLATE_KEY=acheng-campus-food node config/mask-taro.cjs weapp --check
|
||||
node config/mask-taro.cjs admin --check
|
||||
```
|
||||
|
||||
由于产物名称与源码名称不同,产物契约测试用 `test/mask-names.mjs` 的 `unmask()` 还原后再断言,浏览器测试的选择器写成 `:is(<源码名>, <遮蔽名>)`。机制与取舍见 [docs/adr/0025-build-output-stack-masking.md](../../docs/adr/0025-build-output-stack-masking.md)。
|
||||
|
||||
@@ -8,6 +8,7 @@
|
||||
* node config/mask-taro.cjs weapp 处理后 dist/<template>/weapp
|
||||
* node config/mask-taro.cjs h5 处理后 dist/<template>/h5
|
||||
* node config/mask-taro.cjs h5 --preview 处理后 dist/template-preview/h5
|
||||
* node config/mask-taro.cjs admin 处理后后台静态产物 apps/admin/dist
|
||||
* node config/mask-taro.cjs weapp --check 只检查是否仍有指纹,不修改
|
||||
*/
|
||||
const fs = require("node:fs");
|
||||
@@ -75,6 +76,8 @@ function maskFileName(name, replacements) {
|
||||
|
||||
function resolveTargets(envType, preview) {
|
||||
if (preview) return [path.join(taroRoot, "dist/template-preview/h5")];
|
||||
// 后台静态产物同样对外可达,其中的模板 renderer 路径与按钮尺寸变量也会带出指纹。
|
||||
if (envType === "admin") return [path.resolve(taroRoot, "../admin/dist")];
|
||||
const templateKey = process.env.TEMPLATE_KEY;
|
||||
if (!templateKey) throw new Error("TEMPLATE_KEY is required for non-preview masking");
|
||||
return [path.join(taroRoot, "dist", templateKey, envType)];
|
||||
@@ -192,6 +195,6 @@ function main() {
|
||||
if (failed) process.exit(1);
|
||||
}
|
||||
|
||||
module.exports = { maskText, maskFileName, maskDirectory, findLeaks, loadConfig };
|
||||
module.exports = { maskText, maskFileName, maskDirectory, findLeaks, loadConfig, resolveTargets };
|
||||
|
||||
if (require.main === module) main();
|
||||
@@ -7,7 +7,13 @@ import { createRequire } from "node:module";
|
||||
import { maskConfig, masked, unmask } from "./mask-names.mjs";
|
||||
|
||||
const require = createRequire(import.meta.url);
|
||||
const { maskText, maskFileName, maskDirectory, findLeaks } = require("../config/mask-taro.cjs");
|
||||
const {
|
||||
maskText,
|
||||
maskFileName,
|
||||
maskDirectory,
|
||||
findLeaks,
|
||||
resolveTargets,
|
||||
} = require("../config/mask-taro.cjs");
|
||||
|
||||
const replacements = maskConfig.replacements;
|
||||
/** 长度超过 40 的 base64/哈希片段,遮蔽时必须原样保留。 */
|
||||
@@ -31,6 +37,27 @@ test("遮蔽表在测试与构建之间保持一致", () => {
|
||||
);
|
||||
});
|
||||
|
||||
test("遮蔽目标覆盖双端产物、预览与后台静态产物", () => {
|
||||
const taroRoot = path.resolve(import.meta.dirname, "..");
|
||||
const previous = process.env.TEMPLATE_KEY;
|
||||
try {
|
||||
process.env.TEMPLATE_KEY = "example-template";
|
||||
assert.deepEqual(resolveTargets("weapp", false), [
|
||||
path.join(taroRoot, "dist/example-template/weapp"),
|
||||
]);
|
||||
assert.deepEqual(resolveTargets("h5", false), [
|
||||
path.join(taroRoot, "dist/example-template/h5"),
|
||||
]);
|
||||
assert.deepEqual(resolveTargets("h5", true), [path.join(taroRoot, "dist/template-preview/h5")]);
|
||||
assert.deepEqual(resolveTargets("admin", false), [path.resolve(taroRoot, "../admin/dist")]);
|
||||
delete process.env.TEMPLATE_KEY;
|
||||
assert.throws(() => resolveTargets("weapp", false), /TEMPLATE_KEY/);
|
||||
} finally {
|
||||
if (previous === undefined) delete process.env.TEMPLATE_KEY;
|
||||
else process.env.TEMPLATE_KEY = previous;
|
||||
}
|
||||
});
|
||||
|
||||
test("文本遮蔽改标识符但不损坏不透明数据段", () => {
|
||||
const content = `var tmpl="taro_tmpl";var key="${opaqueRun}";const modifyTaroEvent=1;`;
|
||||
const result = maskText(content, replacements);
|
||||
|
||||
Reference in new issue
Block a user