Skip to main content

管理全局 web 挂钩

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

Who can use this feature

Enterprise owners can manage global webhooks for an enterprise account.

关于全局 web 挂钩

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

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

全局 web 挂钩列表

您也可以使用 the GitHub Enterprise Server APIs 来管理全局 web 挂钩。 有关操作的完整列表,请参阅“全局 Webhook”。

添加全局 web 挂钩

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

  2. 单击“添加 Webhook” 。 管理中心内“Webhook”页面上的“添加 Webhook”按钮

  3. 输入您想要接收有效负载的 URL。 用于键入有效负载 URL 的字段

  4. (可选)使用“内容类型”下拉菜单,并单击一个有效负载格式。 列出内容类型选项的下拉菜单

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

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

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

  7. 确定您希望此 web 挂钩对每个事件还是选定事件触发。 包含用于为每个事件或选定事件接收有效负载的选项的单选按钮

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

  9. 确认选中了“活动”复选框。 已选择的“活动”复选框

  10. 单击“添加 Webhook” 。

编辑全局 web 挂钩

  1. 在 GitHub Enterprise Server 的右上角,单击你的个人资料照片,然后单击“企业设置”。 GitHub Enterprise Server 上个人资料照片下拉菜单中的“企业设置” 1. 在企业帐户侧边栏中,单击 “设置”。 企业帐户侧边栏中的“设置”选项卡 1. 在“ 设置”下,单击“挂钩”。 企业帐户设置边栏中的“挂钩”选项卡
  2. 在想要编辑的 Webhook 旁,单击“编辑”。 Webhook 旁的“编辑”按钮
  3. 更新 web 挂钩的设置。
  4. 单击“更新 Webhook”。

删除全局 web 挂钩

  1. 在 GitHub Enterprise Server 的右上角,单击你的个人资料照片,然后单击“企业设置”。 GitHub Enterprise Server 上个人资料照片下拉菜单中的“企业设置” 1. 在企业帐户侧边栏中,单击 “设置”。 企业帐户侧边栏中的“设置”选项卡 1. 在“ 设置”下,单击“挂钩”。 企业帐户设置边栏中的“挂钩”选项卡
  2. 在想要删除的 Webhook 旁,单击“删除”。 Webhook 旁的“删除”按钮
  3. 阅读有关删除 Webhook 的信息,然后单击“是,删除 Webhook”。 包含警告信息的弹出框和用于确认删除 Webhook 的按钮

查看最近的交付和回复

  1. 在 GitHub Enterprise Server 的右上角,单击你的个人资料照片,然后单击“企业设置”。 GitHub Enterprise Server 上个人资料照片下拉菜单中的“企业设置” 1. 在企业帐户侧边栏中,单击 “设置”。 企业帐户侧边栏中的“设置”选项卡 1. 在“ 设置”下,单击“挂钩”。 企业帐户设置边栏中的“挂钩”选项卡
  2. 在 web 挂钩列表中,单击您想要查看其投递的 web 挂钩。 包含用于查看每个 Webhook 的链接的 Webhook 列表
  3. 在“Recent deliveries”下,单击投递以查看详细信息。 包含用于查看详细信息的链接的 Webhook 最近交付列表