机器人渠道用于管理企业推送的各个渠道,方便与企业联系。为了多渠道为企业发送告警信息和审批通知,Quick BI新增推送消息的渠道,您可以根据需要配置接收消息的外部端口,测试连通后,推送消息将发送至您配置的外部端口中。本文为您介绍如何配置自定义渠道。
新建自定义渠道
登录Quick BI控制台。
在Quick BI产品首页,按照下图指引,进入新建自定义渠道页面。
在新建自定义渠道对话框,配置以下参数。
参数
描述
名称
输入自定义渠道名称。
推送地址
输入目标自定义渠道的接口地址,用于接收信息的推送。
设置的接口地址必须支持
POST
请求方式。请求添加密钥
输入目标自定义渠道的加签密钥,用于对请求进行验签。
您可以手动输入密钥,或者单击自动生成密钥,自动生成密钥并填入Quick BI中。
业务方需要对收到的内容进行验签处理,详细请参见附:外部系统接收与验签方式。
单击保存并测试。
保存成功后,您可以在机器人渠道列表中,看到新创建的自定义渠道。
接收告警时启动并配置自定义渠道
监控指标时,您可以在配置告警方式的自定义渠道中,添加新创建的自定义渠道。
在Quick BI首页,按照下图指引,进入指标监控页面。
在监控告警设置对话框,当告警方式选择自定义渠道时,可以在自定义渠道中看到新创建的自定义渠道。
详情请参见配置监控告警。
在对外审批电子流中配置自定义渠道
组织管理员可以外部审批渠道中,选择新创建的自定义渠道。
在配置管理页面,按照下图指引,新建自定义渠道。
在协同配置页面,按照下图指引,启用自定义审批渠道。
此时,用户申请Quick BI的资源权限时,自定义渠道也能收到申请通知。
附:外部系统接收与验签方式
实际应用时,Quick BI以POST
的方式进行内容推送,并在请求中添加如下内容,用户系统接收到推送的内容后,可根据实际需要对比sign
的值进行验签处理。
请求头:
X-TaskId,即任务ID,用户可以使用该ID唯一确认1次任务请求,可以进行重复性校验(即进行重复过滤)或者在出现异常时提供给Quick BI业务人员进行问题定位。
请求参数:
timestamp
:时间戳nonce
:随机串sign
:验签信息
上述请求参数,主要出于安全考虑,当用户系统接收时可以进行防重放和防篡改的校验。具体签名的生成方式如下:
sign = SHA256.digest(timestamp + nonce + token)
其中,token
的值为创建时生成的请求添加密钥,业务接收方需要校验生成的sign
是否与预期一致。