打开 PhishER Settings 的 Webhook 子选项卡,可创建网络钩子,将 PhishER 平台连接至您使用的其他平台。网络钩子,又称 HTTP 推送 API,是让应用程序向其他应用程序提供实时信息的一种方式。当消息由 PhishER 特定操作触发时,网络钩子能让您将消息中的数据发送至其他应用程序。
将网络钩子与 PhishER 平台集成之后,可创建 PhishER 操作并选择 Send to Webhook 选项。通过此选项,PhishER 可向您组织的网络钩子发送受该操作影响的已报告消息。触发操作后,可单击 PhishER Inbox 中的相关消息,并查看该消息被发送至哪个网络钩子。
提示:如果您使用 Tines,则可设置网络钩子,以便在用户通过 Phish Alert Button (PAB) 报告电子邮件时,随时向 Tines 平台发送消息。有关更多信息,请参阅文章 Tines 与 PhishER 网络钩子的集成。
创建新的网络钩子
要将新的网络钩子连接至 PhishER 平台,请按照以下步骤操作:
- 登录您的 PhishER 平台。
- 选择 Settings > Webhook。
- 单击页面右上角的 New Webhook 按钮,打开 Add Webhook Settings 弹出窗口。
- 在打开的 Add Webhook Settings 弹出窗口中,配置网络钩子设置。如需详细了解这些设置,请查看以下截图和列表:
- Name:在此字段中,为网络钩子输入一个自定义名称。
- URL:在此字段中,输入您要回调的 URL。有关与 PhishER 兼容的 URL 改写器和缩短器的列表,请参阅文章 PhishER 常见问题解答。
- Authorization:在此下拉菜单中,选择下列任一协议:No Auth、API Key、Bearer Token 或 Basic Auth。
-
Available Data:选择要发送至网络钩子的一种或多种数据类型。
注意:Addresses 数据类型会发送网络钩子有效载荷中的所有电子邮件地址,包括 From、To、CC、Reply To 和 Reported By 字段中的电子邮件地址。
- Custom Data:要将自定义数据添加至网络钩子的有效载荷,可单击加号图标。然后,填写 key 和 value 字段。例如,如果您的应用程序需要填写“{"System":"PhishER"}”到有效载荷中才能接收数据,您可输入“System”和“PhishER”。
- Custom Headers:若想添加自定义标题,请单击加号图标。然后,填写 key 和 value 字段。例如,如果您的防火墙需要填写“{ "Header" :"PhishER"}”标题才能允许数据通过,您可输入“Header”和“PhishER”。
- Message Tags:在此部分中,若想在使用网络钩子发送数据时让 PhishER 分配标签,请选中 Success 或 Failure 复选框。然后,在已选定复选框旁边的字段中输入标签名称。
- 单击 Create。
管理网络钩子
打开 PhishER Settings 的 Webhook 子选项卡,可连接和管理网络钩子。要更新网络钩子,可单击网络钩子的名称,打开 Update Webhook Settings 弹出窗口。然后,您可更新网络钩子的信息。
有关 Webhook 子选项卡的更多信息,请查看以下截图和列表:
- New Webhook:单击此按钮,可添加新的网络钩子。有关添加新网络钩子的更多信息,请参见本文的上述子部分。
- Name:此列显示了网络钩子的名称。
- URL:此列显示了网络钩子要回调的 URL。
- Selected Data:此列显示了要发送至网络钩子的数据类型。
- Success Tag:此列显示了 PhishER 分配至消息的标签,PhishER 会在网络钩子成功发送数据并接收回调 URL 时分配这些标签。
- Failure Tag:此列显示了 PhishER 分配至消息的标签,PhishER 会在网络钩子无法发送数据并接收回调 URL 时分配这些标签。
- Actions:此列显示了网络钩子条目上可运行的操作。单击垃圾桶图标,可删除条目。