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