Appearance
@keymaster/connect / ConnectLaunchParams
Interface: ConnectLaunchParams
connect.launch 请求参数。
设计缘由(施工单 2026-06-29 001 硬切换):
connect.launch是appViewmode 下 client app 的唯一首登 入口;消费 launcher 交给 client app 的launchToken。- 不传 aud / iat / exp —— login 时机由 launcher 一次性 bootstrap 阶段 决定;launch 自身只验 token + 走 sessionRecord 落库;不重新选 key, 不重新认证。
- 失败时按 fail-closed:launchToken 缺失 / 已消费 / 当前 Session Window 不在
appViewmode / caller origin 与 bootstrap 期记录不一致 → 拒掉; 不允许 fallback 到connect.login。 - 成功结果形状与
connect.login对齐,便于 caller 走同一套"持久化 sessionId + 后续 connect.resume / cipher.*"路径。
Properties overview
| Property | Type | Required | Description |
|---|---|---|---|
launchToken | string | Yes | 由 launcher 写入 client app 启动 URL 的 launchToken。 |
appIdentity | AppIdentityProofV1 | Yes | 与 launcher 预建 session 绑定的完整签名 proof。 |
Properties
launchToken
launchToken:
string
由 launcher 写入 client app 启动 URL 的 launchToken。一次性消费。
appIdentity
appIdentity:
AppIdentityProofV1
与 launcher 预建 session 绑定的完整签名 proof。