中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册(V1.1)
时间戳由发端设备生成,格式是:MMDDHHMMSS,月日时分秒。共享密钥的最大长度是40 字节 Time_Stamp Octet String 10 时间戳由原始端设备生成,格式是:MMDDHHMMSS,月日时分秒。 协议版本, 采用100标识1.00,126标识1.26。 Version Integer4 4 2) BindResp连接应答 方向 : VAC->业务系统/业务引擎
BindResp连接应答消息中包含的参数如下: 字段名称 Result_Code 类型 Integer4 长度(字节) 描述 4 结果码如下: 0:成功 1:帐户错误 2:密码错误 3:原始端设备类型非法 4:原始端设备ID 号非法 5:目标端设备类型非法 6:目标设备ID 非法 7:重复的连接请求
4.1.4.2 去连接消息
该消息提供给VAC 一个安全的断链过程以清除资源。
1) Unbind 去连接请求 方向 : 业务系统/业务引擎->VAC
Unbind 去连接请求消息中不包含任何参数 字段名称 类型 长度(字节) 描述 2) UnbindRspone去连接应答
方向 : VAC->业务系统/业务引擎
UnbindRspone去连接应答消息中包含的参数如下: 字段名称 ResultCode 类型 Integer4 长度(字节) 描述 4 结果码: 0:成功 8:没有连接
4.1.4.3 链路握手消息
该消息用于维持VAC和业务业务系统/业务引擎之间的TCP 连接。
1) Handset链路握手请求 方向 : 业务系统/业务引擎<->VAC 链路握手消息中不包含任何参数。
6
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册(V1.1)
字段名称 类型 长度(字节) 描述 2) HandsetResp链路握手应答
方向 : 业务系统/业务引擎<->VAC
HandsetResp链路握手应答消息中不包含任何参数。 字段名称 类型 长度(字节) 描述 4.1.4.4 鉴权批价
鉴权批价消息是一个复合操作,包括了用户鉴权、业务鉴权、定购关系鉴权、计费等操作的功能。
1) CheckPrice鉴权批价请求 方向 : 业务系统/业务引擎 -> VAC
CheckPrice鉴权批价请求消息中包含的参数如下:
字段名称 类型 长度/最描述 大长度(字节) 4 20 发送端设备类型,参考附录B 发送端设备标识,定义为“2位设备类型+3位省分代码+1位序列号” 2位设备类型见vac与增值系统规范附录B, 3位省分代码见VAC与BSS规范附录A.16 目标设备类型 目标设备标识,定义为“2位设备类型+3位省分代码+1位序列号” 2位设备类型见vac与增值系统规范附录B, 3位省分代码见VAC与BSS规范附录A.16 业务系统/业务引擎生成的唯一识别标识。标识多个请求是属于同一个事务。 SequenceNumber是消息生成时间、业务系统标识和序列号的组合,其格式为: MMDDHHMMSSYYYYYYXXXX,其中 MMDDHHMMSS:当前时间 7
SourceDevice_Type SourceDevice_ID Integer4 Octet String DestinationDevice_Type DestinationDevice_ID Integer4 Octet String 4 20 SequenceNumber Octet String 20
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册(V1.1)
YYYYYY:业务系统标识,编码方式为: Y1Y2Y3Y4Y5Y6:Y1Y2,设备类型,Y3Y4Y5,三位省份代码,Y6,设备序列号 XXXX:序列号 VAC对编码本身不做鉴权,但要保证SequenceNumber的唯一性 OA_Type OANetwork_ID OA DA_Type DANetwork_ID DA FAType Integer4 Octet String 4 10 业务发起端地址类型,参考附录B 业务发起端用户归属网络标识。如:WCDMA、GSM等 业务发起端地址。填写手机号码 目标地址类型,参见附录B 目标端用户归属网络标识。如:WCDMA、GSM等 目标地址。填写手机号码 付费地址类型,填1。保留作为以后可以独立设定付费方时使用。参考附录B 付费用户归属的网络标识。保留作为以后可以独立设定付费方时使用。 付费地址。填手机号码。保留作为以后可以独立设定付费方时使用。 1:SPID+ServiceID 3:SPID+SP_ProductID 5: SPID+SPEC_ProductID 填写企业代码 ServiceIDType 为1时填写ServiceID 为3时填写SP_ProductID 为5时填写SPEC_ProductID(业务部件能知晓用户定购或点播CRM的产品构成) CRM产品ID, ServiceIDType为5时有效,其他填8个空格 业务上下行类型: 1: MOAT
Octet String 36 Integer4 Octet String 4 10 Octet String 36 Integer4 4 FANetwork_ID Octet String 10 FA Octet String 36 ServiceIDType Integer4 4 SP_ID ServiceID/FeatureString Octet String Octet String 21 21 ProductID Octet String 8 Service_updown_Type Integer4 8 4 中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册(V1.1)
2: AOMT 3: MOMT 终端到终端 4、P TO E,终端到邮箱 9: 其它 vac对彩信p to e、sp彩信、在信、wap push业务需要判断具体取值,对其他业务不鉴权本字段 Begin_Time ResentTimes Octet String Integer1 14 1 开始时间YYYYMMDDHHMMSS 年月日时分秒 重发次数: 0:只发一次 1-255:重发次数 默认取值0 0、鉴权计费 ServiceIDType=1时,如果请求中有LinkID,进行点播关系鉴权,无LinkID,进行订购关系鉴权, 鉴权通过则进行计费。 1、定购ServiceIDType必须为3 2、退定 ServiceIDType必须为3 3、退定ServiceType对应的所有业务(终端侧不能单独退订业务除外): ServiceIDType必须为3 4、点播:业务平台能判断是点播,直接填4 6、定购关系鉴权(用于检查用户是否订购了此业务) 7、屏蔽业务能力 8、恢复业务能力 业务类型,见VAC与BSS接口规范附录A 7 当Operation Type=1、2、3、4时,VAC不对鉴权发起方的业务类型与产品的业务类型进行比较鉴权 20 9
Operation Type Integer4 4 ServiceType Octet String 2 可选参数 LinkID TLV 事务关联ID,点播业务的事务关联,由AAA产生。格式
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册(V1.1)
如下:8位随机序列数; 为空(二进制0)表示无效 SMSFormat TLV 4 短信内容格式 0:ASCII串 3:短信写卡操作 4:二进制信息 8:UCS2编码 15:含GB汉字 …… 短信内容长度 短信内容(短信上行过程短信网关需要将内容发送给平台分析) CP代码 内容代码 订购渠道,取值见VAC与BSS接口规范附录,在定购时业务系统必须填写 营销方式,推荐方ID 计费类型,该字段不能为空。 0:不计费,仅用于核减SP对称的信道费; 1:免费 2:按条/次计费 3:按包月收取 4:封顶计费 5:按流量计费 6:按时长计费 7:包多月计费 单位,分。 增值系统不批价的不带fee字段,同时VAC侧支持按照业务类型进行配置是否批价处理。 对代收费业务fee、FeeType必须正确填写(FeeType只能填2、3),如本字段为空,返回3002错误。 用户联通在信、彩信等接入号,对在信类、彩信类业务必须填写 SMSContentLen SMSContent TLV TLV 4 SMSContentLen 8 22 4 CPID ContentID OrderMethod TLV TLV TLV PushId FeeType TLV TLV 20 2 fee TLV 8 AccessNo TLV 21
注:(1)当Operation Type=7时,VAC取消ServiceType对应的终端侧能单独退订的所有订购关系并立即失效,并关闭该ServiceType对应用户业务能力;后续业务平台发起关于该ServiceType的相关鉴
10