From eccde61c056921534a0d820d34b4b961c60171d1 Mon Sep 17 00:00:00 2001 From: ThearchyHelios Date: Tue, 6 Oct 2026 12:13:49 +0800 Subject: [PATCH] =?UTF-8?q?=E5=8F=AF=E9=AA=8C=E8=AF=81=E6=8A=A5=E5=91=8A?= =?UTF-8?q?=E9=87=8C=E8=A2=AB=E6=94=B9=E8=BF=87=E3=80=81=E8=A7=A3=E6=9E=90?= =?UTF-8?q?=E4=B8=8D=E5=87=BA=E7=9A=84=E5=8F=A3=E5=BE=84=E5=8D=A1=E4=B8=8D?= =?UTF-8?q?=E5=86=8D=E5=8E=9F=E6=A0=B7=E5=B5=8C=E5=85=A5=EF=BC=9A=E9=81=AE?= =?UTF-8?q?=E7=BD=A9=E6=8C=89=E5=8D=A1=E4=B8=8A=E8=AE=B0=E7=9A=84=E8=BE=93?= =?UTF-8?q?=E5=85=A5=E8=AE=A4=EF=BC=8C=E4=B8=8D=E7=9C=8B=E5=93=88=E5=B8=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - bundle/build.py 的 _Store.card_masked 以前先看哈希:服务端的卡文件被改过(哈希对不上)时当它没有输入, 不算带遮罩,_Artifacts.add 随后把原字节 base64 嵌进页面,卡上记着的遮罩列号码进了文件;解析不了的卡同样原样 嵌入。这和同一文件里快照的做法相反(content 不看哈希,读不出来的快照按带遮罩算)。现在卡按解析出来的内容认 遮罩,不看哈希;读得出字节、解析不出一张卡的(截断的 JSON、不是对象)认不出输入,整张按带遮罩算、只给 id。 改过但没有遮罩列的卡照旧原样嵌入,浏览器自己算出哈希对不上。 - 补用例:改了口径版本、哈希对不上的卡只给 id、页面里没有号码;改过但不带遮罩列的照常嵌入;截断的 JSON、 不是对象的卡只给 id。恢复成先看哈希时这三条变红。 --- backend/app/bundle/build.py | 18 +++++++--- backend/tests/test_bundle_masked_cards.py | 42 +++++++++++++++++++++-- 2 files changed, 53 insertions(+), 7 deletions(-) diff --git a/backend/app/bundle/build.py b/backend/app/bundle/build.py index 90fca722..55246405 100644 --- a/backend/app/bundle/build.py +++ b/backend/app/bundle/build.py @@ -10,7 +10,8 @@ - 工件:每份报告文档(各报告节点最后一次自查记下的 doc_artifact)、它引用到的口径卡和查询快照,按原字节 base64 嵌入,浏览器重算 sha256 和 id 比;带遮罩的快照不嵌内容、只给 id。口径卡上记着每个输入的值和代入式, 有输入取自遮罩列(cell() 的格、Agent 字段、按位置取的 vars.res.rows[0][2])的整张卡同样只给 id,认法和证据 - 面板、推演同一个(recompute.input_origin)。没被报告引用的工件不嵌。 + 面板、推演同一个(recompute.input_origin);服务端文件被改过的卡照样按卡上记的输入认,解析不出一张卡的整张只给 + id。没被报告引用的工件不嵌。 - 封存之后追加的事件(按需裁判、审批质询这类批注)单列:类型、序号、内容摘要,不进清单。 它只证明「内部一致」:数字、文档、运行记录彼此对得上,而且没被改过。真伪要拿页面上的封存哈希和系统里这次 @@ -116,17 +117,24 @@ class _Store: 认哪个输入取自哪份查询结果的哪几列,和证据面板、推演同一个认法(recompute.input_origin);按位置取的一格顺着 取值链从写变量的节点在口径卡算这一次之前的产出起走。核对不了的宁可多挡:快照读不出来、取值链上的产出读不出来、 那份结果没存快照只带着数据源名、定位里没写列。认得出、可结果既没带快照的 id 也没带数据源名的(数据整形改过形状) - 认不出出处,不算。读不出来的卡本来就不嵌,这里不管。""" + 认不出出处,不算。 + + 卡本身按解析出来的内容认,不看哈希(同 content):服务端的文件被改过,嵌进页面的照样是这份原字节,卡上记着的号码 + 也照样在里面。读得出字节、解析不出一张卡的(截断的 JSON、不是对象)认不出有哪些输入,整张按带遮罩算,和读不出来的 + 快照按带遮罩算(_snapshot_masked)是同一个道理。字节都读不出来的卡本来就不嵌(只给 id、标缺失),这里不管。""" key = f"card:{artifact}" if key not in self._masked: - card = self.content(artifact) if self.intact(artifact) else None - outputs = _card_outputs(events, artifact) if isinstance(card, dict) else {} + card = self.content(artifact) + if not isinstance(card, dict): + self._masked[key] = self.raw(artifact) is not None + return self._masked[key] + outputs = _card_outputs(events, artifact) def output(node_id: Any) -> Any: found = outputs.get(str(node_id or "")) return self.content(found) if found and self.intact(found) else None - items = [item for metric in (card or {}).get("metrics") or [] if isinstance(metric, dict) + items = [item for metric in card.get("metrics") or [] if isinstance(metric, dict) for item in metric.get("inputs") or [] if isinstance(item, dict)] self._masked[key] = any(self._input_masked(item, output) for item in items) return self._masked[key] diff --git a/backend/tests/test_bundle_masked_cards.py b/backend/tests/test_bundle_masked_cards.py index 11f8d917..5a142e59 100644 --- a/backend/tests/test_bundle_masked_cards.py +++ b/backend/tests/test_bundle_masked_cards.py @@ -4,6 +4,9 @@ vars.res.rows[0][1]),在这份要发给别人的文件里照样看得到。认哪个输入取自哪份查询结果的哪几列,和证据面板、推演同一个 认法(recompute.input_origin);核对不了的宁可多挡。 +服务端的卡文件被改过(哈希对不上)也照卡上记的输入认:嵌进去的是原字节,号码照样在里面。读得出字节、却解析不出一张卡 +(截断的 JSON、不是对象)的,认不出输入,整张按带遮罩算、不嵌:和读不出来的快照按带遮罩算是同一个道理。 + 工件、事件都是手搭的(会员、号码都是编的),照 tests/test_bundle_build.py 的样子。 """ from __future__ import annotations @@ -27,9 +30,12 @@ def card_with(inputs, substituted="len('000-0001')", expression=f"len({CELL})"): "substituted": substituted, "inputs": inputs}]} -def bundle_of(card, *, outputs=None, source_masks=None): - """一次手搭的运行:会员查询(带遮罩的快照)→ 数据整形(outputs 里的产出)→ 口径卡 → 报告。""" +def bundle_of(card, *, outputs=None, source_masks=None, tamper=None): + """一次手搭的运行:会员查询(带遮罩的快照)→ 数据整形(outputs 里的产出)→ 口径卡 → 报告。tamper 给了就把服务端的 + 卡文件换成 tamper(原字节),id 照旧(文件被改过、哈希对不上)。""" card_id, card_raw = stored(card) + if tamper is not None: + card_raw = tamper(card_raw) doc = doc_of(extra_catalog={"m:gmv": {"alias": "m:gmv", "kind": "metric", "artifact": card_id, "node_id": "card", "locator": {"metric": "gmv"}, "value": 1280.5}}) doc_id, doc_raw = stored(doc) @@ -105,3 +111,35 @@ def test_a_card_reading_a_cell_by_position_is_judged_the_same_way(parsed, masked assert PHONE not in render_html(bundle) else: assert PHONE in base64.b64decode(entry["b64"]).decode() + + +def test_a_card_file_changed_on_the_server_is_still_judged_by_its_inputs(): + """服务端的卡文件被改过(这里改了口径版本,哈希对不上):照样按卡上记的输入认遮罩,记着号码的只给 id。以前先看哈希、 + 对不上就当卡上没有输入,原字节照样嵌进页面,号码进了文件。""" + card = card_with([cell_input("phone", PHONE)]) + bundle, entry = bundle_of(card, tamper=lambda raw: raw.replace(b'"caliber_version":"v1"', b'"caliber_version":"v9"')) + assert entry["id"] == stored(card)[0] + assert entry == {"id": entry["id"], "kind": "metric_set", "node_id": "card", "masked": True} + assert PHONE not in render_html(bundle) + + +def test_a_changed_card_without_masked_inputs_is_still_embedded_for_the_browser_to_judge(): + """改过的卡上没有遮罩列的值:照常原样嵌进去,浏览器自己算出哈希对不上(只是遮罩的判断不再看哈希)。""" + card = card_with([cell_input("spend", 320.0)], substituted="320.0", expression="cell(nodes.members, 0, 'spend')") + changed = stored(card)[1].replace(b'"caliber_version":"v1"', b'"caliber_version":"v9"') + _, entry = bundle_of(card, tamper=lambda raw: changed) + assert "masked" not in entry and base64.b64decode(entry["b64"]) == changed + + +@pytest.mark.parametrize("damage", [ + # 截断的 JSON:号码还在已经写下的那半截里 + lambda raw: raw[: raw.index(b"000-0001") + len(b"000-0001")], + # 解析得出、却不是一张卡(对象) + lambda raw: b'["000-0001"]', +]) +def test_a_card_file_that_does_not_parse_as_a_card_is_not_embedded(damage): + """服务端的卡文件读得出字节、解析不出一张卡:认不出卡上有哪些输入,整张按带遮罩算、只给 id,不原样嵌进页面。""" + card = card_with([cell_input("phone", PHONE)]) + bundle, entry = bundle_of(card, tamper=damage) + assert entry == {"id": entry["id"], "kind": "metric_set", "node_id": "card", "masked": True} + assert PHONE not in render_html(bundle)