Skip to main content

Module bridge

Module bridge 

Source
Expand description

Android localhost bridge 线协议(IPC schema,归属 SSOT)。

execute 请求把一个已封存的 AuthorizedAction(在 aios-action 侧序列化为 canonical 字符串)连同 freshness window,以及覆盖 freshness window 与 action 字节的 HMAC-SHA256 认证标签发往设备侧 bridge;设备执行后回送结构化的 BridgeExecuteResponse。

设计要点:

  • 认证标签 (auth.hmac_sha256) 放在 envelope 上,而非塞进 action JSON 内部, 使每次授权与一个具体的 action 字节序列和有效期绑定 —— 捕获到的旧标签 无法重放到另一个 action 或过期窗口(替换静态 bearer token 的关键改进)。
  • action 以字符串形式承载(即 AuthorizedAction 序列化后的逐字节内容), HMAC 输入使用 length-prefixed action 字节和 freshness window。两侧都对 “收发的同一段字节“做 HMAC,规避跨语言 JSON key 排序导致的 canonicalization 漂移。

注意:本 crate 零内部依赖,这里只定义协议数据;HMAC 计算与 TCP 收发在 aios-action 侧实现。设备(Kotlin)侧的 responder 是 Tier 2 工作,须遵循本契约。

Structs§

BridgeAuth
envelope 级认证标签。
BridgeExecuteRequest
设备侧执行请求 envelope。
BridgeExecuteResponse
设备侧执行结果。summary/latency_us 仅在 status == Ok 时有意义。

Enums§

BridgeStatus
设备侧执行状态。

Constants§

BRIDGE_MESSAGE_TYPE_EXECUTE
execute 请求的 message_type 取值。与健康检查的 "ping" 区分。