fix: guard global ABSDK session state

2026-08-23 07:05:43 +08:00
parent c2fb63e241
commit 0e9b7dfd4b
7 changed files with 80 additions and 11 deletions
@@ -102,9 +102,11 @@ Fake 只用于开发和测试，不能作为真实 ABox 或真实硬件验收证
 - 不提供设备目录；
 - 不调用未确认的 `setHostInfo`；
 - logout 只清除 Bridge 本地会话，因为 JAR 没有公开 logout 或 Token setter；
+- 生产工厂始终返回进程内同一个 Bridge，使互斥锁和本地会话与厂商单例保持一致；
+- 真实工厂标记为 `@CleartextAbsdkTransport`，调用方必须显式 opt-in 承认厂商 JAR 的硬编码 HTTP 风险；
 - 当前直接引用归档 Sample 目录中的唯一一份 JAR，不复制厂商二进制。

-Bridge 本轮尚未加入 `android/app` 依赖，App debug 仍绑定 Fake。提供方选择、安全凭据和真实 Bridge 绑定由后续 `feat/provider-login` 完成。协议证据与限制记录在 `docs/protocol/absdk-0630.md`。
+Bridge 本轮尚未加入 `android/app` 依赖，App debug 仍绑定 Fake。提供方选择、安全凭据和真实 Bridge 绑定由后续 `feat/provider-login` 完成；在获批的传输控制方案明确前，不得在 App 中启用真实 Bridge。协议证据与限制记录在 `docs/protocol/absdk-0630.md`。

 ## 9. 后续边界

@@ -108,6 +108,8 @@ commons-logging-1.1.3.jar

 JAR 内含宽松的 TLS 信任实现。正式产品不得把这一历史传输行为扩展为 App 其他网络请求的安全策略，也不得记录密码、Token、API Key 或敏感红外载荷。

+真实 Bridge 工厂使用 `@CleartextAbsdkTransport` 作为编译期 opt-in 门禁，并且当前没有接入 Android App。该标记只防止误接入，不会为链路提供加密。生产集成前必须确定并批准 HTTPS、受控加密代理或其他能够提供机密性与完整性的传输控制；在此之前不得启用真实 ABox 入口。
+
 ## 6. `setHostInfo` 的已确认行为

 `setHostInfo(url, hotelName, roomNo, apikey)` 向以下端点发送初始化请求：