Skip to main content

管理全局 web 挂钩

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

Enterprise owners can manage global webhooks for an enterprise account.

关于全局 web 挂钩

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

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

全局 web 挂钩列表

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

添加全局 web 挂钩

  1. 在 GitHub.com 的右上角,单击您的个人资料照片,然后单击 Your enterprises(您的企业)GitHub Enterprise Cloud 上个人资料照片下拉菜单中的"Your enterprises(您的企业)"

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

  3. 在企业帐户侧边栏中,单击 Settings(设置)企业帐户侧边栏中的“设置”选项卡

  4. 在“ Settings(设置)”下,单击 Hooks(挂钩)企业帐户设置侧边栏中的 Hooks(挂钩)选项卡

  5. 单击 Add webhook(添加 web 挂钩)Webhooks 页面上 Admin center 中的 Add webhook 按钮

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

  7. 或者,使用 Content type 下拉菜单,并单击有效负载格式。 列出内容类型选项的下拉菜单

  8. 或者,在 Secret 字段中,输入用作 secret 密钥的字符串。 用于输入用作密钥的字符串的字段

  9. (可选)如果有效负载 URL 为 HTTPS,并且您不希望 GitHub Enterprise Server 在交付有效负载时验证 SSL 证书,请选择 Disable SSL verification(禁用 SSL 验证)。 阅读 SSL 验证的信息,然后单击 I understand my webhooks may not be secure用于禁用 SSL 验证的复选框

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

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

    • 对于每个事件,请选择 Send me everything
    • 要选择特定事件,请选择 Let me select individual events
  11. 如果选择单个事件,请选择将触发 web 挂钩的事件。

    单个全局 web 挂钩事件的复选框

  12. 确认选中了 Active(活动)复选框。 已选择 Active 复选框

  13. 单击 Add webhook(添加 web 挂钩)

编辑全局 web 挂钩

  1. 在 GitHub.com 的右上角,单击您的个人资料照片,然后单击 Your enterprises(您的企业)GitHub Enterprise Cloud 上个人资料照片下拉菜单中的"Your enterprises(您的企业)"

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

  3. 在企业帐户侧边栏中,单击 Settings(设置)企业帐户侧边栏中的“设置”选项卡

  4. 在“ Settings(设置)”下,单击 Hooks(挂钩)企业帐户设置侧边栏中的 Hooks(挂钩)选项卡

  5. 在您想要编辑的 web 挂钩旁,单击 Editweb 挂钩旁的 Edit 按钮

  6. 更新 web 挂钩的设置。

  7. 单击 Update webhook

删除全局 web 挂钩

  1. 在 GitHub.com 的右上角,单击您的个人资料照片,然后单击 Your enterprises(您的企业)GitHub Enterprise Cloud 上个人资料照片下拉菜单中的"Your enterprises(您的企业)"

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

  3. 在企业帐户侧边栏中,单击 Settings(设置)企业帐户侧边栏中的“设置”选项卡

  4. 在“ Settings(设置)”下,单击 Hooks(挂钩)企业帐户设置侧边栏中的 Hooks(挂钩)选项卡

  5. 在您想要删除的 web 挂钩旁,请单击 Deleteweb 挂钩旁的 Delete 按钮

  6. 阅读有关删除 web 挂钩的信息,然后单击 Yes, delete webhook包含警告信息的弹出框和用于确认删除 web 挂钩的按钮

查看最近的交付和回复

  1. 在 GitHub.com 的右上角,单击您的个人资料照片,然后单击 Your enterprises(您的企业)GitHub Enterprise Cloud 上个人资料照片下拉菜单中的"Your enterprises(您的企业)"

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

  3. 在企业帐户侧边栏中,单击 Settings(设置)企业帐户侧边栏中的“设置”选项卡

  4. 在“ Settings(设置)”下,单击 Hooks(挂钩)企业帐户设置侧边栏中的 Hooks(挂钩)选项卡

  5. 在 web 挂钩列表中,单击您想要查看其投递的 web 挂钩。 包含用于查看每个 web 挂钩的链接的 web 挂钩列表

  6. 在“Recent deliveries”下,单击投递以查看详细信息。 包含用于查看详细信息的链接的 web 挂钩最近投递列表