中国移动VGOP综合网关系统接口规范.doc
《中国移动VGOP综合网关系统接口规范.doc》由会员分享,可在线阅读,更多相关《中国移动VGOP综合网关系统接口规范.doc(26页珍藏版)》请在三一办公上搜索。
1、中国移动通信企业标准QB-D-114-2009中国移动VGOP-综合网关系统接口规范Technical Specification for Interfaces of VGOP-Service Integrated Gateway Interface版本号:1.0.02009-9-21实施2009-9-21发布中国移动通信集团公司 发布目录前 言III1范围12规范性引用文件13术语、定义和缩略语13.1.术语、定义13.2.缩略语24系统结构25接入认证接口(SIG-Rc)45.1.接口描述45.2.接口定义45.2.1.accessAuthLogin定义45.2.2.accessAuthL
2、ogout定义56业务调用接口(SIG-Sg)56.1.接口功能56.2.接口定义56.2.1.接口消息结构66.2.2.请求消息头定义66.2.3.应答消息头定义86.2.4.消息体86.3.接口消息流程和处理86.4.接口可扩展性87与业务能力的接口(SIG-Sa)97.1.接口功能97.2.接口定义98与VGOP的鉴权接口(SIG-Ra)99数据发布接口(SIG-Ms)109.1.接口功能109.2.接口定义109.2.1.业务平台信息同步(platformInfoSync)109.2.2.业务信息同步(serviceInfoSync)119.2.3.业务能力信息同步(enablerIn
3、foSync)119.2.4.路由表数据同步(routingInfoSync)119.2.5.业务能力调用授权关系黑白名单发布(serviceBWListSync)1210与网管的接口(SIG-Mn)1211扩展路由查询接口(SIG-Mr)1211.1.接口功能1211.2.接口定义1311.3.接口定义1311.3.1.WebService格式接口消息定义1311.3.2.UDP格式接口消息定义1412编制历史14附录A 消息返回码定义14附录B ENUM DNS服务器接口消息附录161.ENUM DNS消息体说明162.DNS消息头Header173.请求消息Question174.响应消
4、息Answer、Authority和Additional175.NAPTR记录格式186.ENUM DNSHead消息字段说明187.ENUM DNS Question消息字段说明208.ENUM DNS Answer、Authority和Additional消息字段说明219.ENUM DNS NAPTR记录格式字段说明22前 言本标准对中国移动通信业务层VGOP-综合网关系统(SIG:Service Integrated Gateway)的接口定义技术细节提出要求,是VGOP-综合网关系统建设所需要遵从技术文件。本标准包括的主要内容:VGOP-综合网关各相关接口定义,包括接入认证接口,业务
5、调用接口,业务能力开放接口,VGOP鉴权接口,数据发布接口,网管接口等。本标准是中国移动VGOP-综合网关系统系列标准之一,该系列标准的结构、名称或预计的名称如下:序号标准编号标准名称1QB-D-112-2009中国移动VGOP-综合网关系统总体技术要求2QB-D-113-2009中国移动VGOP-综合网关系统设备规范3QB-D-114-2009中国移动VGOP-综合网关系统接口规范本标准的附录A为标准性附录,附录B为参考性附录。本标准由中移技2009270号印发。本标准由中国移动通信研究院提出,集团公司技术部归口。本标准起草单位:中国移动通信研究院。本标准主要起草人:段翔、谢丰、胡伟、杨剑1
6、 范围本标准定义了中国移动VGOP-综合网关系统的接口要求,为中国移动通信集团公司及各省公司进行综合网关系统开发提供技术依据。本标准适合中国移动内部和厂商共同使用。本标准适用于中国移动业务网环境,适合任何一种无线接入环境,包括GSM/GPRS/EDGE/TS-SCDMA。2 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。序号标准编号标准名称发布单位1一级综合业务运营平台(VG
7、OP)接口规范中国移动通信有限公司2数据业务管理平台(DSMP)接口规范中国移动通信有限公司3 术语、定义和缩略语3.1. 术语、定义表3-1:术语/定义术语/定义解释业务应用向用户提供交互访问和增值业务/内容的一组特定业务逻辑,包括第三方应用、自有增值应用和集团业务的应用逻辑等业务能力一组能够完成某特定业务处理事务的功能和资源集合,提供交互通信或信息获取/查询等基本服务,并可通过标准接口向应用或他业务平台开放一类业务一类业务是指业务全网规划,业务平台统一建设,面向所有省份用户统一提供的业务,包括集团公司统一建设业务平台的业务和基地省业务;又称为全网业务二类业务二类业务是指业务全网统一规划,业
8、务平台分省建设,面向所有省份用户统一提供的业务三类业务三类业务是指由各省规划,业务平台各省分别建设,面向省内用户提供的业务;又称为本地业务全网业务平台全网统一建设和管理的业务平台;一般一类业务的业务平台为全网业务平台本地业务平台各省分别建设和管理的业务平台;一般二类、三类业务的业务平台为本地业务平台3.2. 缩略语表3-2:缩略语缩略语英文全称中文含义SDAService Delivery Architecture业务递送架构(中国移动业务网架构)VGOPValue-added Service General Operating Platform综合业务运营平台SIGService Integ
9、rated Gateway综合网关4 系统结构VGOP-综合网关(以下简称综合网关或SIG)在网络中的位置如下图所示。 图4-1:综合网关系统架构示意图所涉及的接口包括如下图所示。 图4-2:综合网关系统功能与接口示意图综合网关系统与其他业务网系统的接口包括:l SIG-Sg(业务能力调用接口):综合网关系统提供此接口向业务平台开放业务能力,供各业务平台进行调用。接口采用基于HTTP的SOAP协议,以WebService的方式通信,接口传递的数据以XML的形式进行封装。综合网关间的消息的前转接口也采用该接口,实现一级综合网关和省级综合网关之间的消息路由前转;l SIG-Sa(业务能力开放接口)
10、:综合网关通过此接口调用业务能力提供的功能。接口采用基于HTTP的SOAP协议,以WebService的方式通信,接口传递的数据以XML的形式进行封装;l SIG-Rc(平台接入认证接口):综合网关通过该接口实现业务平台和综合网关之间的接入认证功能;l SIG-Ra(综合网关与VGOP的鉴权接口):综合网关与VGOP的鉴权接口,实现业务的互通和业务能力调用鉴权控制,接口采用WebService的方式实现,具体参考VGOP的互通鉴权接口定义;l SIG-Mn(综合网关的网管接口):综合网关与网管之间的接口,实现网络管理,性能信息,告警信息的消息上报等功能;l SIG-Ms(数据发布接口):VGO
11、P向综合网关发布业务、能力及黑白名单授权关系数据的接口,及综合网关间实现路由数据和业务能力黑白名单授权关系数据发布的接口,接口消息通过WebService消息的方式实现。l SIG-Mr(综合网关与路由查询系统/模块之间的接口):综合网关通过该接口向路由查询系统/模块获取用户的路由信息。5 接入认证接口(SIG-Rc)5.1. 接口描述为了保护综合网关和业务平台的安全,综合网关对所有接入的业务请求进行鉴权。业务请求鉴权采用动态分配 accessToken 的机制。业务平台,业务能力,其他综合网关向本综合网关发送业务请求之前,需要主动向综合网关发送登录请求。综合网关对业务平台的用户名和密码进行比
12、对,对合法的业务平台登陆请求返回临时accessToken,并为该accessToken指定有效期,后续的所有业务请求,都要在业务请求消息接口中携带该Token, 在Token有效期内,业务请求可以通过综合网关的鉴权,对不合法的accessToken和过期的accessToken综合网关会拒绝该业务请求。该接口名字规定为accessAuth。接口用标准Web Service定义。包括获取accessToken操作(accessAuthLogin)和结束accessToken操作(accessAuthLogout)。此外,对于被调用的业务(能力)平台,同样要求支持对综合网关系统的接入认证机制,实
13、现该接口和相关功能。5.2. 接口定义5.2.1. accessAuthLogin定义n accessAuthLoginReq参数类型约束说明accountIDxsd:string必填用户名,可以使用平台PID或网关GWID,长度为6位authStringxsd:string必填原始密码为8位,不足8位在前面补0;MD5加密后输出长度为32位,算法为:md5(accountID+Password+timeStamp)timeStampxsd:dateTime必填时间戳accessTokenxsd:string可选此字段可选,客户端携带此字段时表明需要刷新Token有效期,若综合网关发现客户端携
14、带的Token无效,重新返回一个新accessTokenn accessAuthLoginResp参数类型约束说明resultxsd:string必选接入认证结果,0为认证通过,其余值为认证错误。accessTokenxsd:string可选最大长度为16位,其中前6位为GWID或被调用的业务平台的PIDlifetimexsd:int可选有效时长,单位秒。5.2.2. accessAuthLogout定义n accessAuthLogoutReq参数类型约束说明accountIDxsd:string必填用户名,可以使用平台PID或网关GWID,长度为6位authStringxsd:string
15、必填原始密码为8位,不足8位在前面补0;MD5加密后输出长度为32位,算法为:md5(accountID+Password+timeStamp)timeStampxsd:dateTime必填时间戳n accessAuthLogoutResp参数类型约束说明resultxsd:int必选0表示正常登出。其余失效。6 业务调用接口(SIG-Sg)6.1. 接口功能该接口为业务接入网关与业务能力网元之间的接口,综合网关系统提供此接口向业务平台开放业务能力,供各业务平台进行调用。该接口主要定义综合网关和业务平台之间的消息的结构的公共部分,即消息头部分。综合网关仅解析消息头,不处理消息体。6.2. 接口
16、定义综合接入网关实现能力开放功能的接口均为消息类接口,采用WebService接口协议,接口内容信息采用XML进行描述,基于SOAP封装。接口传输采用基于HTTP的接口调用方式,要求HTTP的版本为1.1以上。综合网关必须支持持久性HTTP连接(HTTP keep-alive)方式和非持久性HTTP连接方式。从安全性考虑,要求综合网关支持HTTPS连接。对于请求方式,WebService接口访问URL为被调用业务能力对应业务平台的URL,或可以采用如下组成形式进行调用:http:/URL:port/ProviderSID/EnName/IFName/对于通知方式,WebService接口访问U
17、RL为调用业务对应业务平台的URL,或可采用如下组成形式进行调用:http:/URL:port/CallerSID/CallBack/其中,ProviderSID和CallerSID参见后续章节中消息头的定义;EnName为被调用的业务能力组件名称;URL:port 为被调用的业务能力组件对应的物理平台的URL或IP地址和端口号。6.2.1. 接口消息结构综合接入网关能力开放接口的消息协议数据单元(PDU)由消息头(header)和消息体(body)组成。消息头和消息体在XML中的表现形式如下:消息头元素一 消息头元素二 消息头元素三 消息体元素一 消息体元素二 消息体元素三 6.2.2. 请
18、求消息头定义字段名类型约束说明versionxsd:string必选消息的版本号,最大长度10字节,初始版本号为“1.0.0”;accessTokenxsd:string必选业务能力/业务平台到综合网关,以及综合网关之间的接入认证Token,长度16字节TIDxsd:string必选操作交易序列号,由消息发起的网元生成,长度12字节callerSIDxsd:string必选能力调用者的业务编码(SID):请求方式时,为调用平台的业务编码;通知方式时,为被通知业务的业务编码;callerSSIDxsd:string可选能力调用者的子业务编码(SSID),仅用于扩展业务的区分,综合网关不做处理;省
19、略的话表示SID对应的基本业务;providerSIDxsd:string必选能力提供者业务编码(SID);providerEIDxsd:string必选能力提供者业务能力标识(EID);providerECIDxsd:string可选能力提供者业务能力组件标识(ECID),仅用于VGOP授权管理,综合网关不做处理; providerIFNamexsd:string必选能力提供者接口名称:当调用方式为请求方式时,providerIFName为能力提供者接口名称;当调用方式为通知方式时,providerIFName为能力调用者的回调接口名称;UIDxsd:string必选调用用户标识,最长64位
20、,格式为:“T:13XXXXXXXXX”(“T:”后带真实手机号码,不带“+86”);“P:XXXXX”(“P:”后带用户伪码);“A:XXXXX”(“A:”后带其他用户别名,如,飞信号,邮箱别名等);请求方式时,为能力调用者的号码;通知方式时,为能力结果使用者的号码;secondaryUIDxsd:string可选在调用中涉及的请求相关的UID,如,飞信用户查询好友位置信息,则secondaryUID为被查询的好友的UID。格式与UID定义相同;chargingUIDxsd:string可选计费用户ID,格式同UID。为能力调用相关的用户号码;callingTypexsd:string必选能
21、力调用方式,长度为2字节,“01”:请求方式“02”:通知方式timeStampxsd:dateTime必选消息发送时间(采用北京时间)TTLxsd:int必选为了避免路由循环,使用该参数进行控制,调用发起的业务平台填写3;每个综合网关在收到该请求并转发时,将该值减1;若综合网关检查TTL值为0,则直接拒绝该请求,并返回错误码routingHeaderRouting_header_schema可选路由头,用于综合网关进行业务能力调用的消息路由,由业务平台或综合网关填写n Routing_header_schema结构体:字段名类型约束说明sourcePIDxsd:string可选消息发起的源业
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 中国移动 VGOP 综合 网关 系统 接口 规范
![提示](https://www.31ppt.com/images/bang_tan.gif)
链接地址:https://www.31ppt.com/p-2292265.html