经OneLogin REST API完成用户认证后,如何跳转直达Swift应用主页避免重复登录?
OneLogin 无交互SSO流程异常排查指南
问题现状
配置面向自有Swift应用的OneLogin SSO时,为了不向用户展示OneLogin登录页,选择走REST API认证流程:
- 第一步调用接口
https://api.us.onelogin.com/auth/oauth2/token获取access token - 第二步调用接口
https://你的租户子域.onelogin.com/api/1/login/auth获取会话token
目前已经可以正常拿到会话token,后续流程是重定向到自有视图页,通过JS发起带凭证的跨域请求完成会话写入,最终跳转SAML SSO地址后,仍然被强制回退到OneLogin登录页,无法实现无感知登录。
常见问题排查与修正方案
- 修正异步请求的时序逻辑
原代码在调用xhr.send()发起session_via_api_token接口请求后,没有等待接口执行完成、确认浏览器成功写入OneLogin域下的认证Cookie,就立刻执行了页面重定向。send()是异步非阻塞方法,实际执行中往往请求还没走到OneLogin服务端、没拿到Set-Cookie响应,跳转动作已经触发,此时OneLogin域下没有有效会话,自然会回退到登录页。
调整后的代码逻辑:把重定向动作绑定到XHR的成功回调里,等接口确认写入会话Cookie完成后再触发跳转,参考代码:function makeCors() { const xhr = new XMLHttpRequest(); xhr.withCredentials = true; const method = "POST"; const targetUrl = "https://你的租户子域.onelogin.com/session_via_api_token"; xhr.open(method, targetUrl, true); xhr.setRequestHeader("Content-Type", "application/json"); // 接口成功响应后再触发跳转 xhr.onload = function() { if (xhr.status >= 200 && xhr.status < 300) { window.location.href = 'https://你的租户子域.onelogin.com/trust/saml2/http-post/sso/3b47ccb6-7932-4a20-8f16-ed03f03841b7'; } else { console.error('会话写入失败', xhr.status); } }; const reqBody = {"session_token": "{{$session}}"}; xhr.send(JSON.stringify(reqBody)); }; - 校验跨域Cookie写入的有效性
带凭证的跨域请求要成功写入Cookie,需要满足两个配置要求:- OneLogin后台的CORS允许列表中,必须明确添加你自有应用实际部署的前端域名,不能使用通配符
*,否则浏览器会拦截跨域响应里的Set-Cookie头,即使接口返回200,Cookie也不会留存 - 确认浏览器没有拦截该站点的第三方Cookie权限,避免因Cookie拦截导致会话无法写入
- OneLogin后台的CORS允许列表中,必须明确添加你自有应用实际部署的前端域名,不能使用通配符
- 核对接口入参与返回逻辑
确认session_via_api_token接口的入参字段和要求完全匹配,部分租户版本的接口要求传递的字段为session而非session_token,如果字段不匹配,即使接口返回200状态码,也不会生成有效的认证会话,自然不会写入对应Cookie。 - 校验跳转链接的有效性
确认SSO跳转链接中的应用ID(即链接末尾的3b47ccb6-7932-4a20-8f16-ed03f03841b7)和你在OneLogin后台注册的自有Swift应用ID完全一致,误用其他测试应用ID会导致权限校验不通过,被强制回退到登录页。 - 统一全流程的租户子域名
检查全流程用到的所有接口地址(获取access token、获取会话token、写入会话、SSO跳转)对应的租户子域名完全匹配,不能出现部分地址用通用API域名、部分地址写错租户子域的情况,否则Cookie的作用域和跳转页面的域名不匹配,会导致会话识别失败。
内容的提问来源于stack exchange,提问作者Shenbaga Ganesh
相关产品推荐
相关产品推荐

