统一数字底盘微信告警转发

配置举例

资料版本：5W108-20240306

产品版本：E0714

非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。

除新华三技术有限公司的商标外，本手册中出现的其它公司的商标、产品标识及商品名称，由各自权利人拥有。

本文档中的信息可能变动，恕不另行通知。

3.2.2 在统一数字底盘中增加微信公众号·· 9

3.2.3 微信公众平台服务器配置·· 14

3.2.4 配置告警转发规则·· 17

3.2.5 配置外置DNS服务器·· 20

3.3 配置验证·· 22

3.3.1 告警转发至微信公众号·· 22

3.3.2 登录统一数字底盘查看并处理告警信息·· 22

1 介绍

统一数字底盘的微信公众平台特性是对告警信息转发功能的完善，主要体现在当统一数字底盘产生告警时，可以通过微信公众号的方式将告警信息推送给用户。

2 特性使用指南

2.1 使用场合

当设备产生告警信息时，将告警信息通过微信主动推送给用户的场景。

2.2 配置前提

· 设备已被统一数字底盘纳管，且统一数字底盘能够接收设备发出的告警消息。

· 统一数字底盘需已配置DNS地址，DNS地址配置请参见3.2.5 配置外置DNS服务器。

3 配置举例

3.1 组网需求

某公司使用统一数字底盘管理公司网络，公司的部分网络拓扑如图1所示。在管理公司网络的过程中操作员提出了通过微信接收告警信息需求。

图1 公司内部部分网络拓扑

3.2 配置步骤

· 若需申请微信公众号，请前往微信公众平台进行申请注册。具体注册步骤请参考https://kf.qq.com/faq/120911VrYVrA151009eIrYvy.html。

· 若要使用微信告警转发功能，请勿申请主体类型为“个人”的公众号。在申请订阅号时，订阅号主体类型项选择为“个人”，则该类公众号目前无法进行微信认证。

· 本文档以微信认证成功的订阅号为例进行配置步骤介绍。

3.2.1 配置微信订阅号

(1) 输入http://mp.weixin.qq.com网址，进入微信公众平台首页，如图2所示。

图2 微信公众平台首页

(2) 在界面右上角选择“微信扫码登录“或“使用帐号登录”的方式登录微信公众平台。登录成功，进入公众号界面，如图3所示。

图3 公众号

(3) 在公众号界面左侧导航树中单击[设置与开发 > 开发 > 接口权限]菜单项，进入接口权限界面，如图4所示。在该界面确认统一数字底盘微信告警转发功能所需的接口权限已获得。

其中，必须获得的接口权限如下：

¡ 获取access_token

¡ 客服接口

¡ 获取用户列表

¡ 获取用户基本信息

其它接口权限用户可根据需要进行获取。若所需接口的状态为未获得，则单击列表“接口状态”列“未获得”后的图标，查看获得方法。

图4 接口权限

(4) 在公众号界面左侧导航树中单击[设置与开发 > 开发 > 基本配置]菜单项，进入基本配置界面，如图5所示。

图5 基本配置

(5) 单击“公众号开发信息”区域中“开发者密码(AppSecret)”项后的“启用”链接，进入开发者密码设置界面，如图6所示。

图6 开发者密码设置

(6) 使用微信扫码进行身份确认，认证完成后，进入开发者密码设置界面，如图7所示。

图7 密码验证

(7) 输入公众号登录密码，并输入验证码，输入完成后单击<下一步>按钮，进入查看开发者密码界面，如图8所示。

界面参数说明如下：

¡ AppID：开发者ID是公众号开发识别码，配合开发者密码可调用公众号的接口能力，统一数字底盘使用AppID及AppSecret与微信服务器通信。

¡ AppSecret：开发者密码是校验公众号开发者身份的密码，具有极高的安全性。当该页面关闭后，微信公众平台则不再存储和显示AppSecret，建议将复制成功后的AppSecret及AppID保存至文档中以备后续使用。

图8 查看开发者密码

(8) AppSecret及AppID复制并保存完成后，勾选“我已了解AppSecret不再储存在公众平台，并已复制保存好该AppSecret”项，单击<确定并进行下一步>按钮，进入完成开发者设置界面，如图9所示。

图9 完成开发者设置

(9) 单击<完成>按钮，完成开发者设置并返回基本配置界面。若忘记开发者秘密(AppSecret)，可单击“公众号开发信息”区域中“开发者密码(AppSecret)”项后的“重置”链接进行重置，如图10所示。

图10 重置开发者密码

(10) 单击“公众号开发信息”区域中“IP白名单”项后的“配置”链接，进入IP白名单设置界面，在IP白名单的文本框区域输入需要添加为白名单的IP地址，如图11所示。

界面参数说明如下：

IP白名单：通过开发者ID获取access_token接口时，需要设置访问来源IP为白名单。本文档设置为统一数字底盘服务器的公网IP地址，多个IP地址用回车隔开。

图11 添加白名单

(11) 设置完成后，单击<确认修改>按钮，弹出身份验证页面，如图12所示。

图12 身份验证

(12) 身份验证完成后，可以在弹出的界面中查看设置的IP白名单，如图13所示。

图13 查看IP白名单

(13) 单击<关闭>按钮，返回基本配置界面，可单击“IP白名单”项后的“查看”链接对IP白名单进行修改。

3.2.2 在统一数字底盘中增加微信公众号

1. 微信公众号配置

(1) 登录统一数字底盘，单击“系统”页签，单击左侧导航树中的[系统配置 > 微信公众平台 > 公众号]菜单项，进入公众号页面，如图14所示。

图14 公众号

(2) 单击<增加>按钮，进入增加公众号页面，在该页面中配置公众号名称、公众号类型、Token、AppID、AppSecret等信息，如图15所示。

界面参数介绍如下：

¡ 公众号名称：输入公众号名称，由用户自行填写。

¡ 公众号描述：对公众号的描述信息。

¡ 公众号类型：该公众号的类型，可选项为“订阅号”及“服务号”，本文档以订阅号为例进行介绍。

¡ Token：即令牌，统一数字底盘使用Token来判断请求消息是否来自于微信公众平台，此处可随意填写。Token需以字母开头、由字母和数字组成、有效长度为3~32字符，本文档以“qwer123456”为例进行介绍。

¡ AppID及AppSecret：将步骤3.2.1 (7)中保存的AppID及AppSecret填入该界面相应文本框中，该参数必须与步骤3.2.1 (7)中的参数值保持一致。

图15 增加公众号

(3) 配置完成后，单击<确定>按钮，返回公众号页面。单击该页面列表“公众号名称”列中的公众号名称链接，进入公众号详细信息页面，在该页面中可以查看公众号的详细信息，如图16所示。

图16 公众号详细信息

(4) 将该页面中的ID及Token记录下来，以备后续使用。

(5) 单击<返回>按钮，返回公众号页面，单击该页面列表“粉丝列表”列中的粉丝列表链接，进入粉丝列表界面，可以在该界面中查看粉丝列表，如图17所示。

图17 查看粉丝列表

(6) 单击粉丝列表“操作”列中的发送测试消息图标，进入发送测试消息界面，如图18所示。

图18 发送测试消息

(7) 在“消息内容”项后的文本框中输入测试消息，并单击<确定>按钮，给该粉丝发送测试消息。可在左侧导航树中的[系统配置 > 微信公众平台 > 消息记录]菜单项中查看发送测试消息的状态，如图19所示。

图19 消息记录

2. 消息模板配置

(1) 单击左侧导航树中的[系统配置 > 微信公众平台 > 消息模板]菜单项，进入消息模板页面，消息模板用于指定告警信息的公众号及发送给的粉丝用户，如图20所示。

图20 消息模板

(2) 单击<增加>按钮，进入增加消息模板页面，如图21所示。

页面参数说明如下：

¡ 模板名称：消息模板的名称，有效长度为1~32个字符。

¡ 公众号：选择接收来自统一数字底盘告警信息的公众号。

¡ 粉丝列表：选择接收告警信息的用户。

图21 增加消息模板

(3) 消息模板配置完成后，单击<确定>按钮，返回消息模板页面，可在该页面中查看新增加的消息模板，如图22所示。

图22 新增的消息模板

· 若公众号被删除，则该公众号的粉丝也会从统一数字底盘中删除。

· 已被消息模板绑定的公众号无法删除，可通过公众号详细信息查看其绑定的消息模板名称。

· 若粉丝与订阅号在24小时之内没有交互，则订阅号发送测试消息会失败，粉丝在公众号回复消息后即可恢复。

· 若消息模板中指定的粉丝取消关注公众号，则消息模板会将该粉丝的信息删除。

3.2.3 微信公众平台服务器配置

(1) 登录微信公众平台，在公众号界面左侧导航树中选择[设置与开发 > 开发 > 基本配置]选项，进入基本配置界面，如图23所示。

图23 服务器配置

(2) 单击“服务器配置(未启用)”区域右上角的<修改配置>按钮，进入填写服务器配置界面，如图24所示。

界面参数说明如下：

¡ URL：用来接收微信消息和事件的接口URL，必须以http://或https://开头，分别支持80端口和443端口。具体的填写方式根据实际情况填写。本文档以80端口为例，将wechat服务的31234端口映射到公网的80端口，URL填写为：http:// 统一数字底盘服务器的公网IP地址/weChat/WechatServlet/ID。其中，ID为3.2.2 1. (4)中的ID值。

¡ Token：输入步骤3.2.2 1. (3)中设置的Token值。该值必须与步骤3.2.2 1. (3)中设置的Token值保持一致。

¡ EncodingAESKey：用户消息体的加解密，支持手动填写或者随机生成。

¡ 消息加解密方式：根据业务需要自行选择加解密类型，本文档选择“明文模式”。

图24 写服务器配置

(3) 配置完成后，单击<提交>按钮，弹出提示信息界面，单击<确定>按钮，返回基本配置界面，单击“服务器配置(未启用)”区域右上角<启用>按钮，启用服务器配置，结果如图25所示。

图25 启用服务器配置

3.2.4 配置告警转发规则

(1) 登录统一数字底盘，单击“监控”页签，单击左侧导航树中的[告警管理 > 告警转发]菜单项，进入告警转发页面，单击<增加>按钮，进入增加告警转发规则页面，如图26所示。

界面参数说明如下：

¡ 规则名称：告警转发规则的名称，有效长度为1~32字符。

¡ 匹配模式：匹配模式选择符合规则转发，符合当前转发规则的告警会被转发，匹配模式选择不符合规则转发，不符合当前转发规则的告警会被转发。

¡ 启用阶段通知：如果启用阶段通知，告警持续时间符合配置条件的告警会进行转发。

¡ 需要关注的告警级别：勾选一个或多个关注的告警级别，只会转发指定勾选告警级别的告警信息，可选项为“紧急”、“重要”、“次要”、“警告”及“通知”。

¡ 需要关注的资源：可选项为“所有资源”及“选定的资源”，默认选项为“所有资源”，即会转发所有资源产生的告警信息。若选择“选定的资源”，则需要选择资源组或资源，此时只会转发指定资源产生的告警信息，本文档以默认选择“所有资源”为例进行介绍。

¡ 需要关注的告警：可选项为“所有告警”及“选定的告警”，默认选项为“所有告警”，即会转发所有的告警信息。若选择“选定的告警”，则需要选择Trap信息，此时只会转发指定的告警信息。也可对Trap信息进行参数配置，若对选中的Trap信息进行参数配置，则只会转发匹配配置参数值的告警信息，本文档以默认选择“所有告警”为例进行介绍。

图26 增加告警转发配置

(2) 基本信息配置完成后，单击“动作设置”区域的<微信转发>按钮，进入微信转发页面，如图27所示。配置告警时间，可选项为“所有时间”及“自定义时间”，本文档以默认“所有时间”为例进行介绍。

图27 微信转发

(3) 单击<选择>按钮，进入微信转发选择页面，勾选设置好的消息模板，如图28所示。

图28 微信转发选择

(4) 单击<确定>按钮，返回微信转发界面，在该界面可查看增加的消息模板，如图29所示。

图29 增加消息模板完成

(5) 单击<确定>按钮，返回增加告警转发规则页面，在该页面“动作设置”区域列表中可查看增加的微信转发，并进行修改、删除等操作，如图30所示。

图30 增加告警转发规则

(6) 单击<确定>按钮，返回告警转发页面。可以在列表中查看增加的告警规则，并进行启用、修改、删除等操作，如图31所示。

图31 告警转发结果

3.2.5 配置外置DNS服务器

该配置项用户需根据实际组网环境选择进行配置。

(1) 登录Matrix，登录地址为https://北向IP地址:8443/matrix/ui，单击“部署”页签，在左侧导航树中选择“集群”菜单项，切换至“集群参数”页签，进入集群参数页面，如图32所示。

图32 集群参数

(2) 单击<修改>图标，进入修改集群参数页面。勾选“外置DNS服务器”项，单击“增加DNS服务器”项，弹出增加DNS服务器页面，在该页面中配置DNS服务器IP，如图33所示。其中，配置的DNS服务器需包含微信的域名，如果对DNS服务器没有特殊限制或要求，可以配置通用DNS服务器114.114.114.114，配置完成后，单击<应用>按钮保存配置。