在客户自有登录体系验密成功后调用,换取一次性免登地址 loginUrl,交给浏览器顶层跳转(新窗口或当前窗口)即可免登进入控制台。
票据一次性有效且默认 60 秒过期,请在用户点击进入时实时换票,不要缓存或复用 loginUrl;过期或已被使用的地址访问时会提示「登录链接已失效」,此时引导用户回到原系统重新点击入口即可。
externalUserId 必须是客户体系内稳定不可变的用户唯一标识(禁止手机号、邮箱等可变信息),且在租户内全局唯一;首次出现的标识平台会自动开户并创建独立身份主体,无需预先同步用户名单。
响应中的 principalId 建议留存:作为 OpenAPI 调用的 X-Principal-Id 传入,即可与用户页面操作共享同一主体、同一份会话与记忆。
注意:受「一个用户仅归属一个应用空间」的约束,若该 externalUserId 已归属本租户下的其他应用,接口返回 409 错误。