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 Enterprise Server インスタンス を構成できます。 Webhook を受信した後でタスクを自動的に実行するようにサーバーを構成できます。

REST API を使用してグローバル Webhook を管理することもできます。 エンドポイントの完全なリストについては、「グローバル Webhook」を参照してください。

グローバルwebhookの追加

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

    GitHub Enterprise Server のプロファイル写真をクリックしたときに表示されるドロップダウン メニューのスクリーンショット。 [エンタープライズ設定] オプションが濃いオレンジ色の枠線で強調表示されています。 1. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。

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

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

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

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

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

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

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

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

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

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

グローバルwebhookの編集

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

    GitHub Enterprise Server のプロファイル写真をクリックしたときに表示されるドロップダウン メニューのスクリーンショット。 [エンタープライズ設定] オプションが濃いオレンジ色の枠線で強調表示されています。 1. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。

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

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

  3. webhookの設定の更新。

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

グローバルwebhookの削除

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

    GitHub Enterprise Server のプロファイル写真をクリックしたときに表示されるドロップダウン メニューのスクリーンショット。 [エンタープライズ設定] オプションが濃いオレンジ色の枠線で強調表示されています。 1. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。

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

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

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

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