中国联通增值业务鉴权中心接口规范VAC与SP接口规范.doc

中国联通公司发布××××-××-××实施××××-××-××发布中国联通VAC平台接口技术要求：VAC与SP接口规范（暂定名）（V1.1）QB/CU ×××××××中国联通公司企业标准6目 次修改记录II前 言III1 范围42 规范性引用文件43 定义与缩略语43.1 定义43.2 缩略语43.3 信息更新时机定义54 VAC和SP间的接口54.1 定购通知接口54.1.1 接口描述54.1.2 发起方系统54.1.3 接受方系统54.1.4 接口协议54.1.5 接口内容54.1.5.1 订购关系通知SP请求（OrderRelationUpdateNotifyReq）54.1.5.2 订购关系通知SP响应（OrderRelationUpdateNotifyRsp）64.2 定购关系同步接口64.2.1 接口描述64.2.2 发起方系统74.2.3 接受方系统74.2.4 接口协议74.2.5 接口内容74.2.5.1 请求文件头（定长）74.2.5.2 文件体74.2.6 过渡阶段定制关系变更通知SP通用流程8修改记录文件编号版本号拟制人/修改人拟制/修改日期更改理由主要更改内容（写要点即可）封面V1.12008-12-18版本号修改从1.0改为1.14.1.3增加本节2009-2-14增加Time_Stamp、EncodeStr，对订购关系进行加密，保持数据安全性4.1.5.1订购关系通知SP请求（OrderRelationUpdateNotifyReq）4.2.5.1请求文件头（定长）2009-2-14增加接口约束4.2.1接口描述注1：每次更改归档文件时，需填写此表。注2：文件第一次归档时，“更改理由”、“主要更改内容”栏写“无”。前 言本标准是中国联通增值业务鉴权中心系列标准之一，本系列标准的预期结构如下：中国联通增值业务鉴权中心（VAC）技术体制本标准将根据业务的开展情况与市场需求，适时进行修改。本标准由中国联通公司增值业务部提出。本标准由中国联通公司技术部归口。本标准主要起草单位：中讯邮电咨询设计院，中国联通增值业务部本标准主要起草人：×××本标准的修改和解释权属中国联通公司。中国联通增值业务鉴权中心接口技术要求：VAC平台与SP接口规范（V1.1）1 范围本标准规定了中国联通VAC与SP之间的接口。适用于联通、省分公司和厂家进行VAC和SP系统互联建设的研制、开发和实施，是中国联通VAC、SP接入规划和建设的基本依据。2 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。3 定义与缩略语3.1 定义本标准采用以下定义：1) 业务：业务是一定的内容和/或服务能力的聚合。业务名称是用户用以识别不同的增值业务的标识。在管理上，业务是服务提供商与运营商进行审核管理和分成结算的对象。如“新浪酷图”业务。2) 业务能力：指基础增值服务，例如：邮件、消息、浏览、流媒体等，可以使用这些业务能力进行组合，构造出特定的业务，满足细分市场后的用户需求。3) 业务引擎：指实现各个业务能力的物理实体。4) 产品：产品是对业务的标价，是用户购买业务的方式，即用户使用业务所需要支付的价钱、支付的方式、以及其能够获得的使用额度。在VAC系统中，产品是订购、鉴权、和计费的对象，如“包月5元”。一个业务对应多个产品，一个产品唯一对应一个业务。5) 内容：内容是用户真正使用的对象，是在业务中提供的一个个实体，如“手机酷图”业务中的一个图片。6) 门户：指直接面对用户的界面。增值业务鉴权中心通过多种承载形式提供给用户多样化的操作能力，如业务订购、取消、查询、导购、帮助等。基于不同的承载形式，门户可以包括WAP门户、WEB门户、短信门户和语音门户。3.2 缩略语本标准采用以下缩略语：VACValue-added Service Platform增值业务鉴权中心AAAAuthentication Authorization Account认证授权计费BrewBinary Runtime Environment for Wireless无线二进制运行环境CDMACode Division Multiple Access码分多址DMDevice Management设备管理DRMDigital Right Management数字版权管理IMInstant Massage即时消息GSMGlobal System for Mobile communication全球移动通信系统GPRSGeneral Packet Radio Service通用无线分组业务LCSLocation Services定位业务MMSMultimedia Messaging Service多媒体消息服务OTAOver the Air空中下载PIMPersonal Information Management个人信息管理PoCPTT over the Cellular基于蜂窝网的PTT业务PTTPush to Talk一按即说SLAService Level Agreement服务品质协议SPService Provider服务提供商SSGService Select Gateway业务选择网关TTSText-To-Speech文本语音转换WAPWireless Application Protocol无线应用协议3.3 信息更新时机定义- 对于新增的CP/SP，当第一次转为测试状态，第一次转为商用状态时，分别需要更新一次；- 对于已有CP/SP，信息发生变化时，需要更新；除以上两种情况外，BSS不能向VAC传递CP/SP信息。4 VAC和SP间的接口4.1 定购通知接口4.1.1 接口描述用户订购关系发生变化时以及用户点播SP业务时，VAC通过此接口实时通知SP。批开、批退时不采用此接口通知SP，通过FTP订购关系同步接口通知SP。通知失败时，根据配置，VAC可进行重试，重试失败则记录日志，之后通过FTP订购关系同步接口进行补偿。为减少SP改造的工作量，保留原联通在信平台SGIP与WAP平台（总部）Http两种通知SP的方式， SP可以从三种方式中选择任意一种。4.1.2 发起方系统VAC。4.1.3 接受方系统SP。4.1.4 接口协议该接口采用Web Service方式。4.1.5 接口内容4.1.5.1 订购关系通知SP请求（OrderRelationUpdateNotifyReq）参数名类型大小描述RecordSequenceIDstring18流水号, UserIdTypeinteger4用户ID类型1: MSISDN2: PsedoCodeUserIdstring36用户手机号码或伪码UserIdType填1 为手机号码UserIdType填2 为伪码ServiceTypeString2业务类型,见附录SpIdstring21SP标识ProductIdstring21产品标识（此为SP在PRM侧申请的SP_Productid）UpdateTypeinteger4更新操作的类型包括：1：订购2：取消订购3：点播UpdateTimestring14更新时间UpdateDescstring100更新操作的详细描述，默认为空LinkIDstring20事务关联ID，用于点播业务的临时定购关系关联，由平台产生。格式如下：MMDDHHMMSS+10位随机序列号；为空表示无效。用户点播时使用。Contentstring140内容EffectiveDatestring14订购关系生效时间, 格式：yyyyMMddhhmmssExpireDatestring14订购关系失效时间, 格式：yyyyMMddhhmmssTime_Stampstring10时间戳由VAC生成,格式是: MMDDHHMMSS，月日时分秒。EncodeStrstring32采用32位的MD5加密串,以便SP鉴权定购关系来源的合法性, MD5 加密算法如下:EncodeStr=UserId+共享密钥+ ProductId+ Time_Stamp共享密钥由SP分配,时间戳由VAC设备生成，格式是：MMDDHHMMSS，月日时分秒。共享密钥的定义见BSS与VAC接口规范SP属性接口OrderKey如果SP的OrderKey为空,VAC不加密4.1.5.2 订购关系通知SP响应（OrderRelationUpdateNotifyRsp）参数名类型字节大小描述RecordSequenceIDstring18流水号，与OrderRelationUpdateNotifyReq的流水号相同ResultCode integer4结果识别码0: 成功1. 失败4.2 定购关系同步接口4.2.1 接口描述该接口用于VAC与SP每天稽核增量订购关系。包括批量定购和退订。VAC将每天增量文件放到VAC为SP提供的文件服务器的目录下。双方通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。VAC为SP分配具有读写文件权限的用户和密码。系统于每天凌晨1：00进行稽核文件资料同步。资料同步周期应具有根据最新规定进行可调的能力。文件采用GBK编码格式,文件体不定长，文件体各属性间使用t分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。文件体中一行作为一条记录，各条记录之间用换行符n作为分隔并在文件中连续书写。文件头定长，各属性间无分隔符。文件的维护由VAC负责。4.2.2 发起方系统VAC。4.2.3 接受方系统SP。4.2.4 接口协议FTP 文件。4.2.5 接口内容文件目录<根目录>/VAC/SubscribeInfo/<SPID>/文件命名: SubscribeInfo+SPID+yyyyMMddHHmm+xxx+nnnn.txtSPID 八位，不足八位，左补零文件产生的时间（12位yyyyMMddHHmm精确到年月日时分）xxx为省分代码。nnnn 是4位序列号，每天从“0001”开始，到达”9999”后又从“0001”开始。4.2.5.1 请求文件头（定长）序号属性名长度备注1文件序列号(流水号)CHAR(4)0001开始，排满9999后重新循环2版本信息CHAR(5)缺省：000003文件产生时间CHAR(14)yyyymmddhhmmss4文件生成方系统代码CHAR(3)9025记录开始日期时间CHAR(14)yyyymmddhhmmss6记录结束日期时间CHAR(14)yyyymmddhhmmss7总记录数CHAR(10)8备用CHAR(40)9换行CHAR(1)4.2.5.2 文件体参数名类型大小描述RecordSequenceIDstring18流水号, UserIdTypeinteger4用户ID类型1: MSISDN2: PsedoCodeUserIdstring36用户手机号码或伪码UserIdType填1 为手机号码UserIdType填2 为伪码ServiceTypeString2业务类型,见附录A7SpIdstring21SP标识ProductIdstring21产品标识（此为SP在PRM侧申请的SP_Productid）UpdateTypeinteger4更新操作的类型包括：1：订购2：取消订购3：点播UpdateTimestring14更新时间UpdateDescstring100更新操作的详细描述，默认为空LinkIDstring20事务关联ID，用于点播业务的临时定购关系关联，由平台产生。格式如下：MMDDHHMMSS+10位随机序列号；为空表示无效。用户点播时使用。Contentstring140内容EffectiveDatestring14订购关系生效时间, 格式：yyyyMMddhhmmssExpireDatestring14订购关系失效时间, 格式：yyyyMMddhhmmssTime_Stampstring10时间戳由VAC生成,格式是: MMDDHHMMSS，月日时分秒。EncodeStrstring32采用32位的MD5加密串,以便SP鉴权定购关系来源的合法性, MD5 加密算法如下:EncodeStr=UserId+共享密钥+ ProductId+ Time_Stamp共享密钥由SP分配,时间戳由VAC设备生成，格式是：MMDDHHMMSS，月日时分秒。共享密钥的定义见BSS与VAC接口规范SP属性接口OrderKey如果SP的OrderKey为空,VAC不加密4.2.6 过渡阶段定制关系变更通知SP通用流程在信通知SP方式1、 鉴权中心向SP转发定制消息Noti_ToSP，包体内容为用户订制MO消息, 带上LinkID2、 网关转发消息给SP3、 SP收到包进行订制处理（SP端订制成功）；SP向用户下发成功定制消息, MT消息中带上LinkID，业务代码填写相应订制业务的业务代码4、 SMG将订制通知包封装为鉴权包后发给鉴权中心5、 鉴权中心判断是SP回复消息,做相应鉴权6、 鉴权中心回复成功(100)给网关,网关不下发