中国联通增值业务鉴权中心接口规范

1、本文格式为Word版，下载可任意编辑 中国联通增值业务鉴权中心接口规范 中国联通增值业务鉴权中心 接口规范 VAC与增值业务系统接口分册 （V1.1） China Unicom （Version 1.0） 中国联通公司发布 中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1） 目次 修改记录 III 前言 IX 1范围. (10) 2规范性引用文件 (10) 3缩略语和术语 (10) 3.1缩略语 (10) 3.2术语 (2) 4 VAC和增值业务系统间的接口 (2) 4.1实时鉴权计费接口 (2) 4.1.1 接口描述 (2) 4.1.2 Command ID （命令字

2、）定义 (3) 4.1.3 基本数据类型 (4) 4.1.4 PDU 概述 (4) 连接消息 (5) 去连接消息 (6) 链路握手消息 (6) 鉴权批价 (7) 鉴权批价确认 (13) 流量计费消息 (14) 4.2统一配置接口 (17) 4.2.1 接口描述 (17) 4.2.2 SP基本信息FTP文件同步接口 (18) 4.2.3 SP能力信息FTP文件同步接口 (18) 4.2.4 业务信息FTP文件同步接口 (18) 4.2.5 业务能力信息FTP文件同步接口 错误！未定义书签。 4.2.6 产品信息FTP文件同步接口 (18) 4.2.7 订购关系FTP文件同步接口（WAP门户） (

3、18) 4.2.8 CP基本信息FTP文件同步接口 (18) 4.3查询用户定购关系接口 (18) 4.4查询用户信息接口 (22) 4.4.1 接口描述 (22) 4.4.2 发起方系统 (22) 4.4.3 接受方系统 (22) 4.4.4 接口协议 (22) 4.4.5 接口内容 (22) 用户信息查询请求（UserIdRequest） (22) I 中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1） 用户信息查询响应（UserInfoResponse） (23) 用户信息结构 (23) 4.5用户信息同步接口 (24) 4.5.1 接口方式 (24) 4.5.2

4、 文件目录 (24) 4.5.3 文件格式 (24) 4.6用户号段同步接口 (24) 4.6.1 接口描述 (24) 4.6.2 接口协议 (24) 4.6.3 接口内容 (25) 4.7测试用户同步接口 (25) 4.7.1 接口描述 (25) 4.7.2 接口协议 (25) 4.7.3 接口内容 (25) 附录 A （规范性附录）可选参数标识定义 (27) 附录 B （规范性附录）数据类型定义 (28) 附录 C （规范性附录）鉴权批价接口返回错误结果码定义 (31) 附录 D （规范性附录）门户结果码定义 (33) 附录 E （规范性附录）wsdl (35) II 中国联通增值业务鉴权

5、中心接口规范V AC与增值业务系统接口分册（V1.1） 修改记录 III 中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1） IV 中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1） V 中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1） 国内点对点彩信业务鉴权，彩信国际互通网关依照以下 规矩填写后发起到vac的国际彩信业务鉴权： CPID：不需要规定，不使用 SPID ：99999 国际彩信业务代码：32000001，其中32 彩信中 心编码，00 全国业务，0001 业务编号；国际彩信产品 代码：3200000101

6、国内点对点彩信代码：32xx0002，其中32 彩信中 心编码，xx 分公司业务（xx为省分代码），0002 业务编 号；国内点对点彩信产品代码32xx000201 国内点到mail彩信代码：32xx0003，其中32 彩信 中心编码，xx 分公司业务（xx为省分代码），0003 业务 编号；国内点对点彩信产品代码32xx000301 （5）针对业务代码等信息，增值系统、vac、业务支撑 系统务必都是可配、可调的 VI 中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1） VII 中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1） VIII 中国联

7、通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1） 前言 本标准由中国联通公司增值业务部提出。 本标准由中国联通公司技术部归口。 本标准负责起草单位：中讯邮电咨询设计院，中国联通公司增值业务部 本标准主要起草人： 本标准的修改和解释权属中国联通公司。 IX 中国联通增值业务鉴权中心接口规范 V AC 与增值业务系统接口分册（V1.1） X 中国联通增值业务鉴权中心接口规范 VAC 与增值业务系统接口分册 （V1.1） 1 范围 本接口规范主要对中国联通增值业务鉴权中心接口规范 VAC 与增值业务系统接口方面进行了规定。 2 规范性引用文件 以下文件中的条款通过本标准的引用而成

8、为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，激励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。 SMPP 点对点互通协议V3.3/V3.4 PDSCP 中国联通预付费用户点到点短消息实时计费实现技术规范V1.2 SGIP 中国联通业务网关接口规范 3 缩略语和术语 3.1 缩略语 术语及缩写 英文 中文 CDR Call Detail Record 话单 CP Content Provider 内容提供商 CRM Customer Realtionship Managem

9、ent 客户关系管理系统 DCC Diameter Credit Control Diameter 信控协议 MMS Multimedia Messaging Service 多媒体消息服务 MS Mobile Station 移动台 MSISDN Mobile Station ISDN number 移动设备ISDN 号码 MO Mobile Originated 手机提交消息 MT Mobile Terminated 手机终止消息 OCS Online Charging System 在线计费系统 QoS Quality of Service 服务质量 SCP Service Contro

10、l Point 服务操纵点 SGIP Short message Gateway Interface Protocol 短消息网关接口协议 SGIP+ Short message Gateway Interface Protocol plus 联通在信扣费协议 SMG Short Message Gateway 短消息网关 中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）SMSC Short Message Service Centre 短信息中心 SMPP Short Message Peer to Peer Protocol 短消息点对点协议 SMPP+ Shor

11、t Message Peer to Peer Protocol Plus 扩展SMPP协议 SP Service Provider 服务提供商 URL Uniform Resource Locator 统一资源定位符 VAC Value-added service Authentication Center增值业务鉴权中心 VASP Value-add Service Platform 综合增值业务平台 WAP Wireless Application Protocol 无线应用协议 3.2 术语 1）业务：业务是指中国联通根据客户的通信需求，利用自身或第三方资源向客户提供的具有市场价值的通信

12、服务内容。在管理上，业务是服务提供商与运营商进行审核管理和分成结 算的对象。如“手机酷图业务。 2）业务能力：指基础增值服务，例如：邮件、消息、浏览、流媒体等，可以使用这些业务能力进行组合，构造出特定的业务，满足细分市场后的用户需求。 3）业务引擎：指实现各个业务能力的物理实体。 4）产品：产品是指中国联通运用营销手段，是用户购买业务的方式，将业务或业务组合附加上销售对象、销售地域、资费计划、销售渠道、服务水平及配套资源六个方面属性后的产 物，是向客户最终交付的、客户可以购买的业务或业务组合实例。在VASP系统中，产品是 定制、鉴权、和计费的对象，如“包月5元。在VASP中，一个业务对应多个产

13、品，一个产 品唯一对应一个业务。 5）内容：内容是用户真正使用的对象，是在业务中提供的一个个实体，如“手机酷图业务中的一个图片。 6）业务支撑系统：综合计费、综合结算、综合帐务、经营分析、客户关系管理组成了中国联通业务支撑系统。 7）上行请求：由移动用户在手机终端上或各种门户上发起的增值业务使用请求。 8）下行请求：由CP/SP发起的向用户提供服务的增值业务使用请求。 4 VAC和增值业务系统间的接口 4.1 实时鉴权计费接口 4.1.1 接口描述 接口消息包括认证鉴权请求、认证鉴权应答、认证鉴权确认、认证鉴权确认应答等消息。 业务系统向AAA发起鉴权请求，AAA生成细致的话单记录。 鉴权计费

14、接口是请求和响应的接口消息，基于TCP的网络连接。 业务系统作为协议通讯的客户端先建立与VAC的TCP连接。然后，双方在会话期间开始交换PDU(Protocol Data Unit).当在连接上没有信息交换的时候，双方应当每隔C（C为可设置参数）秒钟相互发送Handset PDU,以保持连接。假如在T（T为可设置参数）秒之后，仍旧没有对方的响应信息回复，则发送方应当再一次发送Handset PDU.假如在发送方发送N-1(N为可设置参数)条Handset PDU到对方之后，仍旧无响应信息，发送方将关闭连接，通讯终止。 其中C，T，N的值均可以根据实际状况进行设定。C的典型值为60秒，T是60秒，N是3