グローバルwebhookについて
グローバル Webhook を使用して、企業内で発生したイベントを外部の Web サーバーに通知できます。 Webhook のペイロードを受信した後、企業のユーザーや組織の管理の監視、応答、またはルールの適用を行うアプリケーションまたはコードを実行するように、サーバーを構成できます。 詳しくは、「Webhook ドキュメント」を参照してください。
たとえば、誰かがエンタープライズ内のリポジトリや組織を作成、削除、または変更したときに Webhook を送信するように、お使いの GitHub Enterprise Server インスタンス を構成できます。 Webhook を受信した後でタスクを自動的に実行するようにサーバーを構成できます。
REST API を使用してグローバル Webhook を管理することもできます。 エンドポイントの完全なリストについては、「グローバル Webhook」を参照してください。
グローバルwebhookの追加
-
GitHub Enterprise Server の右上で、ご自分のプロフィール フォトをクリックしてから、 [Enterprise 設定] をクリックします。
1. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。 -
[Webhook の追加] を選択します。
-
[ペイロード URL] フィールドに、ペイロードを受信する URL を入力します。
-
必要に応じて、 [コンテンツ タイプ] ドロップダウン メニューを選び、Webhook ペイロードを受信するデータ形式をクリックします。
-
必要に応じて、 [シークレット] フィールドに、
secret
キーとして使用する文字列を入力します。 -
オプションとして、ペイロードの URL が HTTPS で、ペイロードを配信するときに GitHub Enterprise Server で SSL 証明書が検証されないようにしたい場合は、[SSL の検証] で [無効にする] を選びます。 SSL の検証に関する情報を読んでから、 [無効にします。Webhook が安全ではないかもしれないことを理解しました] をクリックします。
警告: SSL の検証は、フックのペイロードが安全に配信されることを保証するのに役立ちます。 SSL 検証を無効化することはおすすめしません。
-
[どのイベントによって、この Webhook をトリガーしますか?] で、この Webhook をすべてのイベントに対して、または選んだイベントに対してトリガーするかを選びます。
- すべてのイベントの場合は、 [すべて送信する] を選択します。
- 特定のイベントを選択するには、 [個別のイベントを選択する] を選択します。
-
個別のイベントを選択する場合は、Webhook をトリガーするイベントを選択します。
-
構成を追加した直後に Webhook をアクティブにするには、 [アクティブ] を選びます。
-
[Webhook の追加] を選択します。
グローバルwebhookの編集
-
GitHub Enterprise Server の右上で、ご自分のプロフィール フォトをクリックしてから、 [Enterprise 設定] をクリックします。
1. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。 -
編集する Webhook の横の [編集] をクリックします。
-
webhookの設定の更新。
-
[Webhook の更新] をクリックします。
グローバルwebhookの削除
-
GitHub Enterprise Server の右上で、ご自分のプロフィール フォトをクリックしてから、 [Enterprise 設定] をクリックします。
1. Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [ 設定] で、 [フック] をクリックします。 -
削除する Webhook の横の [削除] をクリックします。
-
Webhook の削除に関する情報を読んでから、 [はい、Webhook を削除します] をクリックします。
最近のデリバリとレスポンスの表示
過去 30 日間に発生した Webhook 配信に関する詳細を表示できます。 詳しくは、「webhookの配信の表示」を参照してください。