中國聯(lián)通增值業(yè)務(wù)鑒權(quán)中心接口規(guī)范VAC與SP接口規(guī)范

1、中國聯(lián)通公司發(fā)布-實施-發(fā)布中國聯(lián)通vac平臺接口技術(shù)要求：vac與sp接口規(guī)范（暫定名）（v1.1）qb/cu 中國聯(lián)通公司企業(yè)標(biāo)準(zhǔn)6目 次修改記錄ii前 言iii1 范圍42 規(guī)范性引用文件43 定義與縮略語43.1 定義43.2 縮略語43.3 信息更新時機(jī)定義54 vac和sp間的接口54.1 定購?fù)ㄖ涌?4.1.1 接口描述54.1.2 發(fā)起方系統(tǒng)54.1.3 接受方系統(tǒng)54.1.4 接口協(xié)議54.1.5 接口內(nèi)容 訂購關(guān)系通知sp請求（orderrelationupdatenotifyreq） 訂購關(guān)系通知sp響應(yīng)（orderrelationupd

2、atenotifyrsp）64.2 定購關(guān)系同步接口64.2.1 接口描述64.2.2 發(fā)起方系統(tǒng)74.2.3 接受方系統(tǒng)74.2.4 接口協(xié)議74.2.5 接口內(nèi)容 請求文件頭（定長） 文件體74.2.6 過渡階段定制關(guān)系變更通知sp通用流程8修改記錄文件編號版本號擬制人/修改人擬制/修改日期更改理由主要更改內(nèi)容（寫要點即可）封面v1.12008-12-18版本號修改從1.0改為增加本節(jié)2009-2-14增加time_stamp、encodestr，對訂購關(guān)系進(jìn)行加密，保持?jǐn)?shù)據(jù)安全性訂購關(guān)系通知sp請求（orderrelation

3、updatenotifyreq）請求文件頭（定長）2009-2-14增加接口約束4.2.1接口描述注1：每次更改歸檔文件時，需填寫此表。注2：文件第一次歸檔時，“更改理由”、“主要更改內(nèi)容”欄寫“無”。前 言本標(biāo)準(zhǔn)是中國聯(lián)通增值業(yè)務(wù)鑒權(quán)中心系列標(biāo)準(zhǔn)之一，本系列標(biāo)準(zhǔn)的預(yù)期結(jié)構(gòu)如下：中國聯(lián)通增值業(yè)務(wù)鑒權(quán)中心（vac）技術(shù)體制本標(biāo)準(zhǔn)將根據(jù)業(yè)務(wù)的開展情況與市場需求，適時進(jìn)行修改。本標(biāo)準(zhǔn)由中國聯(lián)通公司增值業(yè)務(wù)部提出。本標(biāo)準(zhǔn)由中國聯(lián)通公司技術(shù)部歸口。本標(biāo)準(zhǔn)主要起草單位：中訊郵電咨詢設(shè)計院，中國聯(lián)通增值業(yè)務(wù)部本標(biāo)準(zhǔn)主要起草人：本標(biāo)準(zhǔn)的修改和解釋權(quán)屬中國聯(lián)通公司。中國聯(lián)通增值業(yè)務(wù)鑒權(quán)中心接口技術(shù)

4、要求：vac平臺與sp接口規(guī)范（v1.1）1 范圍本標(biāo)準(zhǔn)規(guī)定了中國聯(lián)通vac與sp之間的接口。適用于聯(lián)通、省分公司和廠家進(jìn)行vac和sp系統(tǒng)互聯(lián)建設(shè)的研制、開發(fā)和實施，是中國聯(lián)通vac、sp接入規(guī)劃和建設(shè)的基本依據(jù)。2 規(guī)范性引用文件下列文件中的條款通過本標(biāo)準(zhǔn)的引用而成為本標(biāo)準(zhǔn)的條款。凡是注日期的引用文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于本標(biāo)準(zhǔn)，然而，鼓勵根據(jù)本標(biāo)準(zhǔn)達(dá)成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本標(biāo)準(zhǔn)。3 定義與縮略語3.1 定義本標(biāo)準(zhǔn)采用以下定義：1) 業(yè)務(wù)：業(yè)務(wù)是一定的內(nèi)容和/或服務(wù)能力的聚合。業(yè)務(wù)名稱是用戶

5、用以識別不同的增值業(yè)務(wù)的標(biāo)識。在管理上，業(yè)務(wù)是服務(wù)提供商與運營商進(jìn)行審核管理和分成結(jié)算的對象。如“新浪酷圖”業(yè)務(wù)。2) 業(yè)務(wù)能力：指基礎(chǔ)增值服務(wù)，例如：郵件、消息、瀏覽、流媒體等，可以使用這些業(yè)務(wù)能力進(jìn)行組合，構(gòu)造出特定的業(yè)務(wù)，滿足細(xì)分市場后的用戶需求。3) 業(yè)務(wù)引擎：指實現(xiàn)各個業(yè)務(wù)能力的物理實體。4) 產(chǎn)品：產(chǎn)品是對業(yè)務(wù)的標(biāo)價，是用戶購買業(yè)務(wù)的方式，即用戶使用業(yè)務(wù)所需要支付的價錢、支付的方式、以及其能夠獲得的使用額度。在vac系統(tǒng)中，產(chǎn)品是訂購、鑒權(quán)、和計費的對象，如“包月5元”。一個業(yè)務(wù)對應(yīng)多個產(chǎn)品，一個產(chǎn)品唯一對應(yīng)一個業(yè)務(wù)。5) 內(nèi)容：內(nèi)容是用戶真正使用的對象，是在業(yè)務(wù)中提供的一個個實體

6、，如“手機(jī)酷圖”業(yè)務(wù)中的一個圖片。6) 門戶：指直接面對用戶的界面。增值業(yè)務(wù)鑒權(quán)中心通過多種承載形式提供給用戶多樣化的操作能力，如業(yè)務(wù)訂購、取消、查詢、導(dǎo)購、幫助等?；诓煌某休d形式，門戶可以包括wap門戶、web門戶、短信門戶和語音門戶。3.2 縮略語本標(biāo)準(zhǔn)采用以下縮略語：vacvalue-added service platform增值業(yè)務(wù)鑒權(quán)中心aaaauthentication authorization account認(rèn)證授權(quán)計費brewbinary runtime environment for wireless無線二進(jìn)制運行環(huán)境cdmacode division multipl

7、e access碼分多址dmdevice management設(shè)備管理drmdigital right management數(shù)字版權(quán)管理iminstant massage即時消息gsmglobal system for mobile communication全球移動通信系統(tǒng)gprsgeneral packet radio service通用無線分組業(yè)務(wù)lcslocation services定位業(yè)務(wù)mmsmultimedia messaging service多媒體消息服務(wù)otaover the air空中下載pimpersonal information management個人信息管理p

8、ocptt over the cellular基于蜂窩網(wǎng)的ptt業(yè)務(wù)pttpush to talk一按即說slaservice level agreement服務(wù)品質(zhì)協(xié)議spservice provider服務(wù)提供商ssgservice select gateway業(yè)務(wù)選擇網(wǎng)關(guān)ttstext-to-speech文本語音轉(zhuǎn)換wapwireless application protocol無線應(yīng)用協(xié)議3.3 信息更新時機(jī)定義- 對于新增的cp/sp，當(dāng)?shù)谝淮无D(zhuǎn)為測試狀態(tài)，第一次轉(zhuǎn)為商用狀態(tài)時，分別需要更新一次；- 對于已有cp/sp，信息發(fā)生變化時，需要更新；除以上兩種情況外，bss不能向vac傳

9、遞cp/sp信息。4 vac和sp間的接口4.1 定購?fù)ㄖ涌?.1.1 接口描述用戶訂購關(guān)系發(fā)生變化時以及用戶點播sp業(yè)務(wù)時，vac通過此接口實時通知sp。批開、批退時不采用此接口通知sp，通過ftp訂購關(guān)系同步接口通知sp。通知失敗時，根據(jù)配置，vac可進(jìn)行重試，重試失敗則記錄日志，之后通過ftp訂購關(guān)系同步接口進(jìn)行補償。為減少sp改造的工作量，保留原聯(lián)通在信平臺sgip與wap平臺（總部）http兩種通知sp的方式， sp可以從三種方式中選擇任意一種。4.1.2 發(fā)起方系統(tǒng)vac。4.1.3 接受方系統(tǒng)sp。4.1.4 接口協(xié)議該接口采用web service方式。4.1.5 接口內(nèi)容4

10、.1.5.1 訂購關(guān)系通知sp請求（orderrelationupdatenotifyreq）參數(shù)名類型大小描述recordsequenceidstring18流水號, useridtypeinteger4用戶id類型1: msisdn2: psedocodeuseridstring36用戶手機(jī)號碼或偽碼useridtype填1 為手機(jī)號碼useridtype填2 為偽碼servicetypestring2業(yè)務(wù)類型,見附錄spidstring21sp標(biāo)識productidstring21產(chǎn)品標(biāo)識（此為sp在prm側(cè)申請的sp_productid）updatetypeinteger4更新操作的類

11、型包括：1：訂購2：取消訂購3：點播updatetimestring14更新時間updatedescstring100更新操作的詳細(xì)描述，默認(rèn)為空linkidstring20事務(wù)關(guān)聯(lián)id，用于點播業(yè)務(wù)的臨時定購關(guān)系關(guān)聯(lián)，由平臺產(chǎn)生。格式如下：mmddhhmmss+10位隨機(jī)序列號；為空表示無效。用戶點播時使用。contentstring140內(nèi)容effectivedatestring14訂購關(guān)系生效時間, 格式：yyyymmddhhmmssexpiredatestring14訂購關(guān)系失效時間, 格式：yyyymmddhhmmsstime_stampstring10時間戳由vac生成,格式是:

12、mmddhhmmss，月日時分秒。encodestrstring32采用32位的md5加密串,以便sp鑒權(quán)定購關(guān)系來源的合法性, md5 加密算法如下:encodestr=userid+共享密鑰+ productid+ time_stamp共享密鑰由sp分配,時間戳由vac設(shè)備生成，格式是：mmddhhmmss，月日時分秒。共享密鑰的定義見bss與vac接口規(guī)范sp屬性接口orderkey如果sp的orderkey為空,vac不加密 訂購關(guān)系通知sp響應(yīng)（orderrelationupdatenotifyrsp）參數(shù)名類型字節(jié)大小描述recordsequenceidstring1

13、8流水號，與orderrelationupdatenotifyreq的流水號相同resultcode integer4結(jié)果識別碼0: 成功1. 失敗4.2 定購關(guān)系同步接口4.2.1 接口描述該接口用于vac與sp每天稽核增量訂購關(guān)系。包括批量定購和退訂。vac將每天增量文件放到vac為sp提供的文件服務(wù)器的目錄下。雙方通過文件傳輸實現(xiàn)接口。文件服務(wù)器上設(shè)定具有對相應(yīng)目錄存取權(quán)限的用戶。vac為sp分配具有讀寫文件權(quán)限的用戶和密碼。系統(tǒng)于每天凌晨1：00進(jìn)行稽核文件資料同步。資料同步周期應(yīng)具有根據(jù)最新規(guī)定進(jìn)行可調(diào)的能力。文件采用gbk編碼格式,文件體不定長，文件體各屬性間使用t分隔，在生成記錄

14、時若相應(yīng)的屬性值為空，直接用分隔符隔開，分隔符之間無其他符號。文件體中一行作為一條記錄，各條記錄之間用換行符n作為分隔并在文件中連續(xù)書寫。文件頭定長，各屬性間無分隔符。文件的維護(hù)由vac負(fù)責(zé)。4.2.2 發(fā)起方系統(tǒng)vac。4.2.3 接受方系統(tǒng)sp。4.2.4 接口協(xié)議ftp 文件。4.2.5 接口內(nèi)容文件目錄/vac/subscribeinfo/文件命名: subscribeinfo+spid+yyyymmddhhmm+xxx+nnnn.txtspid 八位，不足八位，左補零文件產(chǎn)生的時間（12位yyyymmddhhmm精確到年月日時分）xxx為省分代碼。nnnn 是4位序列號，每天從“00

15、01”開始，到達(dá)”9999”后又從“0001”開始。 請求文件頭（定長）序號屬性名長度備注1文件序列號(流水號)char(4)0001開始，排滿9999后重新循環(huán)2版本信息char(5)缺?。?00003文件產(chǎn)生時間char(14)yyyymmddhhmmss4文件生成方系統(tǒng)代碼char(3)9025記錄開始日期時間char(14)yyyymmddhhmmss6記錄結(jié)束日期時間char(14)yyyymmddhhmmss7總記錄數(shù)char(10)8備用char(40)9換行char(1) 文件體參數(shù)名類型大小描述recordsequenceidstring18流水號

16、, useridtypeinteger4用戶id類型1: msisdn2: psedocodeuseridstring36用戶手機(jī)號碼或偽碼useridtype填1 為手機(jī)號碼useridtype填2 為偽碼servicetypestring2業(yè)務(wù)類型,見附錄a7spidstring21sp標(biāo)識productidstring21產(chǎn)品標(biāo)識（此為sp在prm側(cè)申請的sp_productid）updatetypeinteger4更新操作的類型包括：1：訂購2：取消訂購3：點播updatetimestring14更新時間updatedescstring100更新操作的詳細(xì)描述，默認(rèn)為空linkidst

17、ring20事務(wù)關(guān)聯(lián)id，用于點播業(yè)務(wù)的臨時定購關(guān)系關(guān)聯(lián)，由平臺產(chǎn)生。格式如下：mmddhhmmss+10位隨機(jī)序列號；為空表示無效。用戶點播時使用。contentstring140內(nèi)容effectivedatestring14訂購關(guān)系生效時間, 格式：yyyymmddhhmmssexpiredatestring14訂購關(guān)系失效時間, 格式：yyyymmddhhmmsstime_stampstring10時間戳由vac生成,格式是: mmddhhmmss，月日時分秒。encodestrstring32采用32位的md5加密串,以便sp鑒權(quán)定購關(guān)系來源的合法性, md5 加密算法如下:encodestr=userid+共享密鑰+ productid+ time_stamp共享密鑰由sp分配,時間戳由vac設(shè)備生成，格式是：mmddhhmmss，月日時分秒。共享密鑰的定義見bss與vac接口