全部产品
Search
文档中心

:自定义渠道

更新时间:May 22, 2024

机器人渠道用于管理企业推送的各个渠道,方便与企业联系。为了多渠道为企业发送告警信息和审批通知,Quick BI新增推送消息的渠道,您可以根据需要配置接收消息的外部端口,测试连通后,推送消息将发送至您配置的外部端口中。本文为您介绍如何配置自定义渠道。

新建自定义渠道

  1. 登录Quick BI控制台

  2. 在Quick BI产品首页,按照下图指引,进入新建自定义渠道页面。

    image

  3. 新建自定义渠道对话框,配置以下参数。

    image.png

    参数

    描述

    名称

    输入自定义渠道名称。

    推送地址

    输入目标自定义渠道的接口地址,用于接收信息的推送。

    设置的接口地址必须支持POST请求方式。

    请求添加密钥

    输入目标自定义渠道的加签密钥,用于对请求进行验签。

    您可以手动输入密钥,或者单击自动生成密钥,自动生成密钥并填入Quick BI中。

    业务方需要对收到的内容进行验签处理,详细请参见附:外部系统接收与验签方式

  4. 单击保存并测试

    保存成功后,您可以在机器人渠道列表中,看到新创建的自定义渠道。image.png

接收告警时启动并配置自定义渠道

监控指标时,您可以在配置告警方式的自定义渠道中,添加新创建的自定义渠道。

  1. 在Quick BI首页,按照下图指引,进入指标监控页面。

    image.png

  2. 监控告警设置对话框,当告警方式选择自定义渠道时,可以在自定义渠道中看到新创建的自定义渠道。

    image.png详情请参见配置监控告警

在对外审批电子流中配置自定义渠道

组织管理员可以外部审批渠道中,选择新创建的自定义渠道。

  1. 在配置管理页面,按照下图指引,新建自定义渠道。image

  2. 在协同配置页面,按照下图指引,启用自定义审批渠道。

    image

    此时,用户申请Quick BI的资源权限时,自定义渠道也能收到申请通知。

附:外部系统接收与验签方式

实际应用时,Quick BI以POST的方式进行内容推送,并在请求中添加如下内容,用户系统接收到推送的内容后,可根据实际需要对比sign的值进行验签处理。

  • 请求头

    X-TaskId,即任务ID,用户可以使用该ID唯一确认1次任务请求,可以进行重复性校验(即进行重复过滤)或者在出现异常时提供给Quick BI业务人员进行问题定位。

  • 请求参数

    • timestamp:时间戳

    • nonce:随机串

    • sign:验签信息

上述请求参数,主要出于安全考虑,当用户系统接收时可以进行防重放和防篡改的校验。具体签名的生成方式如下:

sign = SHA256.digest(timestamp + nonce + token)
说明

其中,token的值为创建时生成的请求添加密钥,业务接收方需要校验生成的sign是否与预期一致。