管理全局 web 挂钩

关于全局 web 挂钩

当企业内部发生事件时，您可以使用全局 web 挂钩通知外部 Web 服务器。 您可以将服务器配置为接收 web 挂钩的有效负载，然后运行监控、响应或实施企业用户和组织管理规则的应用程序或代码。 有关详细信息，请参阅“Webhook”。

例如，你可以将 你的 GitHub Enterprise Server 实例 配置为在有人创建、删除或修改企业内的存储库或组织时发送 Webhook。 您可以将服务器配置为在收到 web 挂钩后自动执行任务。

还可以使用 GitHub Enterprise Server APIs 来管理全局 Webhook。 有关操作的完整列表，请参阅“GitHub Enterprise 管理”。

添加全局 web 挂钩

1. 在 GitHub Enterprise Server 的右上角，单击你的个人资料照片，然后单击“企业设置”。 1. 在企业帐户边栏中，单击“设置”。 1. 在“ 设置”下，单击“挂钩”。

2. 单击“添加 Webhook” 。

3. 在“有效负载 URL”字段中，键入要接收有效负载的 URL。

4. （可选）选择“内容类型”下拉菜单，然后单击一种数据格式以接收 Webhook 有效负载。

5. （可选）在“机密”字段中，键入用作 secret 密钥的字符串。

6. （可选）如果有效负载 URL 为 HTTPS，并且你不希望 GitHub Enterprise Server 在传递有效负载时验证 SSL 证书，请选择“禁用”。 阅读有关 SSL 验证的信息，然后单击“禁用，我已了解我的 Webhook 可能不安全”。

   警告：SSL 验证有助于确保安全传递挂钩有效负载。 我们不建议禁用 SSL 验证。

7. 在“希望哪些事件触发此 Webhook？”下，选择是否希望此 Webhook 针对每个事件或选定事件触发。

   • 对于每个事件，请选择“向我发送所有内容”。
   • 要选择特定事件，请选择“让我选择单个事件”。

8. 如果选择单个事件，请选择将触发 web 挂钩的事件。

9. 要在添加配置后使 Webhook 处于活动状态，请选择“活动”。

10. 单击“添加 Webhook” 。

编辑全局 web 挂钩

1. 在 GitHub Enterprise Server 的右上角，单击你的个人资料照片，然后单击“企业设置”。 1. 在企业帐户边栏中，单击“设置”。 1. 在“ 设置”下，单击“挂钩”。

2. 在想要编辑的 Webhook 旁，单击“编辑”。

   

3. 更新 web 挂钩的设置。

4. 单击“更新 Webhook”。

删除全局 web 挂钩

1. 在 GitHub Enterprise Server 的右上角，单击你的个人资料照片，然后单击“企业设置”。 1. 在企业帐户边栏中，单击“设置”。 1. 在“ 设置”下，单击“挂钩”。
2. 在想要删除的 Webhook 旁，单击“删除”。
3. 阅读有关删除 Webhook 的信息，然后单击“是，删除 Webhook”。

查看最近的交付和回复

1. 在 GitHub Enterprise Server 的右上角，单击你的个人资料照片，然后单击“企业设置”。 1. 在企业帐户边栏中，单击“设置”。 1. 在“ 设置”下，单击“挂钩”。

2. 在 Webhook 列表中，单击要查看其交付的 Webhook 的 URL。

   

3. 在“最近交付”下，单击交付 GUID 以查看详细信息。