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§
- Bridge
Auth - envelope 级认证标签。
- Bridge
Execute Request - 设备侧执行请求 envelope。
- Bridge
Execute Response - 设备侧执行结果。
summary/latency_us仅在status == Ok时有意义。
Enums§
- Bridge
Status - 设备侧执行状态。
Constants§
- BRIDGE_
MESSAGE_ TYPE_ EXECUTE execute请求的message_type取值。与健康检查的"ping"区分。