30-SMS命令
本章節下載: 30-SMS命令 (189.48 KB)
目 錄
app-id命令用來配置第三方短信平台的標識。
undo app-id命令用來恢複缺省情況。
【命令】
app-id app-id
undo app-id
【缺省情況】
未配置第三方短信平台的標識。
【視圖】
短信網關視圖
【缺省用戶角色】
network-admin
context-admin
【參數】
app-id:第三方短信平台的標識,為1~31個字符的字符串,區分大小寫。
【使用指導】
此標識會被封裝在HTTP請求報文首部字段,發送至第三方短信平台,用於驗證短信網關的身份,以及匹配對應的解密密鑰並授權其相應的服務。
此標識由第三方短信平台提供。
【舉例】
# 在短信網關gw1下配置第三方短信平台的標識為abc。
<Sysname> system-view
[Sysname] sms-gateway gw1
[Sysname-sms-gateway-gw1] app-id abc
【相關命令】
· secret-key
display sms-gateway命令用來顯示短信網關的信息。
【命令】
display sms-gateway [ brief | name gateway-name ]
【視圖】
任意視圖
【缺省用戶角色】
network-admin
network-operator
context-admin
context-operator
【參數】
brief:顯示所有短信網關的簡要信息。
name gateway-name:顯示指定短信網關的詳細信息。gateway-name表示短信網關名稱,為1~31個字符的字符串,隻能包含字母、數字、下劃線,不區分大小寫。如果不指定本參數,則顯示所有短信網關的信息。
【使用指導】
若不指定任何參數,則表示顯示所有短信網關的詳細信息。
配置的用於加密短信數據的密鑰,將以密文形式顯示。
【舉例】
# 顯示所有短信網關的詳細信息。
<Sysname> display sms-gateway
Total Number of SMS gateways: 2
SMS gateway name: gw1
SMS platform: emay
App ID: abc
Secret key: $c$3$zvzJI1AMQ4OVHCkSnXXoAOUyd2STdtIFtQDlJETCg=
VPN instance: vpn1
SMS gateway name: gw2
SMS platform: emay
App ID: 123
Secret key: $c$3$AS4tqlnOVODYEQ5IMHJNyNTTAyBPotXgw==
VPN instance: vpn1
表1-1 display sms-gateway命令顯示信息描述表
字段 |
描述 |
Total Number of SMS gateways |
短信網關的總數量 |
SMS gateway name |
短信網關的名稱 |
SMS platform |
短信網關發送短信的平台 |
App ID |
第三方短信平台的標識 |
Secret key |
加密短信數據的密鑰(密文形式) |
VPN instance |
短信網關關聯的VPN實例 |
# 顯示所有短信網關的簡要信息。
<Sysname> display sms-gateway brief
SMS gateway name SMS platform VPN instance
gw1 emay vpn1
gw2 emay vpn1
表1-2 display sms-gateway brief命令顯示信息描述表
字段 |
描述 |
SMS gateway name |
短信網關的名稱 |
SMS platform |
短信網關發送短信的平台 |
VPN instance |
短信網關關聯的VPN實例 |
secret-key命令用來配置用於加密短信數據的密鑰。
undo secret-key命令用來恢複缺省情況。
【命令】
secret-key { cipher | simple } string
undo secret-key
【缺省情況】
未配置用於加密短信數據的密鑰。
【視圖】
短信網關視圖
【缺省用戶角色】
network-admin
context-admin
【參數】
cipher:表示以密文方式設置密鑰。
simple:表示以明文方式設置密鑰,該密鑰將以密文形式存儲。
string:密鑰字符串,區分大小寫。明文密鑰為1~63個字符的字符串;密文密鑰為1~117個字符的字符串。
【使用指導】
本命令配置的密鑰與app-id命令配置的第三方短信平台的標識一一對應。
業務模塊將短信數據發送至短信網關後,短信網關將短信數據解析並轉換為第三方短信平台所能識別的數據,並使用密鑰及算法對相應的數據進行加密,加密的數據通過短信網關發送至第三方短信平台。
第三方短信平台接收加密的數據,通過查找HTTP請求報文首部字段內的標識(app-id值),匹配對應的密鑰對數據進行解密。解密之後得到短信數據明文,最後由短信平台將短信發送至用戶手機。
此密鑰由第三方短信平台提供。
【舉例】
# 在短信網關gw1下配置用於加密短信數據的明文密鑰為TESTplat&!。
<Sysname> system-view
[Sysname] sms-gateway gw1
[Sysname-sms-gateway-gw1] secret-key simple TESTplat&!
【相關命令】
· app-id
sms-gateway命令用來創建短信網關,並進入短信網關視圖。如果指定的短信網關已經存在,則直接進入短信網關視圖。
undo sms-gateway命令用來刪除指定的短信網關。
【命令】
sms-gateway gateway-name
undo sms-gateway gateway-name
【缺省情況】
不存在短信網關。
【視圖】
係統視圖
【缺省用戶角色】
network-admin
context-admin
【參數】
gateway-name:短信網關名稱,為1~31個字符的字符串,隻能包含字母、數字、下劃線,不區分大小寫。
【使用指導】
設備通過短信網關實現短信發送功能。業務模塊將短信數據發送至短信網關,短信網關根據配置策略將短信數據轉換為第三方短信平台所能識別的數據,然後通過HTTP協議將數據發送給第三方短信平台,最後由第三方短信平台將短信發送至用戶手機。
短信網關視圖用來配置實現發送短信功能的相關參數,包括發送短信的方式、登錄第三方短信平台的標識、用於加密短信數據的密鑰等。
一個短信網關可以被多個有發送短信需求的業務模塊引用。
【舉例】
# 創建短信網關gw1,並進入短信網關視圖。
<Sysname> system-view
[Sysname] sms-gateway gw1
[Sysname-sms-gateway-gw1]
【相關命令】
· display sms-gateway
sms-platform命令用來配置短信網關發送短信的平台。
undo sms-platform命令用來恢複缺省情況。
【命令】
sms-platform emay
undo sms-platform
【缺省情況】
未配置短信網關發送短信的平台。
【視圖】
短信網關視圖
【缺省用戶角色】
network-admin
context-admin
【參數】
emay:表示第三方億美軟通短信平台。
【使用指導】
隻有在短信網關上配置了登錄標識(通過app-id命令)和加密密鑰(通過secret-key命令),短信網關才能登錄到相應的第三方短信平台(通過本命令配置)進行短信業務。
【舉例】
# 在短信網關gw1下配置短信網關發送短信的平台為億美軟通短信平台。
<Sysname> system-view
[Sysname] sms-gateway gw1
[Sysname-sms-gateway-gw1] sms-platform emay
【相關命令】
· app-id
· secret-key
sms-send test-mobile命令用來配置向測試手機號碼發送短信。
【命令】
sms-send test-mobile number
【視圖】
短信網關視圖
【缺省用戶角色】
network-admin
context-admin
【參數】
number:接收測試短信的手機號碼,為1~31個字符的字符串,僅支持數字。
【使用指導】
通過向測試手機號碼發送測試短信,判斷配置的短信網關是否可以正常工作。如果在手機上接收到內容為“XXX(app-id)驗證通過!”的測試短信,則認為此短信網關可以正常工作。
【舉例】
# 在短信網關gw1下配置測試手機號碼為111111。
<Sysname> system-view
[Sysname] sms-gateway gw1
[Sysname-sms-gateway-gw1] sms-send test-mobile 111111
【相關命令】
· app-id
· secret-key
· sms-platform
vpn-instance命令用來配置短信網關關聯的VPN實例。
undo vpn-instance命令用來恢複缺省情況。
【命令】
vpn-instance vpn-instance-name
undo vpn-instance
【缺省情況】
短信網關屬於公網。
【視圖】
短信網關視圖
【缺省用戶角色】
network-admin
context-admin
【參數】
vpn-instance-name:短信網關關聯的MPLS L3VPN的VPN實例名稱,為1~31個字符的字符串,區分大小寫。
【使用指導】
執行本命令後,短信網關包含的資源將屬於關聯的VPN實例。
每個短信網關隻能關聯一個VPN實例。
【舉例】
# 配置短信網關gw1關聯VPN實例vpn1。
<Sysname> system-view
[Sysname] sms-gateway gw1
[Sysname-sms-gateway-gw1] vpn-instance vpn1
不同款型規格的資料略有差異, 詳細信息請向具體銷售和400谘詢。H3C保留在沒有任何通知或提示的情況下對資料內容進行修改的權利!