中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議
中國聯(lián)合通信公司 短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議 (SGIP) 版本1.2 中國聯(lián)合通信公司 二零零一年十月 目錄 1概述 1 1.1協(xié)議說明 1 1.2適用范圍 1 1.3參考資料 1 1.4術(shù)語表 1 2系統(tǒng)體系結(jié)構(gòu) 3 2.1消息從本地SMSC到本地SP 4 2.2消息從本地SP到本地SMSC 4 2.3消息從本地SMSC到異地SP 4 2.4消息從本地SP到異地SMSC 4 2.5路由選擇 4 3 通信流程 6 3.1專用SGIP方式 6 3.2通用HTTP方式 6 3.3通信節(jié)點(diǎn)編號規(guī)則 7 3.4序列號的定義 7 3.5通信的安全性 8 3.6用戶鑒權(quán) 8 3.6.1被叫方付費(fèi) 8 3.6.2SP付費(fèi) 8 3.6.3第三方付費(fèi) 8 3.7 SP與SMG的通信 9 3.7.1通用HTTP方式 9 3.7.1.1從SP到SMG的命令 9 3.7.1.2從SMG到SP的命令 10 3.7.2專用SGIP方式 10 3.7.2.1通信初始化 10 3.7.2.2通信過程 10 3.7.2.3通信結(jié)束 11 3.7.2.4故障處理 12 3.7.2.5從SP到SMG的消息 12 3.7.2.6從SMG到SP的消息 13 3.8 SMG與SMG之間的通信 13 3.8.1通信初始化 14 3.8.2通信過程 14 3.8.3通信結(jié)束 14 3.8.4故障處理 14 3.8.5兩個SMG之間的消息 15 3.9 SMG與GNS之間的通信 15 3.9.1通信初始化 15 3.9.2通信過程 15 3.9.3通信結(jié)束 16 3.9.4故障處理 16 3.9.5從SMG到GNS的消息 16 3.9.6從GNS到SMG的消息 16 4 消息定義 18 4.1基于通用HTTP的消息定義 18 4.1.1Submit操作 18 4.1.1.1Submit命令的請求內(nèi)容 18 4.1.1.2Submit命令的應(yīng)答內(nèi)容 19 4.1.2Deliver操作 20 4.1.2.1Deliver命令的請求內(nèi)容 20 4.1.2.2Deliver命令的應(yīng)答內(nèi)容 20 4.1.3Report操作 21 4.1.3.1Report命令的請求內(nèi)容 21 4.1.3.2Report命令的應(yīng)答內(nèi)容 21 4.1.4UserRpt操作 22 4.1.4.1UserRpt命令的請求內(nèi)容 22 4.1.4.2UserRpt命令的應(yīng)答內(nèi)容 22 4.1.5Trace操作 22 4.1.5.1Trace命令的請求內(nèi)容 22 4.1.5.2Trace命令的應(yīng)答內(nèi)容 23 4.2基于專用SGIP的消息定義 23 4.2.1數(shù)據(jù)類型 23 4.2.2消息頭的格式 24 4.2.3消息體的格式 24 4.2.3.1Bind操作 24 4.2.3.2Unbind操作 25 4.2.3.3Submit操作 25 4.2.3.4Deliver操作 27 4.2.3.5Report操作 28 4.2.3.6AddSP操作 28 4.2.3.7ModifySP操作 29 4.2.3.8DeleteSP操作 30 4.2.3.9QueryRoute操作 30 4.2.3.10AddTeleSeg操作 31 4.2.3.11ModifyTeleSeg操作 32 4.2.3.12DeleteTeleSeg操作 32 4.2.3.13AddSMG操作 33 4.2.3.14ModifySMG操作 34 4.2.3.15DeleteSMG操作 34 4.3鑒權(quán)消息定義 35 4.3.1CheckUser命令的語法 35 4.3.2CheckUser_Resp應(yīng)答的語法 35 4.3.3UserRpt命令的語法 35 4.3.4UserRpt_Resp應(yīng)答的語法 35 4.4測試消息定義 36 4.4.1Trace命令的語法 36 4.4.2Trace_Resp應(yīng)答的語法 36 5常量定義 37 5.1消息ID定義 37 5.2錯誤碼定義 37 5.3計(jì)費(fèi)類別定義 38 5.4REPORT 狀態(tài)與短消息狀態(tài)的映射 38 附錄1: 全網(wǎng)路由表的格式示范 39 附錄2: 本地路由表的格式示范 40 附錄3: HTTP承載方式示范 41 1概述 1.1協(xié)議說明 本協(xié)議是SMG和SP之間、SMG和GNS之間、以及SMG和SMG之間的接口協(xié)議，簡稱SGIP。 通過應(yīng)用SGIP協(xié)議，SP可以接入到SMG，實(shí)現(xiàn)SP應(yīng)用的一點(diǎn)接入、全網(wǎng)服務(wù)；SMG可以 通過SGIP協(xié)議，實(shí)現(xiàn)消息在不同SMG之間的路由和轉(zhuǎn)發(fā)。同時，SMG通過該協(xié)議也可以和 GNS通信，以實(shí)現(xiàn)各SMG和GNS之間路由表的同步功能。 1.2適用范圍 本協(xié)議適用于各SP廠商和SMG的開發(fā)廠商。 1.3參考資料 [1] SMPP 3.3 [2] GSM 3.40 [3] GSM 3.38 [4] HTTP1.0 1.4術(shù)語表 本協(xié)議用到以下術(shù)語： GNS Gateway Name Server，負(fù)責(zé)系統(tǒng)路由的管理和同步 MO 由手機(jī)用戶提交的短消息 MT 由手機(jī)用戶接收的短消息 SGIP Short Message Gateway Interface Protocol，本協(xié)議所描述的短消息網(wǎng)關(guān)接口協(xié)議，用于完成在SMG和S P之間、SMG和SMG之間短消息的發(fā)送、接收和轉(zhuǎn)發(fā)功能，以及SMG和GN S之間路由表的同步功能 SMG Short Message Gateway ，聯(lián)通公司的短消息網(wǎng)關(guān)，SMG之間的通訊協(xié)議采用SGIP SMPP Short Message Peer to Peer，短消息點(diǎn)對點(diǎn)協(xié)議，采用3.3版本 SMSC Short Message Service Center ，短消息中心 SP Service Provider，服務(wù)提供商 2系統(tǒng)體系結(jié)構(gòu) SMG是具有短消息轉(zhuǎn)發(fā)功能的短消息網(wǎng)關(guān)。全國可以有多個SMG網(wǎng)關(guān)，SMG網(wǎng)關(guān)之間通 過互聯(lián)網(wǎng)等方式實(shí)現(xiàn)網(wǎng)絡(luò)互聯(lián)。每一個SMG同時與多個SMSC以及多個SP連接。全網(wǎng)具有唯 一有效的GNS，GNS負(fù)責(zé)全局路由表的維護(hù)與更新；為了確保路由表存儲的安全性，網(wǎng)絡(luò) 中設(shè)置主備用GNS，兩個GNS要保持一致性。每一個SMG都和GNS連接。SMG與SP、SMG與GN S以及SMG與SMG之間的通信協(xié)議為SGIP協(xié)議。SMG與SMSC之間的通信統(tǒng)一采用SMPP3.3協(xié)議 。 圖2-1說明了系統(tǒng)的體系結(jié)構(gòu)。 [pic] 圖2-1 SMG的體系結(jié)構(gòu) 和SMG平臺之間相連的SMSC稱作本地SMSC，和異地SMG平臺相連的SMSC稱作異地SMSC。 和SMG平臺之間相連的SP稱作本地SP，和異地SMG平臺相連的SP稱作異地SP。 從本地SMSC向本地SP以及從本地SP向本地SMSC發(fā)送的消息直接由SMG轉(zhuǎn)發(fā)；從本地SM SC向異地SP以及從本地SP向異地SMSC發(fā)送的消息由本地SMG路由到異地SMG后，再由異地 SMG轉(zhuǎn)發(fā)。 2.1消息從本地SMSC到本地SP SMG從SMSC接收到短消息，直接發(fā)給SP。比如 SMSC1A—〉SMG1—〉SP1Y SMSC1B—〉SMG1—〉SP1X 2.2消息從本地SP到本地SMSC SMG從SP接收短消息，直接發(fā)給SMSC。比如 SP1X—〉SMG1—〉SMSC1A SP1Y—〉SMG1—〉SMSC1B 2.3消息從本地SMSC到異地SP SMG從本地SMSC接收短消息，再路由到異地SMG，由異地的SMG發(fā)送到目的SP，比如 SMSC1A—〉SMG1—〉SMG2—〉SP2Y SMSC1B—〉SMG1—〉SMG3—〉SP3X 2.4消息從本地SP到異地SMSC SMG從本地SP接收短消息，再路由到異地SMG，由異地的SMG發(fā)送到目的SMSC，比如 SP1X—〉SMG1—〉SMG2—〉SMSC2A SP1Y—〉SMG1—〉SMG3—〉SMSC3B 2.5路由選擇 當(dāng)消息在本地SMSC和異地SP，或者在本地SP和異地SMSC之間傳輸時，發(fā)送方必須要獲 取消息接收方的位置信息。這部分功能稱為路由選擇。 對于MO方向的命令(即命令接收方為SP)，其路由根據(jù)命令中的SP接入號碼來選擇。 對于MT方向的命令(即接收方為用戶手機(jī))，其路由根據(jù)命令中的付費(fèi)號碼和用戶號碼 來綜合判斷。如果付費(fèi)號碼為空，或付費(fèi)號碼為SP接入號碼，則根據(jù)用戶號碼來選擇路 由；否則根據(jù)付費(fèi)號碼所代表的手機(jī)號碼來選擇路由(這樣做是考慮到了系統(tǒng)計(jì)費(fèi)和用戶 鑒權(quán)的可行性，關(guān)于計(jì)費(fèi)和用戶鑒權(quán)的細(xì)節(jié)，請參見其它文檔)。 由于SMG網(wǎng)關(guān)之間采用網(wǎng)狀互聯(lián)，網(wǎng)關(guān)之間不可能出現(xiàn)二次前轉(zhuǎn)，因此接收前轉(zhuǎn)消息 的網(wǎng)關(guān)必須能判斷前轉(zhuǎn)的消息目的地址是否是本網(wǎng)關(guān)覆蓋范圍的用戶，若不是，必須發(fā) 送出錯信息到前轉(zhuǎn)網(wǎng)關(guān)。 通信流程 SGIP有兩種具體實(shí)現(xiàn)方式，一種是采用專用SGIP方式，另一種是采用通用HTTP方式。 SMG和GNS、以及SMG和SMG之間采用專用SGIP方式作為承載協(xié)議；而SP和SMG的通信同時支 持專用SGIP方式和通用HTTP方式兩種承載協(xié)議。 3.1專用SGIP方式 采用專用SGIP方式承載時，通信雙方互為客戶端和服務(wù)器端。當(dāng)客戶端要發(fā)送命令時 ，主動向服務(wù)器端建立連接，然后向服務(wù)器端發(fā)送命令，并接收應(yīng)答；服務(wù)器端從客戶 端接收命令，返回應(yīng)答。連接建立以后，客戶端可以連續(xù)發(fā)送多條命令。命令發(fā)送完并 接收到所有應(yīng)答后，客戶端應(yīng)該主動斷開連接。但是，命令及其應(yīng)答之間的時間間隔最 大不能超過30秒(默認(rèn)，可配置)（如果命令應(yīng)答時間超過最大等待時間，則要求客戶端 重發(fā)該條命令，重發(fā)機(jī)制參見業(yè)務(wù)聯(lián)網(wǎng)規(guī)范有關(guān)內(nèi)容），且待應(yīng)答的命令不得超過32條 （可以根據(jù)線路的質(zhì)量和服務(wù)器的處理能力配置）。而且，如果服務(wù)器端檢測出一條連 接長時間空閑(默認(rèn)60秒，可配置)，可以主動斷開該連接。如果需要，客戶端可以同時 向一個服務(wù)器端建立多個連接（SMG與單個其他SMG最多不能建立超過15個連接，對與之 相連的單個SP的最大連接數(shù)視具體情況而定）。采用專用SGIP承載方式時，SMG和SMG、 SP和SMG之間使用的端口號是8801，GNS監(jiān)聽SMG的端口號為8802，SMG監(jiān)聽GNS的端口號為 8803，主GNS和備用GNS之間的端口號為8804，SMG之間的測試用端口號為8810。 3.2通用HTTP方式 HTTP承載方式只適用于SP和SMG的通信中。與SP與SMG之間的專用SGIP承載方式不同的 是，該種方式一次連接僅僅傳送一條命令，而且連接的認(rèn)證采用HTTP的URL的授權(quán)認(rèn)證的 方式，不需要專門的連接認(rèn)證的命令，使用的端口號是80。 3.3通信節(jié)點(diǎn)編號規(guī)則 在整個網(wǎng)關(guān)系統(tǒng)中，所有的通信節(jié)點(diǎn)(SMG、GNS、SP和SMSC)都有一個唯一的數(shù)字編號 ，不同的SP或SMSC或SMG或GNS編號不能相同，編號由系統(tǒng)管理人員負(fù)責(zé)分配。編號規(guī)則 如下： SMG的編號規(guī)則：1AAAAX SMSC的編號規(guī)則： 2AAAAX SP的編號規(guī)則：3AAAAQQQQQ GNS的編號規(guī)則：4AAAAX 其中, AAAA表示四位長途區(qū)號(不足四位的長途區(qū)號，左對齊，右補(bǔ)零),X表示1位序 號,QQQQQ表示5位企業(yè)代碼。 3.4序列號的定義 短消息網(wǎng)關(guān)系統(tǒng)之中傳輸?shù)拿恳粭l命令都有一個序列號，序列號由命令源節(jié)點(diǎn)產(chǎn)生并 唯一標(biāo)記一條命令；也就是說，網(wǎng)關(guān)系統(tǒng)中任何兩個命令的序列號都不相同。需要注意 的是，一條命令在發(fā)送過程中轉(zhuǎn)發(fā)的不同副本視為一條命令，使用相同的序列號。比如 ，SP1X向SMSC2A發(fā)送一條命令，該命令需經(jīng)過多次轉(zhuǎn)發(fā)才能到達(dá)SMSC2A，而轉(zhuǎn)發(fā)該命令 的每一次通信過程中使用的命令的序號均相同，為SP1X與SMG1通信所使用的序列號。對 于MO短消息，例如SMSC1B向SP3X發(fā)送一條命令，短消息首先采用SMPP協(xié)議發(fā)送到SMG1， 經(jīng)過SMG1轉(zhuǎn)發(fā)時序列號必須由SMG1重新生成（此時命令源節(jié)點(diǎn)為SMG1）。 序列號分成三部分，每部分為一個32位整數(shù)，第一部分表示命令源節(jié)點(diǎn)的編號，第二 部分表示命令產(chǎn)生的日期和時間(網(wǎng)關(guān)系統(tǒng)中的任何命令的保存時間都不應(yīng)該超過一年) ，格式為十進(jìn)制的mmddhhmmss，比如11月20日20時32分25秒產(chǎn)生的命令，其第二部分為 十進(jìn)制1120203225；第三部分由0開始，循環(huán)進(jìn)位，直到進(jìn)位滿了之后再清零，重新開始 計(jì)數(shù)。接收方在返回應(yīng)答時，應(yīng)答的序列號必須和相對應(yīng)的命令的序列號相同。 [pic] 圖3-1 命令序列號格式舉例 3.5通信的安全性 SP與SMG、SMG與SMG以及SMG與GNS之間采用專用SGIP方式通信時可采用對稱加密方式 。SP與SMG之間采用通用HTTP方式時，可采用HTTPS方式加密。 3.6用戶鑒權(quán) 當(dāng)一條MT短消息需要處理時，終點(diǎn)SMG必須保證該短消息的付費(fèi)方有資格享用該服務(wù) (比如付費(fèi)用戶不欠費(fèi))。根據(jù)短消息服務(wù)類型的不同，可以將付費(fèi)方式分成三類：被叫 方付費(fèi)、SP付費(fèi)和第三方付費(fèi)。 3.6.1被叫方付費(fèi) 目前的短消息中心都具有對被叫用戶鑒權(quán)的功能，所以對由被叫方付費(fèi)的MT短消息， SMG不作鑒權(quán)檢查，直接轉(zhuǎn)發(fā)至SMSC；如果被叫方鑒權(quán)失敗，SMSC會通過反饋通知SMG。 3.6.2SP付費(fèi) 當(dāng)MT短消息是由SP付費(fèi)時(如SP發(fā)送廣告)，SMG不作鑒權(quán)檢查。 3.6.3第三方付費(fèi) 當(dāng)MT短消息是由第三方付費(fèi) (如手機(jī)用戶A通過SP給手機(jī)用戶B點(diǎn)歌，并由手機(jī)用戶A付費(fèi))時，應(yīng)該對付費(fèi)方進(jìn)行鑒權(quán) 。這種情況下，該MT短消息應(yīng)該從付費(fèi)方歸屬地的短消息中心發(fā)送，并且由付費(fèi)方歸屬 地的計(jì)費(fèi)中心完成鑒權(quán)操作。如果計(jì)費(fèi)中心鑒權(quán)成功，SMG即將該MT短消息發(fā)送至SMSC， 否則SMG不再發(fā)送該短消息，并根據(jù)SP的要求決定是否返回Report命令通知SP發(fā)送失敗的 原因。 SMG和計(jì)費(fèi)中心通過TCP/IP通信實(shí)現(xiàn)鑒權(quán)功能。計(jì)費(fèi)中心為服務(wù)器端，SMG為客戶端。 一次鑒權(quán)過程完成對一個手機(jī)號碼的鑒權(quán)。鑒權(quán)步驟如下： 1. SMG和計(jì)費(fèi)中心建立TCP/IP連接； 2. SMG向計(jì)費(fèi)中心發(fā)送鑒權(quán)命令； 3. SMG從計(jì)費(fèi)中心接收鑒權(quán)應(yīng)答； 4. SMG和計(jì)費(fèi)中心斷開連接； |消息 |描述 | |CheckUser |SMG向計(jì)費(fèi)中心請求對一個手機(jī)號碼鑒權(quán) | |CheckUser_Res|計(jì)費(fèi)中心向SMG返回的一個手機(jī)號碼的鑒權(quán)結(jié)果| |p | | 表3-1 SMG和計(jì)費(fèi)中心的鑒權(quán)消息 3.7 SP與SMG的通信 SP和SMG支持兩種類型的通信承載方式：通用HTTP承載方式和通用SGIP承載方式。 3.7.1通用HTTP方式 SP和SMG之間采用通用HTTP方式通信時，SP和SMG互為HTTP的客戶端和服務(wù)器端。HTT P服務(wù)器端對相關(guān)的URL進(jìn)行保護(hù)，HTTP客戶端必須采用授權(quán)方式訪問這些URL。HTTP的特 點(diǎn)決定客戶端和服務(wù)器端的每一次通信都必須一次完成授權(quán)連接、發(fā)送請求、接收應(yīng)答 、關(guān)閉連接等過程(HTTP承載方式不再需要專門的連接命令)。 對于MO方向的命令(即命令接收方為SP)，由SMG通過POST方式提交給SP進(jìn)行處理，SP 將處理結(jié)果以及MT方向信息在HTTP應(yīng)答中返回給SMG； 對...
中國聯(lián)合通信公司短消息網(wǎng)關(guān)系統(tǒng)接口協(xié)議