200881556367157 盛大在线 SDOA 技术白皮书 Version 10 2009年5月 目

盛大在线 SDOA 技术 白皮书 Version 1.0 2009 年 5 月 第 I 页 共 12 页 目 录 第 1 章 前言 . 2 第 2 章 概述 . 2 第 3 章 产品介绍 . 2 一、 产品说明 . 2 二、 产品功能 . 4 第 4 章 产品接入 . 4 一、 接入流程 . 4 1. C/S 架构应用接入开发概述 . 5 1. B/S 架构应用接入开发概述 . 9 二、 配置说明 . 10 三、 联调测试 . 10 四、 上线过程 . 10 第 5 章 安全性评估 . 10 一、 帐户安全 . 10 二、 文件安全 . 10 第 I 页 共 12 页 文档版权信息声明 名词解释 术语 解 释 SDO 盛大在线（ SNDA Online）的缩写。 盛大通行证 盛大通行证是指 在盛大在线注册的 用户帐号， 该账号可 登录任何一款 接入盛大在线平台的游戏、网站和应用等 ，俗称“一号通” 盛大点券 盛大点券是盛大在线推出的用于 在盛大在线所支持的应用中进行消费的虚拟点券 ， 通过购买盛大娱乐卡可充值得到盛大点券。 1 元人民币相当于 100点盛大点券。 用户账户上的盛大点券 可在盛大在线盛大在线所支持的应用中通行使用 。 盛大圈圈 盛大圈圈是 SDOA 产品的客户端，通过相关接口（ API）集成到 SP 的内容产品中，盛大圈圈基于 Widget相关技术标准可非常快捷方便的将各种功能、服务和外部应用发布到游戏中，为游戏提供丰富的功能、服务 内容的扩展能力。 （ /web/index.asp） 。 点券划账 点券划账是本产品支持的支付方式之一，指从盛大通行证账户中划 出一部分点券转入合作应用的账户中，从而 使得 用户在该应用中 能进行 消费。 道具扣费 道具扣费是本产品支持的支付方式之一，指盛大通行证用户在合作伙伴提供的应用中进行购买道具等消费操作时，直接通过调用盛大的计费接口进行账户扣费，完成消费的功能。 SDK SDK， Software Development Kit，软件开发工具包，本产品的 SDK 为一个压缩文件包，里面提供产品程序组件 、 接入示例 、 文档 、 演示程序等内容。 SP SP, Service provider, 服务提供商。 本文中出现的任何文字叙述、文档格式、插图、照片、方法、过程等内容，除另有特别注明，版权均属盛 大在线所有，并受到有关产权及版权法保护。任何个人、机构未经盛大在线的书面授权许可，不得以任何方式复制或引用本文的任何片断。 第 2 页 共 12 页 第 1章 前言 本文档用作 SDOA 产品 的 技术 介绍资料 ，旨在让读者了解 产品 的框架、模块 、 复杂度 、对 接入 应用的影响 、 成本 、 风险 。 预期读者是 接入应用的 项目经理、技术经理 等需要了解产品技术框架 、 功能模块 、 影响 、成本 、 风险 、 开发过程等方面情况的读者 。 第 2章 概述 SDOA 全称 SNDA OpenAPI， 是盛大在线利用自身多年积累的 用户资源、 运营技术、渠道优势和服务经验 等 ， 通过以开放技术架构整合形成的用户运营 与 服务产品，该产品 针对 所有互联网娱乐 内容运营 商 （简称 SP） 提供 开放 、 标准的接口 ， 涵盖 登录、支付 、客户服务、用户推广、积分等多项功能和服务 ， 为 SP 提供全方位的用 户运营 和服务 解决方案 。 第 3章 产品 介绍 一、 产品说明 SDOA 产品包含客户端、服务端、 SDK 等相关模块， 以及相关产品文档与技术手册 帮助SP 进行使用 。其中 ： SDK 分为 For B/S 和 For C/S 两种不同技术架构下的版本，并针对不同的开发语言和操作系统平台提供多个版本。 SDk 包含了 SDOA 产品 客户端、服务端 与 SP 内容产品集成所需要的接口 （ API） 及必要的程序组件。 产品客户端 是带 用户 界面的一套程序组件， 通过相关接口 （ API）与 SP 内容产品客户端 进行集成 ，供终端用户使用，终端用户通过 产品 客户端可获得盛大在线提供的各种功 能和服务 ，客户端相关接口都通过 SDK 提供给 SP。 （ 注：产品客户端在下文中我们会统称为盛大圈圈或圈圈 ）。 产品服务端由盛大在线运维管理，通过相关接口与 SP 内容产品的客户端或服务端进行 集成 ， 从而提供为 SP 和终端用户 相关功能与 服务 ，相关接口都通过 SDK 提供给 SP。 产品 结构 示意 图如下（图 1）： 第 3 页 共 12 页 图 1.产品结构 图 （绿颜色部分为 SDOA 产品模块） SDOA 产品整合盛大在线的用户资源，通过相关服务产品和功能模块为用户提供盛大在线的服务，这些服务产品和功能都整合在盛大圈圈中，通过嵌入到 SP 的内容产品中来展现给终端 用户。 SDOA 产品对终端用户的展现形式如（图 2）所示： 图 2.SDOA 产品终端用户 展示 示意图 第 4 页 共 12 页 二、 产品 功能 SDOA 产品 集成了盛大在线为用户提供的一系列服务，同时为 SP 提供了一套完善的接口与流程来帮助 SP 集成这些服务，使得这些服务能帮助 SP 更好的服务终端用户。 SDOA 产品 为用户提供的 相关服务包括： 用户登录 服务 在盛大圈圈中提供了一个用户登陆界面，通过该界面用户可完成 基于用户名 /口令的基础 认证服务 和强化的 动态口令认证服务（动态口令认证服务必须使用 盛大密宝 、 盛大 安全卡 等安全产品），并通过盛大圈圈把登陆相关 状态数据提交给 SP产品来完成终端用户在 SP 产品的认证。 用户 充值服务 盛大在线 为用户 提供 了 丰富的充值方式：实物卡充值、手机固话充值、手机卡充值、银行卡充值、短信充值、声讯充值、网吧直充等 ， 通过充值用户可获得盛大点券，而用户可利用盛大点券在 SP 内容产品中进行消费或划账。充值服务通过widget 形式在 盛大圈圈 中为用户 提供 。 用户 支付 服务 盛大在线用户可利用盛大点券在 SP 内容产品中进行消费，盛大在线为用户提供两种消费方式：道具计费方式和点券划账方式，前者用户直接可以利用盛大点券在 SP 内容产品中购买各种虚拟物品，后 者用户可将盛大点券划账转换为 SP 内容产品中的虚拟点券，最终利用这些虚拟点券来购买各种虚拟物品。 该项服务通过以 API 的方式提供给 SP， SP 可在 SDK 中获得这些 API， SP 将这些 API 集成到内容产品中后，终端用户即可利用该项服务在 SP 的内容产品中进行虚拟物品的支付消费。 动态口令认证服务 （或称密宝认证服务） 为了加强对用户虚拟财产的保护，盛大 在线 推出了安全卡 、 密宝等 多种动态口令 安全认证产品 （密宝、安全卡的介绍参见以下地址：/ekey/index.asp）。 SP 内容产品接入 SDOA 产品后 ， 盛大在线 用户登录 该内容产品 时 就 可以使用到这些 强化的 安全认证 服务 （用户必须购买这些安全认证产品之后才能使用该项服务） 。 统一帮助服务 盛大在线基于圈圈提供统一的帮助服务，将业界领先的帮助服务提供给应用的用户 ，为 您打开全方位服务通路、 7x24 小时千人呼叫坐席的专业客户服务 。 积分服务 接入本产品的应用可以使用积分服务， 为您用户的消耗提供多行业互通合作的积分体系支持，专享积分兑换、活动定制！ 分红 服务 接入本产品后，可以选择接入分红服务，这样将获得 全国 110 万位推广员为您带来个性化的、面向身边用户的销售推广服务！ 第 4章 产品 接入 一、 接入流程 在完成 了 对本 产品的了解 后 ， 您可以 在 SDOA 官方网站 ()上 根据您的 第 5 页 共 12 页 应用是 B/S 架构 还是 C/S 架构 下载 相应的 SDK，开始接入开发。 下载到的 SDK 包含接入开发所需的程序组件，演示程序，示例代码，测试小工具等内容。您将在 Client 目录获得 盛大 圈圈 相关的客户端接入所需的内容，在 Server 目录获得服务端需要接入的组件的内容。 如果需要联调、测试，则您需要在官方网站上注册 产品，登记了服务器地址，获得产品编号 ，整体来说，技术接入过程如下图所示： 图 3.SDOA 产品接入 流程示意图 下面分别对 C/S 架构 的内容产品 和 B/S 架构 的内容产品 接入开发过程进行简单的描述 ： 1. C/S 架构应用接入开发概述 1) 盛大圈圈接入 简单来说， 盛大圈圈 接入的过程如下： 加载并初始化 IGW 组件 传递用户角色、区组信息 显示 IGW 界面 调用应用接口 参见 LoadIGW(D3D9)、 LoadIGW(D3D8)、LoadIGW(DDraw)、 LoadIGW(OpenGL)。 参见 SetRoleInfo、 ModifyAppInfo 参见 ShowIGW(D3D9)、 ShowIGW(D3D8)、ShowIGW(Ddraw)、 ShowIGW(OpenGL)。 如打开用户登录界面，参见ShowLoginDialog(D3D9)、ShowLoginDialog(D3D8)、ShowLoginDialog(Ddraw)、ShowLoginDialog(OpenGL)， 或查询余额，参见 Balance(D3D9)。 注：以上环节完整代码均在 SDKClientSample 目录中。 至此，轻松完成了基于 IGW 的圈圈接入 , 更多 IGW 接口，如设置边栏位置，打开某 个页面等功能，参见 ISDOAApp，完整的 IGW 接口参见 C/S 架构应用接入 。 第 6 页 共 12 页 2) 用户登录 图 4.用户登录流程示意图 上图中首先 由应用客户端 调用 IGW 的 ShowLoginDialog 函数启动登录界面 （第 1 步） ， IGW收到认证结果 （第 3 步） ，传回给客户端，此时，客户端需要将 认证结果传给应用服务端 （第4 步） ，应用服务端使用 SDOA 服务端组件获取验证结果 （第 5 步） 。 接入开发需要完成： 从 SDKServer 目录下根据自己应用服务器环境类型选择对应版本服务端组件版本，加入自己的工程文件中。 客户端调用 IGW 登录界面的 UI。 使用组件中的 ISDOAUserInfoAuthen 类获得用户登录结果 参见 服务端组件使用说明 参见 ISDOAApp:ShowLoginDialog 1. Initialize 函数初始化登录功能（包括下载配置文件 sdoa4server.ini）。 2. 如果使用异步方式 在服务端获取验证结果 ，则需要实现一个回调函数UserInfoCallback ，然后在认证时使用AsyncGetUserInfo 函数与盛大在线平 台通信验证登录结果 ; 3. 如果使用同步方式 在服务端获取验证结果 ，则使用 SyncGetUserInfo 函数获得登录结果。 第 7 页 共 12 页 3) 充值功能接入 用户帐户充值功能由圈圈提代，并且不需要接入应用参与。 4) 支付功能 应用可以选用道具计费或点券划帐方式提供支付功能。 a) 道具计费 图 5.道具计费流程示意图 如上图所示，应用商城收到用户消 费请求后 （第 1 步） ，将消费信息用 SDOA 服务端组件的功能生成订单 扣费 请求 的 URL（第 2 步） ，服务端随后将此 URL 发送到客户端 交 给 IGW发出支付请求 （第 3 步） ， IGW 与盛大在线支付网关交互完成扣费 （第 4 步） ，盛大在线支付网关再调用应用的服务器的发货接口，通知应用发货 （第 5 步） 。 初始化支付功能。 通过 SDOA 服务端组件生成扣费请求URL。 参见 ISDOAOrderHandler 类的 Initialize 函数 1. GetUniqueId 生成订单号 ; 2. 使用 CreateOrderInfo ，SetOrderInfoValue 将订单信息包装成ORDERINFO 对象； 3. 调用 BuildOrderUrl 函数，获得包含订单信息的一个计费请求 URL 地址字符串 第 8 页 共 12 页 将生成的 URL 发送到客户端 。 客户端通过 IGW 发出请求。 应用服务端接收发货通知，发送道具 参见 ISDOAApp:ShowPaymentDialog 回调接口可以是一个 Web 接口 ，也可以提供回调函数 给本产品服务端组件调用，由服务端组件程序自动与盛大在线建立 Socket连接来接收消息 b) 点券划帐 图 6.点券划帐流程示意图 如上图所示，划帐从圈圈开始，用户在圈圈中完成整个划 帐的交互过程 （第 1 步） ，此后，盛大在线支付网关完成余额扣除 （第 2 步） ，再通知合作应用的充值接口充值 （第 3 步） ，用户充到应用中的余额，由应用管理，在用户消费时应用自行扣除相应余额即可。 此流程应用只需实现一个接口 ： 划帐接收接口 参见 订单反馈接口 ，也可以提供 回调函数给本产品服务端组件调用，由服务端组件程序自动与盛大在线建立 Socket 连接来接收消息。 至此，完成主要业务功能的开发。 第 9 页 共 12 页 1. B/S 架构应用接入开发概述 B/S（ Browser/Server） 架 构即浏览器和服务器架构，由浏览器作为客户端与用户交互，并与远端的服务器通信。 Web Game 和一般的网站都属于 B/S 架构。 B/S 架构 应用接入 开发 分为三大步骤，分别是盛大圈圈接入、 CAS 登录 、支付功能接入。 1) 盛大 圈圈（ IBW）接入 盛大圈圈在 B/S 架构中基于 IBW 技术实现， IBW 接入非常简单，只需在页面中加入几行脚本即可，参见 IBW 接入 。 接入后，圈圈在页面中显示效果类似 下 图： 图 2.IBW 接入效果示意图 圈圈接入后，应用需要将一些重要数据通知给 IBW，参见 设置 属性 。 2) 用户登录功能接入 BS 架构应用需基于 CAS（ Central Authentication Service,是盛大通行证在 Web 应用中的统一认证系统）系统完成盛大通行证登录功能的接入。 此步骤参见 CAS 登录 。 用户登录分为 CAS 认证过程，和 Token 验证两个步骤，就是说页面先跳转到 CAS 的登录界面（如果使用 IBW 的 ibw_public.openLoginWindow()函数打开登录界面，则开始不用跳转用户使用的页面 ） 完成用户认证，然后 CAS 会将页面跳转回应用界面，并在 URL 参数中加上 Token，然后应用服务端用此 Token 和 CAS 服务器通信取得用户登录结果。 用户登录成功后，需要设置记录用户的一些属性，参见 设置 属性 。 3) 充值功能接入 参见 充值功能接入 。 第 10 页 共 12 页 4) 支付功能接入 参见 支付功能 。 二、 配置说明 使用本产品 SDK 时，需要做以下环境配置： 使用服务端组件服务器需有访问以下 ip 的权限： 联调测试环境： 4 9061 端口 正式运营环境： 37 9061 端口 调用 服务端组件的程序启动后，会下载 sdoaconfig.dat 文件，其中 “