グローバルwebhookについて
グローバル webhook を使用して、Enterprise ユーザおよび Organization 管理のルールを自動的に監視、応答、適用できます。 たとえば以下のような場合に動作するようにwebhookを設定できます:
- ユーザアカウントが作成または削除される
- Organization が作成または削除される
- コラボレータがリポジトリに追加、またはリポジトリから削除される
- リポジトリがフォークされる
GitHub Enterprise Server APIを使ってグローバルなwebhookを管理することもできます。 アクションの完全なリストについては、の「グローバルwebhook」を参照してください。
グローバルwebhookの追加
-
https://HOSTNAME/enterprises/ENTERPRISE-NAME
にアクセスしてEnterpriseアカウントに移動してください。HOSTNAME
はインスタンスのホスト名で、ENTERPRISE-NAME
はEnterpriseアカウント名で置き換えてください。 -
Enterpriseアカウントのサイドバーで、 Settings(設定)をクリックしてください。
-
Under " Settings", click Hooks.
-
Add webhook(webhookの追加)をクリックしてください。
-
ペイロードの受信に使用する URL を入力します。
-
Content type(コンテントタイプ)ドロップダウンメニューを使ってペイロードの形式をクリックすることもできます。
-
Secret(秘密)フィールドに、
secret
キーとして使う文字列を入力することもできます。 -
ペイロードのデリバリ時に GitHub Enterprise Server に SSL 証明書を検証してほしくない場合、Disable SSL verification] をクリックします。 SSLの検証に関する情報を読んで、 I understand my webhooks may not be secure(webhookがセキュアではないかもしれないことを理解しました)をクリックしてください。
警告: SSL 検証は、フックのペイロードがセキュアにデリバリされることを保証するのに役立ちます。 SSL 検証を無効化することはおすすめしません。
-
webhook をすべてのイベントあるいは選択されたイベントに対して動作させるかを決めます。
- すべてのイベントの場合は [Send me everything] を選択します。
- 特定のイベントを選択するには [Let me select individual events] を選択します。
-
個々のイベントを選択することにした場合、この webhook が Organization のアクティビティで呼ばれるのか、ユーザのアクティビティで呼ばれるのかを選択します。
-
Active(アクティブ)チェックボックスが選択されていることを確認してください(デフォルトで選択されています)。
-
Add webhook(webhookの追加)をクリックしてください。
グローバルwebhookの編集
-
https://HOSTNAME/enterprises/ENTERPRISE-NAME
にアクセスしてEnterpriseアカウントに移動してください。HOSTNAME
はインスタンスのホスト名で、ENTERPRISE-NAME
はEnterpriseアカウント名で置き換えてください。 -
Enterpriseアカウントのサイドバーで、 Settings(設定)をクリックしてください。
-
Under " Settings", click Hooks.
-
編集したいwebhookの隣のEdit(編集)をクリックしてください。
-
webhookの設定の更新。
-
Update webhook(webhookの更新)をクリックしてください。
グローバルwebhookの削除
-
https://HOSTNAME/enterprises/ENTERPRISE-NAME
にアクセスしてEnterpriseアカウントに移動してください。HOSTNAME
はインスタンスのホスト名で、ENTERPRISE-NAME
はEnterpriseアカウント名で置き換えてください。 -
Enterpriseアカウントのサイドバーで、 Settings(設定)をクリックしてください。
-
Under " Settings", click Hooks.
-
削除したいwebhookの隣のDelete(削除)をクリックしてください。
-
webhookの削除に関する情報を読んで、Yes, delete webhook(はい、webhookを削除します)をクリックしてください。
最近のデリバリとレスポンスの表示
-
https://HOSTNAME/enterprises/ENTERPRISE-NAME
にアクセスしてEnterpriseアカウントに移動してください。HOSTNAME
はインスタンスのホスト名で、ENTERPRISE-NAME
はEnterpriseアカウント名で置き換えてください。 -
Enterpriseアカウントのサイドバーで、 Settings(設定)をクリックしてください。
-
Under " Settings", click Hooks.
-
webhook のリストで、デリバリを見たい webhook をクリックします。
-
[Recent deliveries(最近のデリバリ)] の下で、詳細を表示したいデリバリをクリックしてください。