上线清单
上线前按四个检查点逐项核对:技术项和真实首次使用验收。
上线清单
这页是上线前的核对清单:先按四个检查点过一遍,再逐条核技术项,最后用真实账号做首次使用验收。
按四个检查点逐个过,前一个不过不要验后一个;每个检查点都要在 embed 和新标签两种打开方式下各过一遍(open 只选了一种的除外)。
| 检查点 | 怎么算过 |
|---|---|
| ① 已发布 | 审批通过、已安装到组织且 active;目标角色在应用页看得到入口;外壳打开的地址是预期的 {url}{子路径}?theme=…&openmax_lang=…(见地址组合示例) |
| ② 授权正常 | 新标签:没有会话时跳到授权端点,回到 redirect_uri 带 code / state / iss;没有停在授权页终态(APP_AUTHORIZE_*)。embed:向宿主要到 code(没有 openmax:auth:error),iframe 没有发生跳转(见「嵌入时登录」) |
| ③ 会话已建立 | 换到 token、id_token 验过、org_id 放行、找到 / 按策略建好绑定、原生会话建好且有效期 ≤ token 过期 |
| ④ 业务页可用 | 下面「真实首次使用验收」的用例全部通过 |
嵌入时登录(requestAuthCode)和路由同步(
openmax:location)已上线。不要依赖宿主提示:没接 requestAuthCode 的应用,在 iPhone / iPad / 桌面 Safari 上直接白屏。
技术项
- ☐ manifest 通过校验(
version是X.Y.Z,且比已有版本大);有path: "/"入口;scope 只要用得到的 - ☐ Secret 只在后端配置,不进前端、不进仓库、不进日志(code、verifier、token 同样不打日志)
- ☐ 授权请求带
state+nonce+ PKCE S256;redirect_uri与 manifest 逐字节一致 - ☐ 回调:流程单次使用;核
iss、state;带code_verifier换 token;验 id_token(签名、iss、aud、exp、nonce) - ☐ returnTo 只从服务端流程取,且只接受单个
/开头的路径 - ☐
login_required/access_denied/ 401 / 403 有终态,不会自动循环跳转 - ☐ embed:CSP
frame-ancestors(填 Workspace originhttps://openmax.com),去掉 XFO DENY;iframe 内仍用到的 cookieSameSite=None; Secure; Partitioned - ☐ embed 登录按「嵌入时登录」:iframe 内不跳转,向宿主要授权码;消息只发 Workspace origin(不用
"*"),回信核event.source/event.origin/requestId;redirectUri与 manifest 一字不差,后端用同一个redirect_uri+code_verifier换 token - ☐ 只有
not_embedded回落跳转登录;host_timeout/timeout/busy总共最多 3 次;其他错误显示说明 +「新标签打开」 - ☐ embed 会话不靠第三方 cookie:放内存(或
sessionStorage),请求头带;带不了头的子资源用短期票据 - ☐ 有
offline_access时每次刷新保存新的 refresh_token - ☐ 数据按组织隔离;收到 401 当授权失效处理
- ☐ 回调核
org_id;绑定只按(issuer, org_id, member_id),不按邮箱自动关联 - ☐ 会话有效期 ≤ token 过期;过期会话被拦截并重新授权(复核身份不算续期)
- ☐ 不用
theme/openmax_lang做任何鉴权或租户判断;路由能容忍这两个参数 - ☐ 接入策略表(见「已有系统接入」)已填写并经组织管理员确认
- ☐ 接了路由同步时:embed 下在深层页面刷新浏览器,仍停在原页面;回调 / 登录中转 / 一次性页面不上报;消息只发 Workspace origin,不用
"*"
真实首次使用验收
用真实账号在目标环境走一遍,不要只用开发者自己的管理员账号。
| 用例 | 期望 |
|---|---|
| 全新成员第一次打开(应用里没有他的账号) | 策略 A:自动建出一个账号,角色 = 默认角色,只加入约定的默认项目,落到首次落地页;策略 B:看到「请联系管理员开通」,没有建出账号 |
| 已有成员再次打开(会话已过期) | 无感重新授权,回到同一个账号(没有建出第二个账号),原来的项目和数据都在 |
| iPhone(Safari 或任一浏览器)、iPad、桌面 Safari 上 embed 打开 | 不白屏 / 不黑屏,无交互进入应用;刷新 Workspace 页面后仍无感登录;新标签打开同样可用 |
| 第二个标签页 / embed 与新标签各开一次 | 两边都能用;不会建出重复账号;embed 与新标签各自的会话互不影响(Partitioned cookie,见打开方式与地址) |
| 默认项目正确 | 新成员只看到约定的项目,看不到无关的历史项目 |
| 核心页面没有 403 | 用默认角色逐个打开核心业务页(列表、详情、新建 / 编辑常用对象),没有 403、空白页或无限加载 |
| 没有意外建项目 | 首次进入没有触发新手向导自动建示例项目 / 工作区;项目总数前后一致 |
| 在应用里退出登录 | 停在「已退出」页(?signed_out=1),不自动重新登录;点「重新登录」可以回来 |
| Workspace 退出登录后 | 应用会话最多活到 token 过期;之后重新授权时显示「请先登录 Workspace」,不循环跳转 |
| 授权被撤销(停用安装 / 移出组织 / 应用内停用账号) | 下一次调 Workspace 接口(401)或会话过期后重新授权(access_denied)时显示无权限,最迟不超过 15 分钟,不循环跳转;重新启用后再打开恢复正常,账号和数据仍在 |
更多上线前的实践建议见发布与版本。
