廣東聯(lián)通聯(lián)通在信技術培訓文檔

1、廣東聯(lián)通在信技術培訓中國聯(lián)通有限公司廣東分公司sp管理系統(tǒng)介紹 sp管理系統(tǒng)結構 和短信網(wǎng)關旁路結構，對目前的系統(tǒng)結構沒有大影響 sp管理系統(tǒng)功能 規(guī)范sp的業(yè)務流程 訂制類業(yè)務需要用戶二次確認 用戶訂購關系統(tǒng)一保存，訂購關系以sp管理系統(tǒng)為準 對短信上、下行進行鑒權sp接入代理核心調(diào)度smg接入代理spsmg業(yè)務鑒權平臺業(yè)務鑒權平臺(鑒權中心)(鑒權中心)spspmsspmsspapspap短信門戶短信門戶(sp)(sp)sgipsgipspms系統(tǒng)體系結構系統(tǒng)體系結構sp管理系統(tǒng)（以下簡稱：spms）分為兩個部分，一部分是短信門戶，一部分是業(yè)務鑒權中心，它們與網(wǎng)關的關系如下圖：說明：spm

2、s和spsmg之間采用“旁路結構”，雙方共有兩個通訊通道。其中短信門戶以sp身份接入到spsmg網(wǎng)關（遵守sgip協(xié)議）；業(yè)務鑒權平臺以鑒權中心與spsmg網(wǎng)關通信（遵守業(yè)務鑒權協(xié)議spap）。spms系統(tǒng)體系結構系統(tǒng)體系結構網(wǎng)關“smg”與“spms的業(yè)務鑒權中心”，互為客戶端與服務器端，雙方以業(yè)務鑒權協(xié)議（spap）來完成業(yè)務鑒權操作處理上，網(wǎng)關smg是將所有包（狀態(tài)報告report除外），都必須強制通過spms（sp管理系統(tǒng)）。網(wǎng)關“smg”與“spms短信門戶”，通過sgip協(xié)議與smg通訊。通訊流程通訊流程對原有協(xié)議的修改 修改了sgip1.2協(xié)議，對submit和deliver包使

3、用了其中的reserve字段，用來存放linkid基本概念 命令字 sp制定的點播/訂制某個業(yè)務時用戶在手機上輸入命令格式 sp管理系統(tǒng)中命令字只能用a-z、a-z、0-9以及下劃線中劃線作為命令字，其他字符會作為命令字結束符。例如aaa#123，sp管理系統(tǒng)只截取aaa作為命令字 sp管理系統(tǒng)中命令字最大長度為12個字符 sp管理系統(tǒng)會將小寫命令字轉(zhuǎn)為大寫 系統(tǒng)保留命令字:0000/00000/114基本概念 業(yè)務代碼 又稱為計費代碼，是業(yè)務的標志，每個sp的業(yè)務代碼不能重復 每個業(yè)務必須定義一個業(yè)務代碼 點播類、訂制類業(yè)務代碼必須不同（視為兩個業(yè)務，不能混用） 最大12個字節(jié) 全部為大寫基

4、本概念 linkid 用于校驗sp下發(fā)的信息合法性，目前保存在sgip中的reserve字段中 linkid是8個字節(jié)字符格式 如果下發(fā)linkid為空的包，填寫數(shù)字0 對不足8位的在后面補二進制的0，不能補字符0基本概念 網(wǎng)上點播校驗碼 在用戶在sp網(wǎng)站點播過程用發(fā)送到用戶手機上的校驗字符串 用戶填寫此校驗碼到sp網(wǎng)站 sp網(wǎng)站將此校驗碼作為linkid下發(fā)基本概念 二次確認 指用戶在發(fā)送訂制命令字上行后，sp管理系統(tǒng)會攔截此請求，發(fā)送用戶訂購業(yè)務的資費說明，讓用戶確認訂購請求，用戶按提示重新發(fā)送訂制命令字確認后，系統(tǒng)會將用戶第二次上行的mo送spsp需要做的工作 業(yè)務的規(guī)范化整理 sp資料

5、的整理 sp應用程序的修改業(yè)務規(guī)范化整理 設定業(yè)務類型（訂制類/點播類） 每個業(yè)務必須申報，不能多個業(yè)務共用一個業(yè)務代碼 訂制類業(yè)務必須用戶訂制后才能給用戶下行，訂制sp可在用戶沒有上行的情況下下行，訂制類業(yè)務不允許第三方付費。 點播類業(yè)務必須用戶上行點播后才能下行，目前允許發(fā)送給第三方。 sp的每個業(yè)務必須設定一個唯一的業(yè)務代碼（計費代碼），業(yè)務代碼不區(qū)分大小寫，全部轉(zhuǎn)換為大寫業(yè)務規(guī)范化整理 命令字整理 每個業(yè)務必須申報命令字，點播類申報一個或多個點播命令字，訂制類申報一個訂制命令字和一個退訂命令字 error業(yè)務代碼不需要申報 命令字只能包含a-z和0-9字符，其他字符如空格和#等系統(tǒng)都認

6、為是命令字的結束符 每個sp的命令字必須唯一，全部為大寫，只能屬于一個業(yè)務 sp可申請#命令字通配符，此命令字通配符只能用于點播類業(yè)務，訂制類業(yè)務不能使用#命令字通配符。業(yè)務流程用戶使用手機網(wǎng)上使用點播訂制查詢退訂sp網(wǎng)站spms網(wǎng)站點播訂制查詢退訂查詢退訂訂制 所有sp業(yè)務 某sp業(yè)務業(yè)務流程mo方式點播業(yè)務方式點播業(yè)務 用戶發(fā)起mo業(yè)務點播請求 spms生成點播關系及l(fā)inkid sp在下發(fā)的submit包中填寫對應deliver包中的linkid spms根據(jù)linkid及點播關系進行鑒權業(yè)務流程mo方式訂制業(yè)務方式訂制業(yè)務 用戶發(fā)起業(yè)務訂制請求 spms生成臨時訂制關系，向用戶下發(fā)訂制

7、確認短信 用戶重新回復命令字確認訂制 spms轉(zhuǎn)發(fā)deliver包給sp（帶linkid） sp下發(fā)訂制成功/失敗通知包給用戶(需要帶linkid，失敗通知包用業(yè)務代碼error下發(fā)，此業(yè)務代碼不用申報) spms根據(jù)通知包生成正式訂制關系 sp根據(jù)訂制規(guī)則向用戶下發(fā)業(yè)務消息（不帶linkid） spms根據(jù)用戶訂制關系進行鑒權。業(yè)務流程momo方式退訂業(yè)務方式退訂業(yè)務 用戶發(fā)起業(yè)務退訂請求 spms退訂用戶業(yè)務，轉(zhuǎn)發(fā)deliver包給sp（帶linkid） sp到deliver包，進行退訂處理業(yè)務流程用戶在用戶在web上注冊上注冊sp社區(qū)用戶社區(qū)用戶 用戶在web上注冊sp社區(qū)用戶 sp調(diào)用

8、spms點播接口，掛起用戶請求，等待用戶輸入校驗碼 spms向用戶下發(fā)校驗碼短信 用戶收到校驗碼短信，在web上輸入校驗碼 sp向用戶下發(fā)密碼通知消息，將用戶輸入的校驗碼填在linkid字段 spms根據(jù)校驗碼及點播關系進行鑒權 用戶使用sp下發(fā)的密碼登錄sp社區(qū)業(yè)務流程web方式點播業(yè)務方式點播業(yè)務 用戶登錄sp社區(qū) 用戶在網(wǎng)上點播業(yè)務 sp調(diào)用spms點播接口，掛起用戶請求，等待用戶輸入校驗碼 spms向用戶下發(fā)校驗碼短信 用戶收到校驗碼短信，在web上輸入校驗碼 sp下發(fā)點播消息，將用戶輸入的校驗碼填在submit包linkid字段 spms根據(jù)校驗碼及點播關系進行鑒權業(yè)務流程web方式

9、訂制業(yè)務方式訂制業(yè)務用戶在web上發(fā)起業(yè)務訂制請求sp調(diào)用spms提供的訂制接口spms生成臨時訂制關系，向用戶下發(fā)訂制確認短信，提示用戶發(fā)送命令字到sp接入號用戶發(fā)送命令字mo確認訂制spms發(fā)deliver包給sp（帶linkid）sp下發(fā)訂制成功/失敗通知包用戶(需要帶linkid，失敗通知包用業(yè)務代碼error下發(fā)，此業(yè)務代碼不用申報)spms根據(jù)通知包生成正式訂制關系sp根據(jù)訂制規(guī)則向用戶下發(fā)業(yè)務消息（不帶linkid）spms根據(jù)用戶訂制關系進行鑒權業(yè)務流程web方式退訂業(yè)務方式退訂業(yè)務 用戶在web上發(fā)起業(yè)務退訂請求 sp調(diào)用spms提供的業(yè)務訂制接口 spms退訂用戶業(yè)務，轉(zhuǎn)發(fā)

10、deliver包給sp（帶linkid） sp到deliver包，進行退訂處理業(yè)務流程中的常見問題 長號碼 sp管理系統(tǒng)支持長號碼的上下行，但sp申報業(yè)務是必須全以短號碼申報 sp管理系統(tǒng)中上下行不匹配長號碼，全部以短號碼進行匹配。例如8000接入號和80001長號碼下行的業(yè)務代碼aaa會認為是一個業(yè)務，而不是兩個業(yè)務 web訂制和點播接口調(diào)用時只能使用短號碼 訂制業(yè)務時的二次確認，用戶收到的提示是發(fā)送命令字到短號碼業(yè)務流程中的常見問題 命令字的設計 業(yè)務命令字的命名最好避免一些有歧義性的東西，特別是對一些需要用戶回復的業(yè)務。比如某sp申報某業(yè)務a的訂制命令字申請為“ok“，而該sp恰好有一個

11、業(yè)務b可能需要用戶的回復（比如聊天類或者游戲互動類）。業(yè)務b的訂制用戶在聊天后者游戲過程中可能回復ok表示某種意思，由于該回復恰好又是業(yè)務a的訂制命令字，這樣鑒權系統(tǒng)就會認為該mo是一個訂制業(yè)務a的請求而不是普通的回復mo，sp也就收不到該回復的mo了，影響業(yè)務運行。業(yè)務流程中的常見問題 命令字參數(shù)的設計 對于某些需要在命令字中上行參數(shù)的業(yè)務，建議sp采用命令字+空格或者#+參數(shù)的方式來開展業(yè)務。如分地區(qū)的天氣預報業(yè)務，將命令字定義為tq,用戶發(fā)送tq#020或者tq 020來進行訂制業(yè)務流程中的常見問題 訂購流程 訂購關系的建立以sp端下發(fā)對應上行訂購業(yè)務代碼且linkid和上行l(wèi)inkid

12、相匹配的mt為訂購成功標志。如果sp下發(fā)error業(yè)務代碼且linkid與上行l(wèi)inkid相匹配的mt，則sp管理系統(tǒng)不會建立訂購關系。 建立訂購關系那條mt必須填寫和用戶訂制請求mo相同的業(yè)務代碼和linkid。在訂購關系成功建立后，sp下發(fā)的此訂制類業(yè)務信息和包月話單不需要填寫linkid（業(yè)務代碼必須和用戶訂制的一致）業(yè)務流程中的常見問題 點播流程 點播類業(yè)務sp可申請命令字為#的業(yè)務，此命令字表示可匹配用戶上行的任何命令字。（只能在點播類使用#命令字通配符） 點播類業(yè)務的下發(fā)必須有用戶的點播上行，必須填寫用戶點播上行mo中的linkid 一條用戶上行的mo中的linkid可在多條對應下

13、行的mt中使用（mo對應的最大mt數(shù)量現(xiàn)統(tǒng)一為10條）業(yè)務流程中的常見問題 sp訂制/點播mo包處理失敗的通知下發(fā) 對于用戶上行的訂制/點播mo包，如果sp端處理失敗，可使用平臺提供的統(tǒng)一業(yè)務代碼 error 下發(fā)通知消息給用戶（此業(yè)務代碼不需要申請） 該業(yè)務代碼所對應的信息費資費必須為0，付費號碼必須填寫21個字符0（sp支付通道費） 業(yè)務流程中的常見問題 資費 sp管理系統(tǒng)檢查時允許資費小于或等于申報資費的mt下發(fā)。 如果mt資費大于sp申報的值，sp管理系統(tǒng)會對在返回錯誤后生成一個資費等于sp申報資費的mt下發(fā)。（此違規(guī)行為將會反映到統(tǒng)計日志中）業(yè)務流程中的常見問題 計費方法 點播類業(yè)務

14、支持按條付費 訂制類業(yè)務支持包月計費和按條計費業(yè)務流程中的常見問題 包月話單的下發(fā) sp的包月話單在每月10號后下發(fā) 用戶訂購小于3天（72小時）時，不能下發(fā)包月話單 包月話單通知到用戶手機功能目前暫不實施業(yè)務流程中的常見問題 mt中各字段的填寫 訂制或退訂成功的通知包中，業(yè)務代碼字段填寫該業(yè)務對應的業(yè)務代碼；訂制或退訂失敗的通知包中，業(yè)務代碼固定填寫error，表示sp端訂制或退訂失敗 假設正常的業(yè)務代碼為abcd，則sp下發(fā)的mt消息中各字體填寫規(guī)則如下：（*表示具體的值） 業(yè)務流程中的常見問題 mt中各字段的填寫 短信點播類：servicetype=abcd，momtflag=0/1，f

15、eetype=2，feevalue=*，linkid為對應上行點播包的linkid 網(wǎng)上點播類：servicetype=abcd，momtflag=0/1，feetype=2，feevalue=*，linkid為用戶在sp網(wǎng)站上填的手機上收到的校驗碼 業(yè)務流程中的常見問題 mt中各字段的填寫 訂制成功通知包：servicetype=abcd，momtflag=0，feetype=1，feevalue=0，linkid為用戶進行二次確認mo的linkid 訂制失敗通知包：servicetype=error，momtflag=2，feetype=1，feevalue=0，chargenumber=

16、000000000000000000000，linkid為用戶進行二次確認mo的linkid 業(yè)務流程中的常見問題 mt中各字段的填寫 退訂通知包：servicetype=abcd，momtflag=0，feetype=1，feevalue=0，linkid為對應上行退訂包的linkid 包月計費類訂制業(yè)務包：servicetype=abcd，momtflag=2，feetype=1，feevalue=0，linkid為空 業(yè)務流程中的常見問題 mt中各字段的填寫 按條計費類訂制業(yè)務包：servicetype=abcd，momtflag=2，feetype=2，feevalue=*，linki

17、d為空 月租計費包：servicetype=abcd，momtflag=3，reportflag=3、feetype=3，feevalue=*，linkid為空 業(yè)務流程中的常見問題 mt中各字段的填寫 sp付費包：chargenumber=00000000000000000000，servicetype=abcd，feetype=4，feevalue=0，linkid根據(jù)情況填寫 00000命令字對應的退訂命令包：servicetype=0000，momtflag=0，feetype=1，feevalue=0，linkid為上行對應退訂mo包的linkid 業(yè)務流程中的常見問題 linkid

18、的填寫 mo點播引起的mt：sp必須在submit包中填寫對應的mo點播請求deliver消息中的linkid web點播引起的mt：sp必須在submit包中填寫用戶在web上輸入的由spms下發(fā)給用戶的校驗碼，該校驗碼作為mt消息的linkid 訂制或退訂引起的通知mt：sp必須在submit包中填寫對應的訂制/退訂請求deliver消息中的linkid 訂制成功后引起mt業(yè)務消息、月租包消息：不需要填寫linkid，submit包reserve字段填空 業(yè)務流程中的常見問題 其他 臨時訂制和點播關系存在有效期限制，目前為3小時。即用戶3小時后進行二次確認或sp在用戶mo點播后3小時后以m

19、o的linkid下發(fā)mt無效 sgip包中的各個字段需按規(guī)范填寫，如計費號碼不能為空，sp不能下發(fā)morelatetomtflag=3的包（除包月話單外）。sp資料的整理 sp基本資料 sp業(yè)務資料 訂購用戶資料sp資料的整理 sp基本資料 sp基本資料xml文件中的接入省份代碼provincecode填寫051，接入廣州全省網(wǎng)關、廣州全國網(wǎng)關、深圳網(wǎng)關、東莞網(wǎng)關、佛山網(wǎng)關的sp接入城市代碼areacode分別填寫510 、511、540 、580、530 sp程序的修改 修改原sgip程序?qū)eserve字段和序列號的處理 linkid保存在sgip協(xié)議的reserve字段，sp在下行需要填

20、寫linkid的包中復制用戶上行mo包中的linkid sgip包下發(fā)的序列號中的第三部分必須小于一億。 兩個新增接口 web點播接口 web訂制接口sp程序的修改 序列號生成 sp下發(fā)的submit包序列號的第三部分必須小于一億，大于一億部分保留給sp管理系統(tǒng)發(fā)送noti_touser包sp程序的修改 web點播 在sp網(wǎng)站上點播需要先調(diào)用web點播接口，校驗碼會發(fā)送到用戶手機 sp網(wǎng)站上需要提供用戶填寫校驗碼的頁面，將用戶填寫的校驗碼作為linkid下發(fā)sp程序的修改 web訂制/退定 在sp網(wǎng)站上訂制需要先調(diào)用web訂制接口，sp管理系統(tǒng)會建立臨時訂購關系，并提示用戶通過手機上行訂制命令字進行二次確認 用戶在sp網(wǎng)站退定時，sp需要調(diào)用web訂制接口（參數(shù)傳業(yè)務的退訂命令字），退定sp管理系統(tǒng)上的訂購關系，否則用戶查詢時訂購關系仍然存在。web點播/訂制接口的格式 點播接口格式 訂制接口格式web點播/訂制接口中的加密 采用3des方式加密 模式為ecb（電子密碼本） 填充算法為pkcs#7 密鑰為192位 密鑰和加密后的串都需要base64編碼測試工具 提供給sp的校驗工具 3des加密校驗工具 同步資料格式校驗工具 以上工具需要microsoft .net