OpenMax
免费试用

上线清单

上线前按四个检查点逐项核对:技术项和真实首次使用验收。

上线清单

这页是上线前的核对清单:先按四个检查点过一遍,再逐条核技术项,最后用真实账号做首次使用验收。

按四个检查点逐个过,前一个不过不要验后一个;每个检查点都要在 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 origin https://openmax.com),去掉 XFO DENY;iframe 内仍用到的 cookie SameSite=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 分钟,不循环跳转;重新启用后再打开恢复正常,账号和数据仍在

更多上线前的实践建议见发布与版本。