From b418621314f5b79dff8e5f1b261dbce08897f993 Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 24 Oct 2026 12:13:07 +0800 Subject: [PATCH] =?UTF-8?q?docs(spec):=20=E8=A1=A5=E8=81=94=E8=B0=83?= =?UTF-8?q?=E7=8E=AF=E5=A2=83=E5=AE=9E=E6=B5=8B=E2=80=94=E2=80=94=E5=B9=B3?= =?UTF-8?q?=E5=8F=B0=E5=BF=85=E5=A1=AB=E5=8D=A0=E4=BD=8D=E7=AC=A6=E6=B8=85?= =?UTF-8?q?=E5=8D=95=E4=B8=8E=E5=9B=9B=E7=B1=BB=E9=97=B8=E9=97=A8=E8=A1=8C?= =?UTF-8?q?=E4=B8=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - §16.3:补平台 yml 无默认值的必填占位符(CONFIG_API/FRONTDOMAIN、 SSW_BOXDEPLOYER_*)与联调取值;DB/Redis 账号密码走 yml 默认值,不落命令行 - §16.3:补 2026-10-24 实测的平台闸门四象限(无头→code600 / 协议不兼容→HTTP401 / 白名单内部端点→仅需 X-Internal-Token / 非白名单→仍需登录态) - §16.3:明确连接器出向须区分「白名单内部端点」与「普通端点」 Co-Authored-By: Claude Code --- .../2026-10-24-tdc-rs-align-v2-design.md | 25 +++++++++++++++++-- 1 file changed, 23 insertions(+), 2 deletions(-) diff --git a/docs/superpowers/specs/2026-10-24-tdc-rs-align-v2-design.md b/docs/superpowers/specs/2026-10-24-tdc-rs-align-v2-design.md index eccb8cc..f4b0bf0 100644 --- a/docs/superpowers/specs/2026-10-24-tdc-rs-align-v2-design.md +++ b/docs/superpowers/specs/2026-10-24-tdc-rs-align-v2-design.md @@ -1028,11 +1028,32 @@ P5 的策略闸门依赖 P3;P6 依赖全部后端阶段。 | TDS 库 | `tds2`(新建于 `jnpf-postgres`,135 个迁移零失败,**45 张表**) | | TDS 端口 | `30041`(避开连接器 `30000` 与旧版 TDS `30040`) | | fat jar | `/tmp/sswtds-probe/boot/ssw-tds-admin/target/ssw-tds-admin-7.0.0-RELEASE.jar`(386 MB) | -| 关键环境变量 | `TDS_DB=tds2` · `SERVER_PORT=30041` · `DB_HOST=127.0.0.1` · `DB_PORT=15432` · `REDIS_HOST=127.0.0.1` · `REDIS_PORT=16379` · `CONFIG_APIDOMAIN` · `CONFIG_FRONTDOMAIN` · `SSW_INTERNAL_TOKEN` | +| 关键环境变量 | `TDS_DB=tds2` · `SERVER_PORT=30041` · `DB_HOST=127.0.0.1` · `DB_PORT=15432` · `REDIS_HOST=127.0.0.1` · `REDIS_PORT=16379` · `CONFIG_APIDOMAIN` · `CONFIG_FRONTDOMAIN` | | 依赖 | `jnpf-postgres`(15432)· `jnpf-redis`(16379) | 连接器侧联调变量:`SSW_TDS_BASE_URL=http://127.0.0.1:30041`(+ 同名 `SSW_INTERNAL_TOKEN`)。 -注意平台 `CONFIG_APIDOMAIN` **无默认值**,缺省会启动失败——联调时必须显式给。 + +⚠️ 平台 yml 里**无默认值的必填占位符**(缺任一个 ⇒ **启动失败**,与「连不上」无关): + +| 变量 | 联调时取值 | 说明 | +|---|---|---| +| `CONFIG_APIDOMAIN` | `http://127.0.0.1:30041` | 无默认,缺则起不来 | +| `CONFIG_FRONTDOMAIN` | `http://127.0.0.1:30041` | 同上 | +| `SSW_BOXDEPLOYER_PLATFORM_BASE` | `http://127.0.0.1:30041` | 盒 TDC 回连基址(本机联调填平台自身即可) | +| `SSW_BOXDEPLOYER_REDIS_HOST` | `127.0.0.1` | 盒 TDC 会话/租户引导 Redis | +| `SSW_BOXDEPLOYER_J7_INITIAL_PASSWORD` | 任意占位 | 盒自有 j7 预置口令;**平台侧运行期不消费**,联调填哑值即可 | +| `SSW_INTERNAL_TOKEN` | 两端必须一致 | 缺省 `ssw-internal-token-e2e`(公开弱口令,见 §5.2 护栏) | + +**2026-10-24 实测的平台闸门行为**(`curl --noproxy '*'`,TDS :30041): + +| 请求 | 实测响应 | 结论 | +|---|---|---| +| 无任何头,打 `GET /api/ssw/tds/Connector/All` | HTTP 200 + `{code:600,"msg":"登录过期,请重新登录"}` | 非白名单路径 ⇒ **HTTP 200 + code 600**,不是 401 | +| `X-Protocol-Version: 9.0` + 合法 token | **HTTP 401** + `{code:401,"msg":"跨端协议版本不兼容(对端 9.0,本端 1.0),请升级对端"}` | 协议闸门 fail-closed,**在白名单 stop() 之前** | +| `X-Internal-Token` + `X-Protocol-Version: 1.0`,打**白名单**内部端点(`SpaceMember/Internal/RoleOf`、`Connector/Internal/EnvReport`、`Contract/Internal/Negotiations`) | HTTP 200 + 业务错(`"subjectId/spaceId 必填"` / `"connectorId 必填"`) | 白名单内部端点**只认 `X-Internal-Token` 即可过网关**(不校验 `SA-SAME-TOKEN`) | +| `X-Internal-Token` + `X-Protocol-Version: 1.0`,打**非白名单**端点(`Connector/All`) | HTTP 200 + `{code:600}` | 🔴 **光有 `X-Internal-Token` 不够**:平台内部请求分支校验的是 `SA-SAME-TOKEN`,非白名单路径另需登录态 | + +⇒ 连接器出向客户端**必须区分「白名单内部端点」与「普通端点」**:前者只带内部令牌,后者还需 `SA-SAME-TOKEN` 或用户会话。 ---