本文介绍如何在飞连管理后台订阅事件,以及如何管理存量事件订阅。
添加事件订阅
登录飞连管理后台。
在左侧导航栏,选择集成管理 > 事件订阅。
在事件订阅页面右侧,单击添加事件订阅。
在选择类型弹窗,选中 Webhook 并单击确定。
说明
目前仅支持 Webhook 订阅方式,该方式需要企业提供用于接收事件数据的服务器地址,后续当订阅的事件被触发时,飞连系统向服务器地址发送 HTTP 请求,请求内包含事件数据。
在 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 Token 与 Encrypt Key 的用法说明,请参见接收事件。 |
完成配置后,在页面底部单击确定。
注意
单击后系统会校验您填写的请求地址的有效性,如果校验失败,会在请求地址输入框下方提供报错信息,您需要修改为正确的服务器请求地址后重试。
管理事件订阅
添加事件订阅后,返回事件订阅功能页,在该页面可以管理维护存量的事件订阅。

在列表右侧,分别支持以下操作:
- ①:单击删除,经过二次确认后会删除当前事件订阅。
注意
删除后事件订阅立即失效,且不可恢复,请谨慎操作。
- ②:单击详情,进入事件订阅详情页面。
- 在相应区域可查看或修改事件订阅的配置项。

- 在审计日志页签,可查看事件触发的日志详情。
支持设置外发时间、返回状态等过滤条件筛选日志信息;支持单击刷新,手动刷新日志数据。

- ③:当前事件订阅的生效开关,只有开启状态的事件订阅配置会生效。