中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册
（V1.1）
1 范围
本接口规范主要对中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口方面进行了规定。 2 规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。
SMPP 点对点互通协议V3.3/V3.4 PDSCP 中国联通预付费用户点到点短消息实时计费实现技术规范V1.2 SGIP 中国联通业务网关接口规范 3 缩略语和术语 3.1 缩略语
术语及缩写
CDR CP CRM DCC MMS MS MSISDN MO MT OCS QoS SCP SGIP SGIP+ SMG
英文
Call Detail Record Content Provider
Customer Realtionship Management Diameter Credit Control Multimedia Messaging Service Mobile Station
Mobile Station ISDN number Mobile Originated Mobile Terminated Online Charging System Quality of Service Service Control Point
Short message Gateway Interface Protocol
话单
中文
内容提供商 客户关系管理系统 Diameter信控协议 多媒体消息服务 移动台
移动设备ISDN号码 手机提交消息 手机终止消息 在线计费系统 服务质量 服务控制点 短消息网关接口协议
Short message Gateway Interface Protocol 联通在信扣费协议 plus
短消息网关 Short Message Gateway
X
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
SMSC SMPP SMPP+ SP URL VAC VASP WAP
Short Message Service Centre Short Message Peer to Peer Protocol Short Message Peer to Peer Protocol Plus Service Provider Uniform Resource Locator
Value-added service Authentication Center Value-add Service Platform Wireless Application Protocol
短信息中心 短消息点对点协议 扩展SMPP协议 服务提供商 统一资源定位符 增值业务鉴权中心 综合增值业务平台 无线应用协议
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
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
业务系统 AAA Open Tcp Connetcion Bind BindResp CheckPrice CheckPriceResp Handset HandsetResp Unbind UnbindResp Close Tcp Connetcion
图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
描述
连接请求 连接应答 去连接请求 去连接应答 链接握手请求 链接握手应答 鉴权批价请求 鉴权批价应答
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
CMDID_CheckPriceConfirm 0x10000006 CMDID_CheckPriceConfirmResp 0x80000006 CMDID_TrafficPrice 0x10000007 CMDID_ TrafficPriceResp 0x80000007 CMDID_ContentAbstractReq 0x10000008 CMDID_ContentAbstractResp 0x80000008
4.1.3 基本数据类型
业务系统和VAC之间的基本数据类型定义如下：
名称 Unsigned Integer Integer4 Integer2 Integer1 Octet String 描述 无符号整数 4字节整数 2字节整数 单字节整数 鉴权批价确认请求 鉴权批价确认应答 流量批价请求 流量批价应答
保留、内容摘要请求 保留、内容摘要响应
固定长度字符串，不足长度则右补二进制0，此类型字符串定义的最大长度不包括结束符’\\0’的长度 右对齐固定长度的字符串。不足长度则左补二进制0 以’\\0’结束的C类型字符串 TLV 方式定义中的字符串类型，此类型不需要带结束符”\\0”，长度以TLV 中的Length 的值为准。(可选参数用) Octet String(Decimal) C-Octet String TLV String
4.1.4 PDU 概述
PDU包括消息头和消息体。如下表所示
PDU 组成 Message Header Message Body
消息头定义如下： 字段名称 TotalLength CommandId SequenceId 类型 Unsigned Integer Unsigned Integer Unsigned Integer 字节长度 4 4 4 描述 一个PDU的总字节数（包括这一字段的4个字节） 命令标识符 用于请求和响应间保持联系的序号 描述 消息头 消息体
为了便于协议未来的扩充，协议提供以TLV形式定义的可选参数。可选参数使用方法如下： 1). 只带必须的。如果要用到时就带上，用不到则不带。
4
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
2). 最大长度只用来限制该字段的长度上限，任何时候都不能做为判断tlv字段实际长度的依据。任何时候tlv字段内容的实际长度的唯一依据只能是长度字段即L字段。
3). 一个tlv字段包括tag ,length,value。Value的长度由length唯一确定，可以是0。如果length为0即Value的长度是0时，tlv由tag,length组成。
4).出于协议的兼容性考虑，要求客户端或者服务器可以跳过不能识别的TLV字段。 TLV字段的定义如下表所描述 名称 Tag Length Value 类型 Integer2 Integer2 字段长度 2 2 描述 字段标签 字段长度 字段内容 Octet String Variable Length
4.1.4.1 连接消息
该消息用于建立从业务系统到增值业务平台的连接。
1） Bind 连接请求
方向：业务系统/业务引擎->VAC
Bind 连接请求消息中包含的参数如下: 字段名称 SourceDevice_Type 类型 Integer4 长度（字节） 描述 4 原始端设备类型，参考附录B 可不做逻辑处理 原始端设备识别号，定义为“2位设备类型＋3位省分代码＋1位序列号” 2位设备类型见vac与增值系统规范附录B， 3位省分代码见VAC与BSS规范附录A.16 目标端设备类型，可不做逻辑处理 目标端设备识别号，定义为“2位设备类型＋3位省分代码＋1位序列号” 2位设备类型见vac与增值系统规范附录B， 3位省分代码见VAC与BSS规范附录A.16 该域用来对原始端进行鉴权。 它生成的MD5 加密算法如下： 原始端认证号码＝原始端设备ID+共享密钥+时间戳 共享的密钥部分由VAC分配，5
SourceDevice_ID Octet String 20 DestinationDevice_Type DestinationDevice_ID Integer4 Octet String 4 20 Check_Source Octet String 16