Skip to main content
ドキュメントへの更新が頻繁に発行されており、このページの翻訳はまだ行われている場合があります。 最新の情報については、「英語のドキュメント」を参照してください。

グローバルwebhookの管理

Enterprise 内でイベントが発生したときに外部の Web サーバーに通知するように、グローバル Webhook を構成できます。

この機能を使用できるユーザー

Enterprise owners can manage global webhooks for an enterprise account.

グローバルwebhookについて

グローバル Webhook を使用して、企業内で発生したイベントを外部の Web サーバーに通知できます。 Webhook のペイロードを受信した後、企業のユーザーや組織の管理の監視、応答、またはルールの適用を行うアプリケーションまたはコードを実行するように、サーバーを構成できます。 詳しくは、「Webhooks」を参照してください。

たとえば、誰かがエンタープライズ内のリポジトリや組織を作成、削除、または変更したときに Webhook を送信するように、お使いの GitHub Enterprise Server インスタンス を構成できます。 Webhook を受信した後でタスクを自動的に実行するようにサーバーを構成できます。

GitHub Enterprise Server APIs を使ってグローバルな Webhook を管理することもできます。 アクションの完全な一覧については、「GitHub Enterprise の管理」を参照してください。

グローバルwebhookの追加

  1. GitHub Enterprise Server の右上で、ご自分のプロファイル写真をクリックしてから、 [Enterprise 設定] をクリックします。

    A screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  2. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。

  3. [Webhook の追加] を選択します。

  4. [ペイロード URL] フィールドに、ペイロードを受信する URL を入力します。

  5. 必要に応じて、 [コンテンツ タイプ] ドロップダウン メニューを選び、Webhook ペイロードを受信するデータ形式をクリックします。

  6. 必要に応じて、 [シークレット] フィールドに、secret キーとして使用する文字列を入力します。

  7. オプションとして、ペイロードの URL が HTTPS で、ペイロードを配信するときに GitHub Enterprise Server で SSL 証明書が検証されないようにしたい場合は、[SSL の検証] で [無効にする] を選びます。 SSL の検証に関する情報を読んでから、 [無効にします。Webhook が安全ではないかもしれないことを理解しました] をクリックします。

    警告: SSL の検証は、フックのペイロードが安全に配信されることを保証するのに役立ちます。 SSL 検証を無効化することはおすすめしません。

  8. [どのイベントによって、この Webhook をトリガーしますか?] で、この Webhook をすべてのイベントに対して、または選んだイベントに対してトリガーするかを選びます。

    • すべてのイベントの場合は、 [すべて送信する] を選択します。
    • 特定のイベントを選択するには、 [個別のイベントを選択する] を選択します。
  9. 個別のイベントを選択する場合は、Webhook をトリガーするイベントを選択します。

  10. 構成を追加した直後に Webhook をアクティブにするには、 [アクティブ] を選びます。

  11. [Webhook の追加] を選択します。

グローバルwebhookの編集

  1. GitHub Enterprise Server の右上で、ご自分のプロファイル写真をクリックしてから、 [Enterprise 設定] をクリックします。

    A screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  2. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。

  3. 編集する Webhook の横の [編集] をクリックします。

    [Webhook] ページのスクリーンショット。 Webhook の右側にある [編集] ボタンがオレンジ色の枠線で強調表示されています。

  4. webhookの設定の更新。

  5. [Webhook の更新] をクリックします。

グローバルwebhookの削除

  1. GitHub Enterprise Server の右上で、ご自分のプロファイル写真をクリックしてから、 [Enterprise 設定] をクリックします。

    A screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  2. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。

  3. 削除する Webhook の横の [削除] をクリックします。 [Webhook] ページのスクリーンショット。 Webhook の右側にある [削除] ボタンがオレンジ色の枠線で強調表示されています。

  4. Webhook の削除に関する情報を読んでから、 [はい、Webhook を削除します] をクリックします。

最近のデリバリとレスポンスの表示

  1. GitHub Enterprise Server の右上で、ご自分のプロファイル写真をクリックしてから、 [Enterprise 設定] をクリックします。

    A screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  2. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。

  3. Webhook の一覧で、配信を表示する Webhook の URL をクリックします。

    グローバル Webhook の一覧のスクリーンショット。 Webhook を表示するための URL リンクが、オレンジ色の枠線で強調表示されています。

  4. [最近の配信] の下で、詳細を表示する配信 GUID をクリックします。

    グローバル Webhook の [最近の配信] 一覧のスクリーンショット。 配信の一覧で配信 GUID がオレンジ色の枠線で強調表示されています。