200881556367157盛大在线SDOA技术白皮书Version102009年5月目.doc

盛大在线 sdoa技术白皮书version 1.02009年5月目 录第1章前言2第2章概述2第3章产品介绍2一、产品说明2二、产品功能4第4章产品接入4一、接入流程41.c/s架构应用接入开发概述51.b/s架构应用接入开发概述8二、配置说明9三、联调测试10四、上线过程10第5章安全性评估10一、帐户安全10二、文件安全10第 10 页 共 12 页文档版权信息声明本文中出现的任何文字叙述、文档格式、插图、照片、方法、过程等内容，除另有特别注明，版权均属盛大在线所有，并受到有关产权及版权法保护。任何个人、机构未经盛大在线的书面授权许可，不得以任何方式复制或引用本文的任何片断。 名词解释术语解 释sdo盛大在线（snda online）的缩写。盛大通行证盛大通行证是指在盛大在线注册的用户帐号，该账号可登录任何一款接入盛大在线平台的游戏、网站和应用等，俗称“一号通”盛大点券盛大点券是盛大在线推出的用于在盛大在线所支持的应用中进行消费的虚拟点券，通过购买盛大娱乐卡可充值得到盛大点券。1元人民币相当于100点盛大点券。用户账户上的盛大点券可在盛大在线盛大在线所支持的应用中通行使用。盛大圈圈盛大圈圈是sdoa产品的客户端，通过相关接口（api）集成到sp的内容产品中，盛大圈圈基于widget相关技术标准可非常快捷方便的将各种功能、服务和外部应用发布到游戏中，为游戏提供丰富的功能、服务内容的扩展能力。（/web/index.asp）。点券划账点券划账是本产品支持的支付方式之一，指从盛大通行证账户中划出一部分点券转入合作应用的账户中，从而使得用户在该应用中能进行消费。道具扣费道具扣费是本产品支持的支付方式之一，指盛大通行证用户在合作伙伴提供的应用中进行购买道具等消费操作时，直接通过调用盛大的计费接口进行账户扣费，完成消费的功能。sdksdk，software development kit，软件开发工具包，本产品的sdk为一个压缩文件包，里面提供产品程序组件、接入示例、文档、演示程序等内容。spsp, service provider, 服务提供商。第1章 前言本文档用作sdoa产品的技术介绍资料，旨在让读者了解产品的框架、模块、复杂度、对接入应用的影响、成本、风险。预期读者是接入应用的项目经理、技术经理等需要了解产品技术框架、功能模块、影响、成本、风险、开发过程等方面情况的读者。第2章 概述sdoa全称snda openapi，是盛大在线利用自身多年积累的用户资源、运营技术、渠道优势和服务经验等，通过以开放技术架构整合形成的用户运营与服务产品，该产品针对所有互联网娱乐内容运营商（简称sp）提供开放、标准的接口，涵盖登录、支付、客户服务、用户推广、积分等多项功能和服务，为sp提供全方位的用户运营和服务解决方案。第3章 产品介绍一、 产品说明sdoa产品包含客户端、服务端、sdk等相关模块，以及相关产品文档与技术手册帮助sp进行使用。其中：l sdk分为for b/s和for c/s两种不同技术架构下的版本，并针对不同的开发语言和操作系统平台提供多个版本。sdk包含了sdoa产品客户端、服务端与sp内容产品集成所需要的接口（api）及必要的程序组件。l 产品客户端是带用户界面的一套程序组件，通过相关接口（api）与sp内容产品客户端进行集成，供终端用户使用，终端用户通过产品客户端可获得盛大在线提供的各种功能和服务，客户端相关接口都通过sdk提供给sp。（注：产品客户端在下文中我们会统称为盛大圈圈或圈圈）。l 产品服务端由盛大在线运维管理，通过相关接口与sp内容产品的客户端或服务端进行集成，从而提供为sp和终端用户相关功能与服务，相关接口都通过sdk提供给sp。产品结构示意图如下（图1）： 图1.产品结构图（绿颜色部分为sdoa产品模块）sdoa产品整合盛大在线的用户资源，通过相关服务产品和功能模块为用户提供盛大在线的服务，这些服务产品和功能都整合在盛大圈圈中，通过嵌入到sp的内容产品中来展现给终端用户。sdoa产品对终端用户的展现形式如（图2）所示： 图2.sdoa产品终端用户展示示意图二、 产品功能sdoa产品集成了盛大在线为用户提供的一系列服务，同时为sp提供了一套完善的接口与流程来帮助sp集成这些服务，使得这些服务能帮助sp更好的服务终端用户。sdoa产品为用户提供的相关服务包括：l 用户登录服务在盛大圈圈中提供了一个用户登陆界面，通过该界面用户可完成基于用户名/口令的基础认证服务和强化的动态口令认证服务（动态口令认证服务必须使用盛大密宝、盛大安全卡等安全产品），并通过盛大圈圈把登陆相关状态数据提交给sp产品来完成终端用户在sp产品的认证。l 用户充值服务盛大在线为用户提供了丰富的充值方式：实物卡充值、手机固话充值、手机卡充值、银行卡充值、短信充值、声讯充值、网吧直充等，通过充值用户可获得盛大点券，而用户可利用盛大点券在sp内容产品中进行消费或划账。充值服务通过widget形式在盛大圈圈中为用户提供。l 用户支付服务盛大在线用户可利用盛大点券在sp内容产品中进行消费，盛大在线为用户提供两种消费方式：道具计费方式和点券划账方式，前者用户直接可以利用盛大点券在sp内容产品中购买各种虚拟物品，后者用户可将盛大点券划账转换为sp内容产品中的虚拟点券，最终利用这些虚拟点券来购买各种虚拟物品。该项服务通过以api的方式提供给sp，sp可在sdk中获得这些api，sp将这些api集成到内容产品中后，终端用户即可利用该项服务在sp的内容产品中进行虚拟物品的支付消费。l 动态口令认证服务（或称密宝认证服务）为了加强对用户虚拟财产的保护，盛大在线推出了安全卡、密宝等多种动态口令安全认证产品（密宝、安全卡的介绍参见以下地址：/ekey/index.asp）。sp内容产品接入sdoa产品后，盛大在线用户登录该内容产品时就可以使用到这些强化的安全认证服务（用户必须购买这些安全认证产品之后才能使用该项服务）。l 统一帮助服务盛大在线基于圈圈提供统一的帮助服务，将业界领先的帮助服务提供给应用的用户，为您打开全方位服务通路、7x24小时千人呼叫坐席的专业客户服务。l 积分服务接入本产品的应用可以使用积分服务，为您用户的消耗提供多行业互通合作的积分体系支持，专享积分兑换、活动定制！l 分红服务接入本产品后，可以选择接入分红服务，这样将获得全国110万位推广员为您带来个性化的、面向身边用户的销售推广服务！第4章 产品接入一、 接入流程在完成了对本产品的了解后，您可以在sdoa官方网站()上根据您的应用是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架构应用接入。2) 用户登录图4.用户登录流程示意图上图中首先由应用客户端调用igw的showlogindialog函数启动登录界面（第1步），igw收到认证结果（第3步），传回给客户端，此时，客户端需要将认证结果传给应用服务端（第4步），应用服务端使用sdoa服务端组件获取验证结果（第5步）。接入开发需要完成： 从sdkserver目录下根据自己应用服务器环境类型选择对应版本服务端组件版本，加入自己的工程文件中。 客户端调用igw登录界面的ui。 使用组件中的 isdoauserinfoauthen 类获得用户登录结果 参见服务端组件使用说明参见isdoaapp:showlogindialog1. initialize函数初始化登录功能（包括下载配置文件sdoa4server.ini）。2. 如果使用异步方式在服务端获取验证结果，则需要实现一个回调函数userinfocallback ，然后在认证时使用asyncgetuserinfo 函数与盛大在线平台通信验证登录结果;3. 如果使用同步方式在服务端获取验证结果，则使用syncgetuserinfo函数获得登录结果。3) 充值功能接入用户帐户充值功能由圈圈提代，并且不需要接入应用参与。4) 支付功能应用可以选用道具计费或点券划帐方式提供支付功能。a) 道具计费图5.道具计费流程示意图如上图所示，应用商城收到用户消费请求后（第1步），将消费信息用sdoa服务端组件的功能生成订单扣费请求的url（第2步），服务端随后将此url发送到客户端交给igw发出支付请求（第3步），igw与盛大在线支付网关交互完成扣费（第4步），盛大在线支付网关再调用应用的服务器的发货接口，通知应用发货（第5步）。 初始化支付功能。 通过sdoa服务端组件生成扣费请求url。 将生成的url发送到客户端。 客户端通过igw发出请求。 应用服务端接收发货通知，发送道具参见isdoaorderhandler类的initialize函数1. getuniqueid生成订单号;2. 使用createorderinfo ，setorderinfovalue 将订单信息包装成orderinfo对象；3. 调用buildorderurl 函数，获得包含订单信息的一个计费请求url地址字符串参见isdoaapp:showpaymentdialog回调接口可以是一个web接口，也可以提供回调函数给本产品服务端组件调用，由服务端组件程序自动与盛大在线建立socket连接来接收消息b) 点券划帐图6.点券划帐流程示意图如上图所示，划帐从圈圈开始，用户在圈圈中完成整个划帐的交互过程（第1步），此后，盛大在线支付网关完成余额扣除（第2步），再通知合作应用的充值接口充值（第3步），用户充到应用中的余额，由应用管理，在用户消费时应用自行扣除相应余额即可。此流程应用只需实现一个接口： 划帐接收接口参见订单反馈接口 ，也可以提供回调函数给本产品服务端组件调用，由服务端组件程序自动与盛大在线建立socket连接来接收消息。至此，完成主要业务功能的开发。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) 充值功能接入参见充值功能接入。4) 支付功能接入参见支付功能。二、 配置说明使用本产品sdk时，需要做以下环境配置： 使用服务端组件服务器需有访问以下ip的权限：n 联调测试环境：4 9061端口n 正式运营环境：37 9061端口 调用服务端组件的程序启动后，会下载sdoaconfig.dat文件，其中“#本地侦听端口” 没有被其他应用程序占用，服务端组件将占用该端口