# 盛趣通行证网页内嵌-登录（SDO WEB SSO）
# 一、登录页面：ifarme模式（/sdo/iframe，含三方登录）
# 接入说明
正式环境地址（SDO官网版本）：
登录 - 盛趣游戏通行证：https://login.u.sdo.com/sdo/iframe/? (opens new window)
版本说明：
- 该版本是目前sdo网站官方使用接入的版本。
- 使用 iframe 引用时，注意PC页面宽度和高度必须大于 430*430。
- 接入方页面必须适配高清屏，游戏页面 html head 中 必须含有
<meta name="viewport" content="width=device-width,initial-scale=1">。 - 当有登录态（本地或者认证SSO）时，则不要在 html 里 iframe 中依然加载了这个页面。
# URL 入参说明
表格 1 登录页面接口说明
| 参数名 | 参数含义 | 可选 | 示例说明或备注 |
|---|---|---|---|
| returnURL | 登录成功后返回的应用地址，会返回ticket | 必填 | returnURL=https%3A%2F%2Fpre%2Ewww%2Esdo%2Ecom 注意，需要urlencode，尤其是返回的页面有自己的入参。 例如 返回的页面期望是：https://a.sdo.com?a=1&b=2 需要入参为： returnURL=https%3a%2f%2fa.sdo.com%3fa%3d1%26b%3d2 |
| appId | 应用编码，整数。用于统计各个应用的登录量的凭据 | 必填 | 示例：appId=201 此appId请通过数字编码申请流程进行申请，第三方应用请联系公司接口人。 |
| areaId | 应用区号，整数。无则填1，不可填0 | 必填 | 示例：areaId=1 |
| target | 登录成功后跳转形式：顶部跳转、内部跳转 | 可选 | 默认：target=top target=top表示顶部跳转（默认为top） target=iframe表示内部跳转 注意： 如果需要支持wegame、steam登录，请必须使用top模式，因为wegame、steam不支持内部跳转。 |
| reg_param | 登录框中注册自定义参数 | 可选 | 参数一定需要URLEncode编码 示例：注册返回地址 reg_param=serviceUrl%3Dhttp%3A%2F%2Fwww%2Esdo%2Ecom |
| thirdParty | 登陆框中是否需要显示第三方登录（并包含companyId） | 可选 | 枚举（竖线后面的数字是companyId），例如：wegame|310 注意： 1. companyId不是唯一值，具体联系 “认证产品负责人”或”认证服务端开发负责人”！ 2. companyId不能有错，影响wegame等第三方商户信息和登录结果！ 支持多个，英文逗号分隔， 例如： thirdParty=wegame|352,shunwang|312,feihuo|307 目前已知系列，见附录【入参 thirdParty 枚举】 注：建议咨询产品负责人2次确认！！！ |
| goClick | 打开页面直接模拟某个按钮点击，例如直接跳转第三方登录 | 默认为空 重要：必须结合thirdParty入参一起使用！！！ =wegame 直接前往wegame登录 =shunwang 直接前往shunwang登录 =feihuo 直接前往feihuo登录 =ixinyou直接前往ixinyou登录 | |
| showOneButton | 是否隐藏一键登录页签 | =0 不显示 其他（默认），显示 | |
| showQRcode | 是否隐藏二维码登录页签 | =0 不显示 其他（默认），显示 |
示例：
返回示例：
http://www.sdo.com/?ticket=ULS21-7fdcd285cf1c450f954f9a19e011546a
返回的ticket用【验证接口（服务端接口 HPS validate）】验证并获得用户信息。
【注意】：如果打开自动登录功能，第一次会返回附带autologin=1标记：
https://www.sdo.com/?autologin=1&ticket=ULS21-fd596f04f5bf4b54baa311d679dbce2b
# 枚举数据
# 入参 thirdParty 枚举：
- wegame|310 FF14
- wegame|352 龙之谷
- wegame|360 永恒之塔Aion
- wegame|320 热血传奇怀旧版
- wegame|373 传奇世界时长版
- wegame|382 传奇永恒
- wegame|386 星辰变
- wegame|387 传奇3
- wegame|388 龙之谷
- shunwang|312 龙之谷
- feihuo|307 龙之谷
- steam|389 星辰变online
- steamchina|389 龙之谷（当 appId=991002556 时，目前功能为跳转到一个蒸汽平台游戏官方说明页面）
- ixinyou|345 星辰变online（心游渠道）
# 案例
# 案例1：单个游戏APP ID使用登录页并显示三方button
适配场景：使用统一登录页面的系统，这个页面前端+后端系统都是这个游戏单独使用（单个appid）的，不和其他appid共享。
方式：仅仅使用 thirdParty 入参即可
线上样例：https://actff1.web.sdo.com/20190315Zhaodai/index.html#/zhao
# 案例2：结合入参 goClick 实现自定义三方button样例（单个系统多个游戏APPID）
适配场景：使用统一登录页面的系统，这个页面前端+后端系统都是多个游戏共享使用（多个appid）的，多个appid共存。
方式：使用 thirdParty + goClick 入参
线上样例：qu.sdo.com，vip.sdo.com
案例截图 01：
案例截图 01：
# 二、注销页面：如需增加 cas sso 回调 URL，请按照如下实现
页面需要接入方实现（cas logout 回调空白页面制作）
要求：
- 只需要实现服务端 session 清空
- 不要返回任何 html 和 js 信息
非常重要！
PS：不要返回任何信息，仅仅清空 session
参考样例： https://www.sdo.com/home/logout