# 配置短信网关 管理员通过配置短信网关，实现发送和接收短信的功能。 #### 背景信息 当对接短信网关的用户密码发生变化时，请同步修改AICC侧配置，修改方式：选择"配置中心 \> 接入配置 \> 网关配置"，单击待修改列的网关对应的"编辑"，单击消息协议参数配置，输入修改后的登录口令。 #### 操作步骤 1. 以租户管理员角色登录AICC，选择"配置中心 \> 接入配置 \> 网关配置"，配置网关信息。 图1网关配置 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002151433393.png) 组织机构：由租户级参数"租户是否开启组织间的数据强制隔离机制"控制。 - 开启租户级参数"租户是否开启组织间的数据强制隔离机制"后，组织机构数据范围请根据实际情况选择以下方式之一配置： - 当前账号配置的角色中添加系统公共权限下的"查看所有组织数据"、"查看编辑归属组织数据"或者"查看下级组织数据"的权限。 - 当前账号在员工信息中配置"可访问组织"的读取权限。 - 关闭参数后，"组织机构"参数隐藏。 2. 单击"新建"，进入新增网关配置页面。 图2配置网关-基本信息 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002151347521.png) 组织机构：由租户级参数"租户是否开启组织间的数据强制隔离机制"控制。 - 开启租户级参数"租户是否开启组织间的数据强制隔离机制"后，组织机构数据范围请根据实际情况选择以下方式之一配置： - 当前账号配置的角色中添加系统公共权限下的"查看所有组织数据"、"查看编辑归属组织数据"或者"查看下级组织数据"的权限。 - 当前账号在员工信息中配置"可访问组织"的读取权限。 - 关闭参数后，"组织机构"参数隐藏。 3. 信息配置完成后，单击"下一步"，进入网关地址对接配置。 - 基础配置：用户需要填写的配置项。 图3网关地址对接配置-基础配置 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002023296758.png) - SMG地址：必填项，短信网关的IP地址。示例：10.10.10.10。 - SMG端口：必填项，短信网关的端口号。 - 登录名：登录网关的帐号（使用网关模拟器时可不填写）。 - 登录口令：登录网关的密码（使用网关模拟器时可不填写）。 - 收发模式：必填项，表示协议设备是用于发送短信，还是用于接收短信。默认值为收发短信，取值范围： - 收发短信：表示该协议设备即用于处理从SMSC接收到的消息又用于发送短信。 - 接收短信：表示该协议设备用于处理从SMSC接收到的消息。 - 发送短信：表示该协议设备用于发送短信。 - SMPP PDU 类型：必填项，短信发送时使用的SMPP PDU类型。默认值为submit_sm，取值范围： - submit_sm - data_sm - 发送方标识前缀：网关配置的允许发送号码段前缀。取值范围：字母（a～z、A～Z）、数字（0～9）。 发送方标识前缀规则：AICC侧号码内，国家码后面的部分以此配置开头，例如AICC侧号码为+86123xxxxxxxx时，配置123即可。多个前缀以英文分号分隔。 该配置是否必填受租户级参数"短信网关支持设置发送人为空"控制，默认值为否，详情请参见[配置租户参数](https://support.huaweicloud.com/usermanual-cec/cec_04_0458.html#ZH-CN_TOPIC_0000002478096296)。 - 接收号码前缀：必填项，网关配置的允许接收号码段前缀。取值范围：数字（0～9）。 接收号码前缀规则：客户侧号码内，国家码后面的部分以此配置开头，例如客户侧号码为+86123xxxxxxxx时，配置123即可。多个前缀以英文分号分隔。 - 默认发送方标识：网关默认的发送方标识，取值为[短信发送方标识配置操作步骤](https://support.huaweicloud.com/usermanual-cec/cec_04_0373.html#ZH-CN_TOPIC_0000002509976231__zh-cn_topic_0000002422554648_zh-cn_topic_0269588496_section24453328386)中配置的标识。 - ESME连接配置：缺省填入，用户可根据自身需要额外修改。 图4网关地址对接配置-ESME连接配置 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001773004193.png) - 客户端端口：必填项，指定CC-Notification 服务器一个未被占用的端口，用于与短信网关建立连接。当短信网关需要指定客户端端口时，需要设置该参数。取值范围：0～65535。 **默认值**：0，表示CC-Notification 系统随机分配一个端口。 - 上行消息接收端口：接收上行消息的端口号。取值范围：0～65535。 **默认值**：0，表示由CC-Notification 自动分配。 - 心跳间隔（毫秒）：为了维持CC-Notification与 短信网关的长连接，需要定期向短信网关发送心跳消息。用于设置发送心跳消息的间隔时间。取值范围：1～10位数字，取值必须大于"事务超时时间（毫秒）"，小于"接收超时时间（毫秒）"。 **默认值**：30000，单位：毫秒。 - 心跳无响应最大连接次数：连续心跳无响应次数大于该参数值时，CC-Notification 将断开与网关的连接。取值范围：0～5位数字。 **默认值**：3。 - 重发次数：设置重发的最大次数。CC-Notification 发送心跳消息后，如果在事务超时时间内未得到心跳响应，则CC-Notification 将等待一段时间（即"重发等待时间（毫秒）"的值），然后重新发送心跳消息。取值范围：0-10位数字。 **默认值**：0。 - 重发等待时间（毫秒）： CC-Notification收到短信网关返回的短信发送失败的应答消息后，等待多长时间重发该短信。取值范围：0-10位数字。 **默认值**：0。 - 接收超时时间（毫秒）：必填项，短信设备和网关建立连接后，允许没有数据传输的最长时间。如果在接收超时时间内，短信设备没有收到对端设备的数据，则连接自动断开。取值范围：1-10位以内数字，取值必须大于"心跳间隔（毫秒）"和"事务超时时间（毫秒）"。为了保证不出现无效连接，接收超时时间不能设置为"0"。 **默认值**：180000。 - 接收最大错误包数：一个设备上连续收到错误包的消息数量。如果连续收到设置数量的错误数据包，则表明这个链路有故障，该链路将被断开。取值范围：0-10位以内数字。 **默认值**：10。 - 滑窗大小：必填项，标识CC-Notification 系统的瞬间并发处理能力。用于限制CC-Notification 的消息发送量，防止发送量过大时，系统压力过大而导致SMSC侧发生异常。取值范围：2-5位以内数字。 **默认值**：16，一般设置为16的倍数。 - 事务超时时间（毫秒）：短信设备发送一个消息后，等待对端响应的最大时长。如果在此时间内，对端没有发送对这个消息的响应，则短信设备不再等待。取值范围：0-10位以内数字，取值必须小于"心跳间隔（毫秒）"和"接收超时时间（毫秒）"。 **默认值**：6000，单位：毫秒。 - 最大消息长度（字节）：必填项，协议规定的整个消息的长度。取值范围：1-5位以内数字。 **默认值**：2048，单位：字节。 - 超长短信拆分方式：必填项，短信内容超过"最大内容长度（字节）"时短信的拆分方式。取值范围： - 禁止拆分：对于超长短信不执行发送，并在CC-Notification侧抛出异常。 - 不拆分：不判断短信是否超长，直接执行发送。 - 物理拆分：将超长短信按"最大内容长度（字节）"进行分段，拆分成多条独立的短信发送。 - 超长拆分：将超长短信拆分成多条连锁短信发送，即系统在拆分后的短信中添加子消息组合控制信息。支持连锁短信的终端可以将这些子消息重新组合成一条完整的短信。 **默认值**：禁止拆分。 - 最大内容长度（字节）：必填项，根据协议规定的消息的内容长度。在对长消息进行拆分时，以该参数为标准进行拆分。取值范围：1-5位以内数字。 **默认值**：140，单位：字节。 - 发送线程池最小数：必填项，使用协议栈发送消息时，线程池的最小启动线程数。取值范围：1-5位以内数字。 **默认值**：20。 - 发送线程池最大数：必填项，使用协议栈发送消息时，线程池能达到的最大线程数。取值范围：1-5位以内数字。 **默认值**：200。 - 发送线程池队列长度：必填项，在发送线程池中，等待线程处理队列的长度。取值范围：1-5位以内数字。 **默认值**：2000。 - 接收线程池最小数：必填项，状态报告接收线程的最小数量。接收线程池要以发送线程池为参考进行配置，不要求完全相等。取值范围：1-5位以内数字。 **默认值**：20。 - 接收线程池最大数：必填项，状态报告接收线程的最大数量。取值范围：1-5位以内数字。 **默认值**：200。 - 接收线程池队列长度：必填项，状态报告接收线程的队列长度。取值范围：1-5位以内数字。 **默认值**：2000。 - 最大接收速率：使用协议接收消息的最大速率。取值范围：空、正数。取值为空时，"最大发送速率"、"超流量处理策略"必须一致为空。 - 最大发送速率：使用协议发送短信的最大速率。取值范围：空、正数。取值为空时，"最大接收速率"、"超流量处理策略"必须一致为空。 - 超流量处理策略：超流量发送处理策略。取值范围：空、正数。取值为空时，"最大接收速率"、"最大发送速率"必须一致为空。 - 长短信合并模式：必填项，长短信合并模式。取值范围：GSM用户数据头、SMPP参数。 **默认值**：GSM用户数据头 - 消息协议参数配置：缺省填入，用户可根据自身需要额外修改。 图5网关地址对接配置-消息协议参数配置 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001725324434.png) - ESME类型：标识ESME（External Short Message Entity）的类型。取值范围：字符串长度\<=13。 详细取值建议参考SMPP协议bind消息system_type字段的说明。 - ESME地址类型编号：扩展短信实体的地址类型编号。取值范围：2^8^以内的正整数。 详细取值建议参考SMPP协议bind消息addr_ton字段的说明。 - ESME地址编码方式：扩展短信实体的地址编码方式。取值范围：0～10位数字。 详细取值建议参考SMPP协议bind消息addr_npi字段的说明。 - ESME地址范围：扩展短信实体的地址编码方式。取值范围：字符串长度\<=15。 详细取值建议参考SMPP协议bind消息address_range字段的说明。 - 服务类型：网关指定的用于指明短信的SMS应用服务。取值范围：字符串长度\<=500。 详细取值建议参考SMPP协议submit_sm/data_sm消息service_type字段的说明。 - 源地址编码类型：必填项，指定SMPP SubmitMessage中源地址的编码类型。取值范围：1-10位数字。 **默认值**：0。详细取值建议参考SMPP协议submit_sm/data_sm消息source_addr_ton字段的说明。 - 源地址编码方案：必填项，指定SMPP SubmitMessage中源地址的编码方案。取值范围：1-10位数字。 **默认值**：0。详细取值建议参考SMPP协议submit_sm/data_sm消息source_addr_npi字段的说明。 - 目的地址编码类型：必填项，指定SMPP SubmitMessage中目的地址的编码类型。取值范围：1-10位数字。 **默认值**：0。详细取值建议参考SMPP协议submit_sm/data_sm消息dest_addr_ton字段的说明。 - 目的地址编码方案：必填项，指定SMPP SubmitMessage中目的地址的编码方案。取值范围：1-10位数字。 **默认值**：0。详细取值建议参考SMPP协议submit_sm/data_sm消息dest_addr_npi字段的说明。 - 信息类型：必填项，表明该消息的类型。取值范围：1-10位数字。 **默认值**：0。详细取值建议参考SMPP协议submit_sm/data_sm消息esm_class字段的说明。 - 信息格式：必填项，短信内容的编码方式。取值范围： - ASCII串：一个字符占一个字节。 - 二进制信息。 - UCS2编码：ISO/IEC-10646，所有消息字符都占两个字节。 **默认值**：ASCII串。 - 协议标识：必填项，GSM协议的编号。取值范围：1-10位数字。 默认值：0。详细取值建议参考SMPP协议submit_sm消息data_coding字段的说明。 - 返回状态确认报告：必填项，定义返回哪些状态报告。取值范围： - 0：不接收状态报告。 - 1：返回失败和成功的状态报告。 - 2：返回失败的状态报告。 **默认值**：2。 - 替换标识：必填项，是否替换现存的源地址、目标地址字段都相同的短信。取值范围：不替换、替换。 **默认值**：不替换。 - 默认消息ID：必填项，预定义短信ID，是消息中心管理者建立的预定义短信的索引。取值范围：字符串长度\<=500。 **默认值**：0。详细取值建议参考SMPP协议submit_sm消息sm_default_msg_id字段的说明。 4. 网关对接信息配置完成后，单击"保存"，创建网关配置完成。 #### 后续操作 - 重建网关。 1. 选择"配置中心 \> 系统管理 \> 网关监控"。 2. 单击"重建"。 - 断开连接失败的网关。 1. 选择"配置中心 \> 系统管理 \> 网关监控"。 2. 单击"断开"。