Skip to main content

管理全局 web 挂钩

您可以配置全局 web 挂钩,以便在企业内部发生事件时通知外部 Web 服务器。

谁可以使用此功能

Enterprise owners can manage global webhooks for an enterprise account.

关于全局 web 挂钩

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

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

添加全局 web 挂钩

  1. 在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的企业”。

  2. 在企业列表中,单击您想要查看的企业。

  3. 在企业帐户边栏中,单击“设置”。

  4. 在“ 设置”下,单击“挂钩”。

  5. 单击“添加 Webhook” 。

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

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

  8. (可选)在“机密”字段中,键入用作 secret 密钥的字符串。

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

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

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

    • 对于每个事件,请选择“向我发送所有内容”。
    • 要选择特定事件,请选择“让我选择单个事件”。
  11. 如果选择单个事件,请选择将触发 web 挂钩的事件。

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

  13. 单击“添加 Webhook” 。

编辑全局 web 挂钩

  1. 在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的企业”。

  2. 在企业列表中,单击您想要查看的企业。

  3. 在企业帐户边栏中,单击“设置”。

  4. 在“ 设置”下,单击“挂钩”。

  5. 在想要编辑的 Webhook 旁,单击“编辑”。

    “Webhook”页面的屏幕截图。 在 Webhook 的右侧,“编辑”按钮以橙色轮廓突出显示。

  6. 更新 web 挂钩的设置。

  7. 单击“更新 Webhook”。

删除全局 web 挂钩

  1. 在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的企业”。

  2. 在企业列表中,单击您想要查看的企业。

  3. 在企业帐户边栏中,单击“设置”。

  4. 在“ 设置”下,单击“挂钩”。

  5. 在想要删除的 Webhook 旁,单击“删除”。 “Webhook”页面的屏幕截图。 在 Webhook 的右侧,“删除”按钮以橙色轮廓突出显示。

  6. 阅读有关删除 Webhook 的信息,然后单击“是,删除 Webhook”。

查看最近的交付和回复

可以查看过去 30 天内发生的 Webhook 交付的详细信息。 有关详细信息,请参阅“查看 web 挂钩交付”。