深信服-云信通企業信使短信配置說明

名詞說明：

WEBSERVICE

一種服務導向架構的技術，通過標準的 Web 協議提供服務，目的是保證不同平臺的應用服務可以相互操作。根據 W3C 的定義，WEBSERVICE 應當是一個軟件系統，用以支持網絡間不同機器的互動操作。WEBSERVICE 通常是許多應用程序接口（API）所組成的，通過網絡在遠程服務器端執行客戶端所提交服務的請求。

SOAP

簡單對象訪問協議（SOAP，全寫為 Simple Object Access Protocol），一個基于 XML的可擴展消息信封格式，需同時綁定一個傳輸用協議。這個協議通常是 HTTP 或 HTTPS， 但也可能是 SMTP 或 XMPP。

WSDL

一個 XML 格式文檔，用以描述程序（服務）接口訪問方式和使用協議的細節，通常用來輔助生成服務器和客戶端代碼及配置信息。

信息準備：

WEBSERVICE 服務器請求地址，SOAP 版本(SOAP1.1/SOAP1.2)，請求類型(GET/POST)等。

短信發送模版等相關文檔，包括：
a) 短信接口描述 WSDL 文件，WSDL（Web Services Description Language 的縮寫） 是一個用來描述 Web 服務和說明如何與 Web 服務通信的 XML 語言，也就是為用戶提供詳細的接口說明書。
b) 短信接口說明使用文檔及相關參數信息
c) 其他系統正常發送短信的實際配置實例或抓包結果

配置步驟：

[認證服務器]-新增[短信認證]

短信內容默認。但是默認短信內容中這個字段會在短信內容中產生冒號
(?、斜杠(/)以及 AND(&)等符號，通常在 WEBSERVICE 中有特殊含義，我們沒有進行轉義處理，服務器會返回 500 Internal Server Error。所以通過 WEBSERVICE 發送短信時建議先將這一段話去掉。

? 短信認證可以做免認證
? 短信認證可以做短信后微信連 wifi 認證
3. 默認選擇通過設備內置短信模塊發送

4. 參數設定，網關類型選擇“HTTP 協議”
5.帳號密碼可以直接到云信通平臺11467.cn注冊開通 企業ID 帳號 密碼
參數說明：
(1) 發短信國家碼可選，根據短信平臺要求勾選
(2) URL 地址，請求 WEBSERVICE 的完整 URL
(3) 頁面編碼，通常為 UTF-8
(4) SOAP 版本，包括 1.1、1.2 兩個版本，主要是請求頭部的差別，通常是用 SOAP1.1
(5) 請求類型，通過 GET 或者 POST 請求發送短信，通常都是 POST 方式
(6) 配置短信模版

配置短信模版：

接口名稱：WSDL 文件中定義的發送短信的函數接口，如 sendSMS
WSDL 文件：上傳 WSDL 文件，用于解析請求模版
點擊“瀏覽”選擇本地的 WSDL 或 XML 格式的文件，輸入其中定義的發送短信的接口名稱后，點擊“生成請求模版”，在“請求模版”文本框中會自動生成短信請求，也可以手動輸入請求內容。
自動生成的短信請求模版中，只包含了各個接口參數的名稱，不包含參數內容，內容需 要根據相關接口文檔具體填寫。個別參數需要用我們的參數變量進行替換，例如手機號碼需 要替換為$$MOBIL{E}_{N}UM$$
“接收模版”這個只是給設備定義怎樣算是發送成功的，設備向 WEBSERVICE 發送短信請求后，會解析服務器返回的結果，結果中包含對應的字段，則認為發送成功，一般填的是200

常見錯誤：

抓包發現服務器返回 500 Internal Error
這個一般是短信請求模版的參數格式有誤，確認方法是，重新自動生成模版，然后什么參數都不要修改，直接提交發送測試短信，看是否還回復 500 錯誤。如果默認參數還是 500 錯誤，那要么是我們自動生成的模版有問題，要么就是服務器真的有問題了。

在短信請求模版中加入$$SM{S}_{C}ONTENT$$即短信內容后，服務器就返回 500 錯誤。
短信內容中默認有這個參數，在發送短信時會轉換成 URL，包含特殊字符，服務器可能不認，去掉短信內容模版中的 URL 這一句話試下。

成功發送短信了，但手機沒收到。
對比正常收發短信的請求報文，看各字段格式是否一致。特別是手機號字段，有的短信網關要求指定的手機號格式，如 tel:13800000000 或者+8613800000000 等，此時我們就要填寫為 tel:$$MOBIL{E}_{N}UME$$或者+86$$MOBIL{E}_{N}UME$$

總結

以上是生活随笔為你收集整理的深信服短信认证云信通短信配置说明的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。