HTTP Webhook 集成是连接联机帐户以在触发事件发生时接收自动消息的常用方法。 通过互联网监控,您可以使用唯一的 Webhook URL 将带有警报通知的有效负载从您的互联网监控器帐户推送到另一个应用程序。 每次网络监控生成监控报警时,报警系统都会自动将报警通知推送到提供的网页钩子URL。

您可以自定义请求参数以定义警报消息的特定内容。 您可以发送静态文本消息、基于 Razor 语法推送动态有效负载或使用预定义 的警报模板。 此外,可以使用 Razor 语法和预定义的模板将其他信息与 HTTP 标头一起发送,并自定义身份验证凭据。

配置 HTTP 网络钩子通知地址

让我们分解一下 HTTP 网络钩子地址的设置过程。

首先,在应用程序中创建新的 Webhook。 接下来,在网络监视器帐户的警报组设置中,选择 HTTP 网络挂钩 地址类型。 在地址设置中,提供 Webhook URL 并选择系统将用于将带有警报通知消息的有效负载推送到 Webhook URL 的 HTTP 方法。

认证

如果收件人服务器要求对所有传入请求进行身份验证,则可以在“身份验证”部分中提供登录凭据。 凭据将与请求一起传递到 Webhook URL。

以下类型的 Webhook 身份验证可用:

  • 自动 – 将根据收件人服务器的响应自动选择身份验证类型。
  • NTLM – 允许对使用 NTLM 身份验证协议的网络的请求进行身份验证。
  • 摘要 – 允许对需要摘要式身份验证的 Web 服务器的请求进行身份验证。
  • 基本 – 允许发送登录名和密码字段以及 HTTP 请求的标头。

请注意,一旦选择了除“自动”之外的任何其他身份验证方法,则无论收件人服务器要求如何,Dotcom 监视器都将使用所选方法。 在选择特定方法之前,请确保您的 Web 服务器支持该方法。

请注意,您可以传递动态凭据以及静态登录密码对。 要自定义身份验证凭据,请单击相应输入字段开头的下拉菜单图标,然后选择要添加的内容类型。 有关配置自定义身份验证参数的更多详细信息,请参阅本文的 如何设置 HTTP Webhook 请求参数 部分。

若要随请求一起发送自定义标头,请展开“ 标头 ”部分,单击“ 添加 ”并提供新的标头参数。

如果需要在标头中传递自定义信息(例如警报服务器时间),请单击参数值字段开头的下拉菜单图标,然后选择要添加的内容类型。

发布数据

要创建通知消息,请选择请求正文内容的 数据类型

  • 无 – 选择发送正文中没有有效负载的请求。
  • 表单数据 – 选择将通知消息作为静态名称-值集合发送。
  • 表单 URL 编码 – 选择在 HTTP 请求正文中发送 URL 编码的消息。
  • 原始 – 选择在 HTTP 请求正文中以“原始”数据(JSON、XML、HTML、TXT)的形式发送消息。继续使用 “内容类型”

默认情况下,我们使用以下内容类型标头值:

表单网址编码:应用程序/x-www-form-urlencoded
表单数据:多部分/表单数据;边界={Dynamically-Generated-Boundary}

生:

文本:文本/html
Json: application/json
文本:文本/纯文本
Xml: application/xml

如果需要使用自定义内容类型标头发送通知,请在 Webhook 地址设置的 “标头 ”部分中指定它。

要自定义消息内容,请单击请求正文输入字段开头的下拉菜单图标,选择要在正文中发送的数据类型,然后添加将推送到目标 Web 应用程序的消息内容。

如何自定义 HTTP 网络钩子请求参数

互联网监控为用户提供了多种选项来支持通知请求定制。 根据您的目标和 Web 应用程序服务器要求,您可以使用提供的数据类型之一灵活地个性化通知消息和其他请求参数。

Alert Template

警报模板不仅可以存储警报消息内容,还可以存储要在多个 Webhook 地址的参数中使用的任何类型的内容。 如果您需要创建新的可重用模板,请按照此wiki的 警报模板:设置和配置(文本 &HTML & JSON) 一文中所述创建一个模板。

要选择预配置的模板,请单击输入字段,然后从列表中选择模板。

静态内容

如果需要将静态数据与请求参数一起传递,请选择“静态”选项。 您可以在输入字段中输入内容。

动态内容

可以使用动态变量对警报消息和其他请求参数值进行个性化设置。 互联网监控器将在发送警报通知时将当前系统值传递给关联的变量。 Dotcom-Monitor 动态模板是使用 微软的 Razor 解析引擎实现的 ,可以从消息输入字段中创建。 请参阅将动态变量 添加到警报模板 知识库一文,了解如何使用动态变量。

如果要利用之前创建的警报模板或使用我们预定义的 HTML 代码段,请展开消息输入字段并使用消息编辑器,如知识库的 警报模板:设置和配置(文本 & HTML &JSON) 一文中所述。