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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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