- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 关于我们
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保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
