中国移动VGOP综合网关系统接口规范.doc

中国移动通信企业标准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. accessAuthLogout定义 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. 业务能力信息同步（enablerInfoSync） 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消息头Header 173. 请求消息Question 174. 响应消息Answer、Authority和Additional 175. 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-综合网关各相关接口定义，包括接入认证接口，业务调用接口，业务能力开放接口，VGOP鉴权接口，数据发布接口，网管接口等本标准是中国移动VGOP-综合网关系统系列标准之一，该系列标准的结构、名称或预计的名称如下：序号标准编号标准名称[1]QB-D-112-2009中国移动VGOP-综合网关系统总体技术要求[2]QB-D-113-2009中国移动VGOP-综合网关系统设备规范[3]QB-D-114-2009中国移动VGOP-综合网关系统接口规范本标准的附录A为标准性附录，附录B为参考性附录本标准由中移技〔2009〕270号印发本标准由中国移动通信研究院提出，集团公司技术部归口本标准起草单位：中国移动通信研究院本标准主要起草人：段翔、谢丰、胡伟、杨剑1 范围本标准定义了中国移动VGOP-综合网关系统的接口要求，为中国移动通信集团公司及各省公司进行综合网关系统开发提供技术依据本标准适合中国移动内部和厂商共同使用本标准适用于中国移动业务网环境，适合任何一种无线接入环境，包括GSM/GPRS/EDGE/TS-SCDMA2 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。

凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本凡是不注日期的引用文件，其最新版本适用于本标准序号标准编号标准名称发布单位[1]《一级综合业务运营平台（VGOP）接口规范》中国移动通信有限公司[2]《数据业务管理平台（DSMP）接口规范》中国移动通信有限公司3 术语、定义和缩略语3.1. 术语、定义表3-1：术语/定义术语/定义解释业务应用向用户提供交互访问和增值业务/内容的一组特定业务逻辑，包括第三方应用、自有增值应用和集团业务的应用逻辑等业务能力一组能够完成某特定业务处理事务的功能和资源集合，提供交互通信或信息获取/查询等基本服务，并可通过标准接口向应用或他业务平台开放一类业务一类业务是指业务全网规划，业务平台统一建设，面向所有省份用户统一提供的业务，包括集团公司统一建设业务平台的业务和基地省业务；又称为全网业务二类业务二类业务是指业务全网统一规划，业务平台分省建设，面向所有省份用户统一提供的业务三类业务三类业务是指由各省规划，业务平台各省分别建设，面向省内用户提供的业务；又称为本地业务全网业务平台全网统一建设和管理的业务平台；一般一类业务的业务平台为全网业务平台本地业务平台各省分别建设和管理的业务平台；一般二类、三类业务的业务平台为本地业务平台3.2. 缩略语表3-2：缩略语缩略语英文全称中文含义SDAService Delivery Architecture业务递送架构（中国移动业务网架构）VGOPValue-added Service General Operating Platform综合业务运营平台SIGService Integrated Gateway综合网关4 系统结构VGOP-综合网关（以下简称综合网关或SIG）在网络中的位置如下图所示。

图4-1：综合网关系统架构示意图 所涉及的接口包括如下图所示 图4-2：综合网关系统功能与接口示意图综合网关系统与其他业务网系统的接口包括：l SIG-Sg（业务能力调用接口）：综合网关系统提供此接口向业务平台开放业务能力，供各业务平台进行调用接口采用基于HTTP的SOAP协议，以WebService的方式通信，接口传递的数据以XML的形式进行封装综合网关间的消息的前转接口也采用该接口，实现一级综合网关和省级综合网关之间的消息路由前转；l SIG-Sa（业务能力开放接口）：综合网关通过此接口调用业务能力提供的功能接口采用基于HTTP的SOAP协议，以WebService的方式通信，接口传递的数据以XML的形式进行封装；l SIG-Rc（平台接入认证接口）：综合网关通过该接口实现业务平台和综合网关之间的接入认证功能；l SIG-Ra（综合网关与VGOP的鉴权接口）：综合网关与VGOP的鉴权接口，实现业务的互通和业务能力调用鉴权控制，接口采用WebService的方式实现，具体参考VGOP的互通鉴权接口定义；l SIG-Mn（综合网关的网管接口）：综合网关与网管之间的接口，实现网络管理，性能信息，告警信息的消息上报等功能；l SIG-Ms（数据发布接口）：VGOP向综合网关发布业务、能力及黑白名单授权关系数据的接口，及综合网关间实现路由数据和业务能力黑白名单授权关系数据发布的接口，接口消息通过WebService消息的方式实现。

l SIG-Mr（综合网关与路由查询系统/模块之间的接口）：综合网关通过该接口向路由查询系统/模块获取用户的路由信息5 接入认证接口（SIG-Rc）5.1. 接口描述为了保护综合网关和业务平台的安全，综合网关对所有接入的业务请求进行鉴权业务请求鉴权采用动态分配 accessToken 的机制业务平台，业务能力，其他综合网关向本综合网关发送业务请求之前，需要主动向综合网关发送登录请求综合网关对业务平台的用户名和密码进行比对，对合法的业务平台登陆请求返回临时accessToken，并为该accessToken指定有效期，后续的所有业务请求，都要在业务请求消息接口中携带该Token, 在Token有效期内，业务请求可以通过综合网关的鉴权，对不合法的accessToken和过期的accessToken综合网关会拒绝该业务请求该接口名字规定为accessAuth接口用标准Web Service定义包括获取accessToken操作（accessAuthLogin）和结束accessToken操作（accessAuthLogout）此外，对于被调用的业务（能力）平台，同样要求支持对综合网关系统的接入认证机制，实现该接口和相关功能。

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有效期，若综合网关发现客户端携带的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必填原始密码为8位，不足8位在前面补0；MD5加密后输出长度为32位，算法为：md5(accountID+Password+timeStamp)timeStampxsd:dateTime必填时间戳n accessAuthLogoutResp参数类型约束说明r。