You need to enable JavaScript to run this app.
导航
订阅事件
最近更新时间:2025.03.28 09:56:52首次发布时间:2025.03.28 09:56:52
我的收藏
有用
有用
无用
无用

本文介绍如何在飞连管理后台订阅事件,以及如何管理存量事件订阅。

添加事件订阅
  1. 登录飞连管理后台。

  2. 在左侧导航栏,选择集成管理 > 事件订阅

  3. 在事件订阅页面右侧,单击添加事件订阅

  4. 选择类型弹窗,选中 Webhook 并单击确定

    说明

    目前仅支持 Webhook 订阅方式,该方式需要企业提供用于接收事件数据的服务器地址,后续当订阅的事件被触发时,飞连系统向服务器地址发送 HTTP 请求,请求内包含事件数据。

  5. Webhook 页面,完成以下配置。

    配置模块

    配置说明

    基本信息

    • 事件订阅名称:必填,自定义名称,用于标识当前事件订阅。
    • 事件订阅说明:选填,自定义添加事件订阅的描述信息。

    事件订阅

    您需要配置请求地址和订阅事件列表,当订阅的事件触发时,飞连系统会向您配置的请求地址推送事件数据。因此您需要在本地搭建或改造出一个用于接收飞连事件的服务器,且需要保证该服务器可以与飞连管理后台互相访问(例如,您的飞连只能通过公网通信,则该服务器地址需要是公网可访问的地址)。

    • 请求地址:用于接收事件数据的服务器地址,仅支持 HTTP 或 HTTPS 协议。填写后,在页面底部单击确定时,飞连系统会向其发送一个 HTTP POST 请求,以验证地址的有效性。请求格式为 JSON,包含一个 CHALLENGE 参数。接收此请求后,需要解析出 CHALLENGE 值,并在 1 秒内回复 CHALLENGE 值。该验证请求的 JSON 示例如下:

      {
        "challenge": "abc1234-xxxx-xxxx-xxxx-abc1234567",
        "token": "tokendemo",
        "type": "url_verification"
      }
      

      注意

      如果配置了加密策略的 Encrypt Key 参数, 则飞连推送的验证请求为加密后的 POST 请求,您需要先解密,从解密后的数据中提取 CHALLENGE 值,再在 1 秒内回复 CHALLENGE 值。解密操作请参见解密事件

    • 订阅事件:选择需要订阅的事件。

    加密策略

    您可以选择配置加密策略来加密传输事件数据,确保企业敏感信息不被泄露,且可以校验请求是否来自飞连系统。

    • Verification Token:事件的验证标识,飞连推送的事件数据内包含该参数值,您可以通过该参数验证请求是否来自飞连。必填参数,支持自定义或者单击输入框右侧的重置,自动生成值。
    • Encrypt Key:配置该参数后,飞连向请求地址推送的事件数据会进行加密。建议配置该参数,以提高数据传输的安全性。选填参数,支持自定义或者单击输入框右侧的重置,自动生成值。

    Verification TokenEncrypt Key 的用法说明,请参见接收事件

  6. 完成配置后,在页面底部单击确定

    注意

    单击后系统会校验您填写的请求地址的有效性,如果校验失败,会在请求地址输入框下方提供报错信息,您需要修改为正确的服务器请求地址后重试。

管理事件订阅

添加事件订阅后,返回事件订阅功能页,在该页面可以管理维护存量的事件订阅。
Image
在列表右侧,分别支持以下操作:

  • ①:单击删除,经过二次确认后会删除当前事件订阅。

    注意

    删除后事件订阅立即失效,且不可恢复,请谨慎操作。

  • ②:单击详情,进入事件订阅详情页面。
    • 在相应区域可查看或修改事件订阅的配置项。
      Image
    • 审计日志页签,可查看事件触发的日志详情。
      支持设置外发时间、返回状态等过滤条件筛选日志信息;支持单击刷新,手动刷新日志数据。
      Image
  • ③:当前事件订阅的生效开关,只有开启状态的事件订阅配置会生效。