配置短信网关

租户管理员通过配置短信网关，实现发送和接收短信的功能。

背景信息

当对接短信网关的用户密码发生变化时，请同步修改AICC侧配置，修改方式：选择“配置中心 > 接入配置 > 网关配置”，单击待修改列的网关对应的“编辑”，单击消息协议参数配置，输入修改后的登录口令。

操作步骤

以租户管理员角色登录客户服务云，选择“配置中心 > 接入配置 > 网关配置”，配置网关信息。

图1 网关配置
单击“新建”，进入新增网关配置页面。

图2 配置网关-基本信息
信息配置完成后，单击“下一步”，进入网关地址对接配置。
- 基础配置：用户需要填写的配置项。
  图3 网关地址对接配置-基础配置
  - 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）、特殊符号（+、-）。
    发送号码前缀规则：例如配置130则匹配130开头的号码，多个号码以英文分号分隔。
  - 接收号码前缀：必填项，网关配置的允许接收号码段前缀。取值范围：字母（a～z、A～Z）、数字（0～9）、特殊符号（+、-）。
    发送号码前缀规则：例如配置130则匹配130开头的号码，多个号码以英文分号分隔。
  - 默认发送号码：网关默认的发送号码。取值范围：字母（a～z、A～Z）、数字（0～9）、特殊符号（+、-）。
- ESME连接配置：缺省填入，用户可根据自身需要额外修改。
  图4 网关地址对接配置-ESME连接配置
  - 客户端端口：必填项，指定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 网关地址对接配置-消息协议参数配置
  - ESME类型：标识ESME（External Short Message Entity）的类型。取值范围：字符串长度<=13。
    详细取值建议参考SMPP协议bind消息system_type字段的说明。
  - ESME地址类型编号：扩展短信实体的地址类型编号。取值范围：2⁸以内的正整数。
    详细取值建议参考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字段的说明。
网关对接信息配置完成后，单击“保存”，创建网关配置完成。