**影响** - 生产档弱密钥守卫从「只比默认值」升级为上游 `ProdGuard` 的**六条判据**(纯函数), 弱令牌用「默认值加后缀」绕过、弱标记词、长度下限三类都拦得住;`CIPHER_KEY`(协议共享值)**不受管**。 - 出向 TDS 超时**外置到 env**(`SSW_TDS_CONNECT_TIMEOUT_MS` / `SSW_TDS_READ_TIMEOUT_MS`), 且**只有 cause 链里真有超时**才改写文案 ⇒ 连接被拒 / DNS 失败不再被误报成「超时」(排查方向不被带偏)。 - 上游 15 个测试类全部**登记在册**:3 个已移植(29 条对位用例)、12 个判定超范围(逐条记理由)。 - 新增第五把尺子 `scripts/check-upstream-tests.sh`:台账 ⇄ 代码 ⇄ 上游测试类集合三向对账, 上游新增测试类而台账没登记 ⇒ **红**(不靠"记得看"防漂移)。 - 回归网:`cargo test` 246 → **278**(+32),其余四把尺子与引用自检**全绿**。 **改动** - `src/platform/guard.rs`(新):上游 `ProdGuard.violations` 的纯函数移植(弱值清单 / 弱标记词整体词匹配 / `MIN_LEN=12` / 逐条点名)。 - `src/platform/config.rs`:`check_secret_guard` 改走守卫判据;新增 `guard_values`(只放本部署真有的键) 与出向超时两项配置(非法值回落默认,不让连接器起不来)。 - `src/tdc/client/tds.rs`:新增 `cause_chain_has_timeout` / `timeout_text_or_null`(cause 链遍历**有界** `depth<16`), `TdsClient::with_timeouts` 接受超时。 - `tests/upstream_guard_parity.rs`(新 · 19 条)+ `tests/upstream_tds_timeout_parity.rs`(新 · 10 条)。 - `scripts/upstream-test-ledger.tsv`(台账真源)+ `scripts/upstream-test-census.py`(上游测试类普查/对账) + `scripts/check-upstream-tests.sh`(第五把尺子)。 - 文档:`docs/UPSTREAM-TEST-PARITY.md`(新)+ `docs/known-limitations.md` L8 + `docs/decisions.md` D22/D23 + `CLAUDE.md` 同步(尺子表 / 目录树 / 命令速查 / 实现细节 22–23 / 坑位表)。 **设计** - 上游 hop 1 的「反射读 socket 工厂」**抄不了**(`reqwest::Client` 不暴露超时 getter)⇒ 改用**行为级**判别 (同一延迟 TCP 服务器:短超时⇒超时错、长超时⇒成功)⇒ 结论等价且更强(真跑 socket 层)。 - 上游 `*SelfTest.java` **surefire 不跑**(无统一入口)⇒ 判据落成 `cargo test` 常规用例(纯函数 ⇒ 可离线断言)。 - 超范围判定原则:**本仓没有对应功能 ⇒ 不搬**(硬搬只会是假绿);「机制」已覆盖的(P2P 那条)按机制记账。 Co-Authored-By: Claude Code <[email protected]>
37 lines
7.6 KiB
Plaintext
37 lines
7.6 KiB
Plaintext
# 上游测试用例台账(tdc-rs ↔ 上游 TDC/TDS/ssw-common)
|
||
#
|
||
# 🔴 **本文件是「上游有哪些测试用例、我们搬没搬」的唯一真源** ⇒
|
||
# `scripts/check-upstream-tests.sh` 对账(上游新增一个测试类而台账没记 ⇒ 红)。
|
||
#
|
||
# 列(制表符分隔):
|
||
# 1 upstream_class 上游全限定类名(ssw.common.guard.ProdGuardSelfTest …)
|
||
# 2 upstream_repo TDC | TDS | COMMON(ssw-common 两侧都有 ⇒ 记 COMMON)
|
||
# 3 upstream_file 相对**克隆根目录**的路径(克隆根可用环境变量覆盖)
|
||
# 4 kind JUNIT(有 @Test,surefire 跑)| SELFTEST(纯 main,**surefire 不跑**)
|
||
# 5 assertions 上游断言条数(`-` = 未逐条计数)
|
||
# 6 tdc_counterpart 本仓对位用例:`文件::fn1+fn2+…`(`-` = 无对位)
|
||
# 7 status PORTED | OUT-OF-SCOPE
|
||
# 8 reason 搬法说明(PORTED)/ 不搬的理由(OUT-OF-SCOPE)
|
||
#
|
||
# ⚠️ 上游的 `*SelfTest.java` **没有 runner 接线**(surefire 只跑 junit 的 `@Test`)
|
||
# ⇒ 上游仓库自己靠 `tools/run-java-selftests.sh` 人工跑
|
||
# ⇒ 本仓把它们落成 `cargo test` 的常规用例(判据是纯函数 ⇒ 可离线断言)。
|
||
#
|
||
# ⚠️ 台账里的 `upstream_file` 只在**上游克隆在场**时才校验;克隆不在 ⇒ 跳过该校验(不判红)。
|
||
|
||
ssw.common.guard.ProdGuardSelfTest COMMON boot/ssw-common/ssw-common-biz/src/test/java/ssw/common/guard/ProdGuardSelfTest.java SELFTEST 10 tests/upstream_guard_parity.rs::prod_guard_cipher_key_is_not_guarded+prod_guard_default_weak_values_are_still_blocked+prod_guard_strong_values_are_all_allowed+prod_guard_blank_value_is_named+prod_guard_default_value_with_suffix_is_blocked+prod_guard_too_short_value_is_blocked+prod_guard_violation_message_names_the_key+prod_guard_absent_key_is_not_falsely_blocked+prod_guard_exact_weak_value_is_blocked+prod_guard_weak_marker_word_is_blocked+prod_guard_weak_marker_is_whole_word_only+prod_guard_min_len_is_enforced PORTED 六条判据逐条照抄上游 ProdGuard.violations(缺一即空检查):①键不在map⇒跳过 ②值为null/空白⇒违规 ③精确等于弱值⇒违规 ④含弱值片段⇒违规(反绕过)⑤含弱标记词⇒违规 ⑥长度<12⇒违规;上游⓪「security.security-key 不再受管」映射为「CIPHER_KEY(协议共享值)不受管」
|
||
ssw.tds.controller.SswProdRuntimeGuardSelfTest TDS boot/ssw-tds/ssw-tds-controller/src/test/java/ssw/tds/controller/SswProdRuntimeGuardSelfTest.java SELFTEST 12 tests/upstream_guard_parity.rs::runtime_guard_non_prod_never_violates+runtime_guard_prod_with_empty_token_violates+runtime_guard_prod_with_null_token_violates_without_panic+runtime_guard_prod_with_default_token_violates+runtime_guard_prod_with_strong_token_passes+runtime_guard_is_discriminable_on_the_prod_switch+runtime_guard_no_deployment_flag_unlocks_a_weak_token PORTED 10 条里搬了 7 条;未搬的 3 条(② prod+codeDev / ⑧ 未声明测试环境 / ⑨ 已声明测试环境)全属**门户验证码通道**(ssw.portal.code-dev)⇒ 本仓无该通道 ⇒ 记 OUT-OF-SCOPE-PART(见 docs/known-limitations.md L8)
|
||
ssw.tdc.client.ProviderInvokeTimeoutsSelfTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/client/ProviderInvokeTimeoutsSelfTest.java SELFTEST 11 tests/upstream_tds_timeout_parity.rs::hop1_injected_timeout_actually_reaches_the_socket_layer+hop1_changing_the_injected_value_changes_the_client+hop2_read_timeout_is_rewritten_and_names_current_values+hop2_connect_timeout_is_rewritten+hop2_connection_refused_is_not_rewritten+hop2_dns_failure_is_not_rewritten+hop2_no_cause_is_not_rewritten+hop2_multilevel_wrapped_cause_is_still_detected+hop2_cause_chain_walk_is_bounded+hop2_end_to_end_connection_refused_stays_unreachable PORTED 第1跳(配置值⇒socket工厂)用**行为级**判别替代反射(Rust 的 reqwest::Client 不暴露超时):短超时⇒超时、长超时⇒成功 ⇒ 结论等价且更强;第2跳照抄(只有 cause 链里有超时才改写文案,被拒/DNS/无cause⇒不改写)
|
||
ssw.tdc.service.impl.P2pTransferTimeoutsSelfTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/service/impl/P2pTransferTimeoutsSelfTest.java SELFTEST - - OUT-OF-SCOPE 与 ProviderInvokeTimeoutsSelfTest **同一机制**(反射读 socket 工厂),但判据对象是 **P2P 传输客户端**(P2pTransferClient)⇒ 本仓**没有 P2P 出向通道**(P2P 属上游跨端传输能力,不在本仓范围)⇒ 无判据对象可搬;机制本身已由 ProviderInvoke 那条覆盖
|
||
ssw.tdc.support.ExecNfsSupportTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/support/ExecNfsSupportTest.java JUNIT 10 - OUT-OF-SCOPE 执行侧 **NFS 通道**(ExecNfsSupport.subPath / 拒绝判据)⇒ 属隐私计算执行面,依赖 Nax 引擎 ⇒ 本仓明确不做(见 CLAUDE.md「明确不在本仓库范围」)
|
||
ssw.tdc.engine.NaxPodSupportTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/engine/NaxPodSupportTest.java JUNIT 13 - OUT-OF-SCOPE **Nax 隐私计算引擎** + K8s 拓扑(NodePort 派生 / 探针源码 / tar.gz 投递物)⇒ 本仓不做
|
||
ssw.tdc.client.NaxExecRenderTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/client/NaxExecRenderTest.java JUNIT 4 - OUT-OF-SCOPE Nax 执行 **Pod 模板渲染契约**(YAML 空值删行陷阱)⇒ 依赖 K8s + Nax ⇒ 本仓不做
|
||
ssw.tdc.client.K8sSandboxClientRenderTest TDC boot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/client/K8sSandboxClientRenderTest.java JUNIT 2 - OUT-OF-SCOPE 沙箱执行 **Pod 模板渲染契约** ⇒ 依赖 K8s ⇒ 本仓不做
|
||
ssw.tds.support.MaxkeyRegisterPrecheckSelfTest TDS boot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/support/MaxkeyRegisterPrecheckSelfTest.java SELFTEST - - OUT-OF-SCOPE **MaxKey SSO** 的应用注册预检 ⇒ 本仓不实现 MaxKey SSO(`/Auth/SsoConfig` 恒 `enabled:false`,见 docs/known-limitations.md L2)
|
||
ssw.tds.service.MaxkeyAppRegistrarLogicSelfTest TDS boot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/service/MaxkeyAppRegistrarLogicSelfTest.java SELFTEST - - OUT-OF-SCOPE MaxKey 应用登记**编排判据**(人工优先 / 不抛异常 / 预检先于调用)⇒ 同上:本仓无 MaxKey 侧
|
||
ssw.tds.client.MaxkeyMgtClientLiveSelfTest TDS boot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/client/MaxkeyMgtClientLiveSelfTest.java SELFTEST - - OUT-OF-SCOPE **实机**打真 MaxKey(登录→建应用→授权→回读→退租;未配环境变量 ⇒ 退出码 4 = UNVERIFIED)⇒ 本仓无 MaxKey 侧,且该用例本质是**平台侧**实机联调
|
||
ssw.tds.crypto.CertSignerStrictSelfTest TDS boot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/crypto/CertSignerStrictSelfTest.java SELFTEST - - OUT-OF-SCOPE **CA 签发严格模式**(prod 档缺根证书必抛 / 合法 SM2 根必放行)⇒ 本仓不做 CA 签发(软 PKI 由上游 scard 安全平面承担)
|
||
ssw.tds.service.GuardAlertTypeSelfTest TDS boot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/service/GuardAlertTypeSelfTest.java SELFTEST - - OUT-OF-SCOPE **守门告警类型名长度不变式**(`GUARD_` + 原因 ≤ 列宽;实测曾 33 > varchar(30) ⇒ 告警静默丢库)⇒ 该告警表在 TDS 侧,本仓无对应表
|
||
ssw.common.util.IpWhitelistUtilTest COMMON boot/ssw-common/ssw-common-biz/src/test/java/ssw/common/util/IpWhitelistUtilTest.java JUNIT 13 - OUT-OF-SCOPE **IP 白名单**(CIDR / 全放 / 归一 / 畸形 fail-closed)⇒ 本仓**没有**该功能(入向鉴权只认内部令牌 + 会话令牌)
|
||
ssw.common.util.SswLLMClientTest COMMON boot/ssw-common/ssw-common-biz/src/test/java/ssw/common/util/SswLLMClientTest.java JUNIT 17 - OUT-OF-SCOPE **LLM 客户端**(内部代理 URL 解析 / OpenAI / Anthropic 后缀 / 业务错误 JSON)⇒ 本仓**没有** LLM 客户端
|