中国联通增值业务鉴权中心接口规范-VAC与增值系统接口分册-1212

中国联通增值业务鉴权中心

接口规范

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 （命令字）定义 (3)

4.1.3 基本数据类型 (4)

4.1.4 PDU 概述 (4)

4.1.4.1 连接消息 (5)

4.1.4.2 去连接消息 (6)

4.1.4.3 链路握手消息 (6)

4.1.4.4 鉴权批价 (7)

4.1.4.5 鉴权批价确认 (13)

4.1.4.6 流量计费消息 (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门户） (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)

4.4.5.1 用户信息查询请求（UserIdRequest） (22)

I

中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）

4.4.5.2 用户信息查询响应（UserInfoResponse） (23)

4.4.5.3 用户信息结构 (23)

4.5用户信息同步接口 (24)

4.5.1 接口方式 (24)

4.5.2 文件目录 (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

中国联通增值业务鉴权中心接口规范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

国内点对点彩信代码：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

中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）

前言

本标准由中国联通公司增值业务部提出。

本标准由中国联通公司技术部归口。

本标准负责起草单位：中讯邮电咨询设计院，中国联通公司增值业务部

本标准主要起草人：

本标准的修改和解释权属中国联通公司。

IX

中国联通增值业务鉴权中心接口规范 V AC 与增值业务系统接口分册（V1.1）

X

中国联通增值业务鉴权中心接口规范 VAC 与增值业务系统接口分册

（V1.1）

1 范围

本接口规范主要对中国联通增值业务鉴权中心接口规范 VAC 与增值业务系统接口方面进行了规定。 2 规范性引用文件

下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。

SMPP 点对点互通协议V3.3/V3.4 PDSCP 中国联通预付费用户点到点短消息实时计费实现技术规范V1.2 SGIP 中国联通业务网关接口规范 3 缩略语和术语 3.1 缩略语

术语及缩写

英文

中文

CDR Call Detail Record 话单

CP Content Provider

内容提供商 CRM Customer Realtionship Management 客户关系管理系统 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 Control 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+ Short 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）业务：业务是指中国联通根据客户的通信需求，利用自身或第三方资源向客户提供的具有市场价值的通信服务内容。在管理上，业务是服务提供商与运营商进行审核管理和分成结

算的对象。如“手机酷图”业务。

2）业务能力：指基础增值服务，例如：邮件、消息、浏览、流媒体等，可以使用这些业务能力进行组合，构造出特定的业务，满足细分市场后的用户需求。

3）业务引擎：指实现各个业务能力的物理实体。

4）产品：产品是指中国联通运用营销手段，是用户购买业务的方式，将业务或业务组合附加上销售对象、销售地域、资费计划、销售渠道、服务水平及配套资源六个方面属性后的产

物，是向客户最终交付的、客户可以购买的业务或业务组合实例。在VASP系统中，产品是

定制、鉴权、和计费的对象，如“包月5元”。在VASP中，一个业务对应多个产品，一个产

品唯一对应一个业务。

5）内容：内容是用户真正使用的对象，是在业务中提供的一个个实体，如“手机酷图”业务中的一个图片。

6）业务支撑系统：综合计费、综合结算、综合帐务、经营分析、客户关系管理组成了中国联通业务支撑系统。

7）上行请求：由移动用户在手机终端上或各种门户上发起的增值业务使用请求。

8）下行请求：由CP/SP发起的向用户提供服务的增值业务使用请求。

4 VAC和增值业务系统间的接口

4.1 实时鉴权计费接口

4.1.1 接口描述

接口消息包括认证鉴权请求、认证鉴权应答、认证鉴权确认、认证鉴权确认应答等消息。

业务系统向AAA发起鉴权请求，AAA生成详细的话单记录。

鉴权计费接口是请求和响应的接口消息，基于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。

业务系统和VAC之间的协议的一种典型应用场景描述如图1：

2

中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）

图1：业务系统和VAC之间的典型应用场景

4.1.2 Command ID （命令字）定义

业务系统和VAC之间消息的Command ID 定义如下：

Command ID 值描述

CmdID_Bind 0x10000001 连接请求

CMDID_BindResp 0x80000001 连接应答

CMDID_UnBind 0x10000002 去连接请求

CMDID_UnBindResp 0x80000002 去连接应答

CMDID_Handset 0x10000003 链接握手请求CMDID_ HandsetResp 0x80000003 链接握手应答CMDID_CheckPrice 0x10000005 鉴权批价请求CMDID_CheckPriceResp 0x80000005 鉴权批价应答

3

中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）

CMDID_CheckPriceConfirm 0x10000006 鉴权批价确认请求

CMDID_CheckPriceConfirmResp 0x80000006 鉴权批价确认应答

CMDID_TrafficPrice 0x10000007 流量批价请求

CMDID_ TrafficPriceResp 0x80000007 流量批价应答

CMDID_ContentAbstractReq0x10000008保留、内容摘要请求

CMDID_ContentAbstractResp0x80000008保留、内容摘要响应

4.1.3 基本数据类型

业务系统和VAC之间的基本数据类型定义如下：

4.1.4 PDU 概述

PDU包括消息头和消息体。如下表所示

消息头定义如下：

为了便于协议未来的扩充，协议提供以TLV形式定义的可选参数。可选参数使用方法如下：

1). 只带必须的。如果要用到时就带上，用不到则不带。

4

中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）

2). 最大长度只用来限制该字段的长度上限，任何时候都不能做为判断tlv字段实际长度的依据。任何时候tlv字段内容的实际长度的唯一依据只能是长度字段即L字段。

3). 一个tlv字段包括tag ,length,value。Value的长度由length唯一确定，可以是0。如果length 为0即Value的长度是0时，tlv由tag,length组成。

4).出于协议的兼容性考虑，要求客户端或者服务器可以跳过不能识别的TLV字段。

4.1.4.1 连接消息

该消息用于建立从业务系统到增值业务平台的连接。

1）Bind 连接请求

方向：业务系统/业务引擎->VAC

5

中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）

方向 : VAC->业务系统/业务引擎

BindResp连接应答消息中包含的参数如下:

4.1.4.2 去连接消息

该消息提供给VAC 一个安全的断链过程以清除资源。

1）Unbind 去连接请求

方向 : 业务系统/业务引擎->VAC

2）UnbindRspone去连接应答

方向 : VAC->业务系统/业务引擎

UnbindRspone去连接应答消息中包含的参数如下:

4.1.4.3 链路握手消息

该消息用于维持VAC和业务业务系统/业务引擎之间的TCP 连接。

1）Handset链路握手请求

方向 : 业务系统/业务引擎<->VAC

链路握手消息中不包含任何参数。

6

中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）

2）HandsetResp链路握手应答

方向 : 业务系统/业务引擎<->VAC

4.1.4.4 鉴权批价

鉴权批价消息是一个复合操作，包括了用户鉴权、业务鉴权、定购关系鉴权、计费等操作的功能。

1）CheckPrice鉴权批价请求

方向 : 业务系统/业务引擎 -> VAC

CheckPrice鉴权批价请求消息中包含的参数如下:

7

中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）

中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）

9

中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）

注：（1）当Operation Type=7时，VAC取消ServiceType对应的终端侧能单独退订的所有订购关系并立即失效，并关闭该ServiceType对应用户业务能力；后续业务平台发起关于该ServiceType的相关鉴

10

中国联通增值业务鉴权中心接口规范V AC与增值业务系统接口分册（V1.1）

权（当业务系统发起Operation Type=8鉴权，或针对高信用度产品发起Operation Type=0鉴权，vac返回成功），vac返回失败1006；当屏蔽所有业务能力时，servicetype填写00。

（2）当Operation Type=8时，VAC开通该用户的ServiceType对应业务能力。

（3）当Operation Type=3时，

◆当servicetype不为00、SPID不为00000、SP_ProductID为00000时，退订用户SPID下的

servicetype所有订购关系；

◆当servicetype为00、SPID不为00000、SP_ProductID为00000时，退订用户SPID下所有业

务类型所有订购关系；

◆当servicetype不为00、SPID为00000、SP_ProductID为00000时，退订用户servicetype

下的所有订购关系；

◆当servicetype为00、SPID为00000、SP_ProductID为00000时，退订用户所有订购关系；

（4）针对点对点彩信，业务代码、产品代码等按照以下方式分配，彩信中心按照以下规则填写后发起到vac的国内点对点彩信业务鉴权，彩信国际互通网关按照以下规则填写后发起到vac的国际彩信业务鉴权：

◆CPID：不需要规定，不使用

◆SPID ：99999

◆国际彩信业务代码：32000001，其中32 彩信中心编码，00 全国业务，0001 业务编

号；国际彩信产品代码：3200000101

◆国内点对点彩信代码：32xx0002，其中32 彩信中心编码，xx 分公司业务（xx为省分代

码），0002 业务编号；国内点对点彩信产品代码32xx000201

◆国内点到mail彩信代码：32xx0003，其中32 彩信中心编码，xx 分公司业务（xx为省分

代码），0003 业务编号；国内点对点彩信产品代码32xx000301

（5）针对业务代码等信息，增值系统、vac、业务支撑系统必须都是可配、可调的

（6）增值系统发起ServiceID计费鉴权情况下，VAC根据业务找产品，其中有一个代收费产品，即按照代收费处理。

2）CheckPriceResp鉴权批价应答

方向 : VAC -> 业务系统/业务引擎

为了避免VAC较忙时无法在规定时间内内响应而造成部分业务的定购的流失。在业务系统向AAA发鉴权批价请求后，业务系统作为Server，VAC作为Client，业务系统等待AAA的响应。

CheckPriceResp鉴权批价应答消息中包含的参数如下:

11

本文来源：https://www.bwwdw.com/article/xq0q.html