Skip to main content

グローバルwebhookの管理

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

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

Enterprise owners can manage global webhooks for an enterprise account.

グローバルwebhookについて

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

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

グローバルwebhookの追加

  1. GitHub.com の右上の自分のプロファイル写真をクリックし、 [自分の Enterprise] をクリックします。

  2. Enterpriseのリストで、表示したいEnterpriseをクリックしてください。 1. 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.com の右上の自分のプロファイル写真をクリックし、 [自分の Enterprise] をクリックします。

  2. Enterpriseのリストで、表示したいEnterpriseをクリックしてください。 1. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。

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

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

  4. webhookの設定の更新。

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

グローバルwebhookの削除

  1. GitHub.com の右上の自分のプロファイル写真をクリックし、 [自分の Enterprise] をクリックします。

  2. Enterpriseのリストで、表示したいEnterpriseをクリックしてください。 1. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。

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

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

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

過去 30 日間に発生した Webhook 配信に関する詳細を表示できます。 詳しくは、「webhookの配信の表示」を参照してください。