{"meta":{"title":"webhookの作成","intro":"webhook を作成して、 GitHubで発生する特定のイベントをサブスクライブできます。","product":"Webhooks","breadcrumbs":[{"href":"/ja/enterprise-cloud@latest/webhooks","title":"Webhooks"},{"href":"/ja/enterprise-cloud@latest/webhooks/using-webhooks","title":"Webhook の使用"},{"href":"/ja/enterprise-cloud@latest/webhooks/using-webhooks/creating-webhooks","title":"Webhook を作成する"}],"documentType":"article"},"body":"# webhookの作成\n\nwebhook を作成して、 GitHubで発生する特定のイベントをサブスクライブできます。\n\n## webhookの作成について\n\nwebhook を作成して、リポジトリ、組織、GitHub、GitHub Enterprise アカウント、GitHub Marketplace アカウント、GitHub Sponsors、またはで発生するGitHub Appの特定のイベントをサブスクライブできます。\n\nさまざまな種類の Webhook の詳細については、「[Webhook の種類](/ja/enterprise-cloud@latest/webhooks/types-of-webhooks)」を参照してください。\n\nWebhook イベントの完全な一覧については、「[Webhook のイベントとペイロード](/ja/enterprise-cloud@latest/webhooks/webhook-events-and-payloads)」を参照してください。\n\n## リポジトリの Webhook の作成\n\n特定のリポジトリで発生したイベントをサブスクライブするWebhook を作成できます。 そのリポジトリに Webhook を作成するには、リポジトリのオーナーであるか、リポジトリの管理者アクセス権が必要です。\n\nGitHub Web インターフェイスまたは REST API を使用して、リポジトリ Webhook を作成できます。 REST API を使用してリポジトリ Webhook を作成する方法の詳細については、「[リポジトリ ウェブフック の REST API エンドポイント](/ja/enterprise-cloud@latest/rest/repos/webhooks#create-a-repository-webhook)」を参照してください。\n\n1. GitHub で、リポジトリのメイン ページに移動します。\n2. リポジトリ名の下にある ** \\[Settings]** をクリックします。 \\[設定] タブが表示されない場合は、 **\\[]** ドロップダウン メニューを選び、 **\\[設定]** をクリックします。\n\n ![タブを示すリポジトリ ヘッダーのスクリーンショット。 \\[設定\\] タブが濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/repo-actions-settings.png)\n3. 左側のサイドバーで、** \\[Webhooks]** をクリックします。\n4. **\\[Webhook の追加]** を選択します。\n5. \\[ペイロード URL] の下に、ペイロードを受信する URL を入力します。\n6. 必要に応じて、 **\\[コンテンツ タイプ]** ドロップダウン メニューを選び、Webhook ペイロードを受信するデータ形式をクリックします。\n * **application/json**は、JSONペイロードを`POST`リクエストのボディとして直接配信します。\n * **application/x-www-form-urlencoded** は、JSON ペイロードを payload というフォーム パラメーターとして送信します。`payload`\n7. 必要に応じて、 \\[シークレット] フィールドの下に、 `secret`キーとして使用する文字列を入力します。 エントロピーの高いランダムな文字列を選択してください。 webhook シークレットを使用して、受信要求を GitHubから送信された要求のみに制限できます。 詳しくは、「[Webhook 配信を検証する](/ja/enterprise-cloud@latest/webhooks/using-webhooks/validating-webhook-deliveries)」をご覧ください。\n8. \\[この Webhook をトリガーするイベントを指定してください] で、受信する Webhook イベントを選択します。 必要な Webhook イベントのみをサブスクライブしてください。\n9. **\\[個別のイベントを選択する]** を選択した場合、Webhook をトリガーしたいイベントを選択します。\n10. 構成を追加した直後に Webhook をアクティブにするには、 **\\[アクティブ]** を選びます。\n11. **\\[Webhook の追加]** を選択します。\n\n新しい webhook を作成すると、 GitHub は webhook を正しく設定したことを知らせる単純な `ping` イベントを送信します。 詳しくは、「[Webhook のイベントとペイロード](/ja/enterprise-cloud@latest/webhooks/webhook-events-and-payloads#ping)」をご覧ください。\n\n## 組織のウェブフック作成\n\n特定の組織で発生するイベントをサブスクライブする Webhook を作成できます。 その組織で Webhook を作成するには、組織のオーナーである必要があります。\n\nGitHub Web インターフェイスまたは REST API を使用して、組織の Webhook を作成できます。 REST API を使用して organization の Webhook を作成する方法の詳細については、「[組織の Webhook の REST API エンドポイント](/ja/enterprise-cloud@latest/rest/orgs/webhooks#create-an-organization-webhook)」を参照してください。\n\n1. GitHubのページの右上隅にあるプロフィール画像をクリックします。\n2. **\\[自分の組織]** をクリックします。\n3. 組織の右側にある **\\[設定]** をクリックします。\n4. 左側のサイドバーで、** \\[Webhooks]** をクリックします。\n5. **\\[Webhook の追加]** を選択します。\n6. \\[ペイロード URL] の下に、ペイロードを受信する URL を入力します。\n7. 必要に応じて、 **\\[コンテンツ タイプ]** ドロップダウン メニューを選び、Webhook ペイロードを受信するデータ形式をクリックします。\n * **application/json**は、JSONペイロードを`POST`リクエストのボディとして直接配信します。\n * **application/x-www-form-urlencoded** は、JSON ペイロードを payload というフォーム パラメーターとして送信します。`payload`\n8. 必要に応じて、 \\[シークレット] フィールドの下に、 `secret`キーとして使用する文字列を入力します。 エントロピーの高いランダムな文字列を選択してください。 webhook シークレットを使用して、受信要求を GitHubから送信された要求のみに制限できます。 詳しくは、「[Webhook 配信を検証する](/ja/enterprise-cloud@latest/webhooks/using-webhooks/validating-webhook-deliveries)」をご覧ください。\n9. \\[この webhook をトリガーするイベントを指定してください]で、受信する Webhook の種類を選択します。 必要な Webhook イベントのみをサブスクライブしてください。\n10. **個別のイベントを選択する**場合は、Webhook をトリガーするイベントを選択します。\n11. 構成を追加した直後に Webhook をアクティブにするには、 **\\[アクティブ]** を選びます。\n12. **\\[Webhook の追加]** を選択します。\n\n新しい webhook を作成すると、 GitHub は webhook を正しく設定したことを知らせる単純な `ping` イベントを送信します。 詳しくは、「[Webhook のイベントとペイロード](/ja/enterprise-cloud@latest/webhooks/webhook-events-and-payloads#ping)」をご覧ください。\n\n## GitHub Enterprise 用のグローバル Webhook の作成\n\nエンタープライズオーナーは、グローバル Webhook を作成して、企業内で発生するイベントをサブスクライブできます。\n\n1. 企業ページに移動してください。 たとえば、GitHub.com の [\\[Enterprise\\]](https://github.com/settings/enterprises?ref_product=ghec\\&ref_type=engagement\\&ref_style=text) ページから。\n\n2. ページの上部にある \\[ **Settings**] をクリックします。\n\n3. \\[ Settings] で、**\\[Hooks]** をクリックします。\n\n4. **\\[Webhook の追加]** を選択します。\n\n5. \\[ペイロード URL] フィールドに、ペイロードを受信する URL を入力します。\n\n6. 必要に応じて、 **\\[コンテンツ タイプ]** ドロップダウン メニューを選び、Webhook ペイロードを受信するデータ形式をクリックします。\n * **application/json**は、JSONペイロードを`POST`リクエストのボディとして直接配信します。\n * **application/x-www-form-urlencoded** は、JSON ペイロードを payload というフォーム パラメーターとして送信します。`payload`\n\n7. 必要に応じて、 \\[シークレット] フィールドの下に、 `secret`キーとして使用する文字列を入力します。 エントロピーの高いランダムな文字列を選択してください。 webhook シークレットを使用して、受信要求を GitHubから送信された要求のみに制限できます。 詳しくは、「[Webhook 配信を検証する](/ja/enterprise-cloud@latest/webhooks/using-webhooks/validating-webhook-deliveries)」をご覧ください。\n\n8. 必要に応じて、ペイロード URL が HTTPS で、ペイロードの配信時に SSL 証明書の検証を GitHub Enterprise Server しない場合は、\\[SSL 検証] で \\[ **無効]** を選択します。 SSL の検証に関する情報を読んでから、 **\\[無効にします。Webhook が安全ではないかもしれないことを理解しました]** をクリックします。\n\n > \\[!WARNING]\n > SSL の検証は、フックのペイロードが安全に配信されることを保証するのに役立ちます。 SSL 検証を無効化することはおすすめしません。\n\n9. \\[この webhook をトリガーするイベントを指定してください]で、受信する Webhook の種類を選択します。 必要な Webhook イベントのみをサブスクライブしてください。\n\n10. **個別のイベントを選択する**場合は、Webhook をトリガーするイベントを選択します。\n\n11. 構成を追加した直後に Webhook をアクティブにするには、 **\\[アクティブ]** を選びます。\n\n12. **\\[Webhook の追加]** を選択します。\n\n## GitHub Marketplace ウェブフックの作成\n\nwebhook を作成して、 GitHub Marketplaceで発行したアプリに関連するイベントをサブスクライブできます。\nGitHub Marketplace Webhook を作成できるのは、アプリの所有者、またはアプリのアプリ マネージャーだけです。\n\n1. [\n GitHub Marketplace登録情報ページ](https://github.com/marketplace/manage)に移動します。\n2. Webhook 配信を表示するには、表示したい GitHub Marketplace listing の横にある **リストの管理** をクリックします。\n3. サイドバーで、**\\[Webhook]** をクリックします。\n4. \\[ペイロード URL] の下に、ペイロードを受信する URL を入力します。\n5. 必要に応じて、 **\\[コンテンツ タイプ]** ドロップダウン メニューを選び、Webhook ペイロードを受信するデータ形式をクリックします。\n * **application/json**は、JSONペイロードを`POST`リクエストのボディとして直接配信します。\n * **application/x-www-form-urlencoded** は、JSON ペイロードを payload というフォーム パラメーターとして送信します。`payload`\n6. 必要に応じて、 \\[シークレット] フィールドの下に、 `secret`キーとして使用する文字列を入力します。 エントロピーの高いランダムな文字列を選択してください。 webhook シークレットを使用して、受信要求を GitHubから送信された要求のみに制限できます。 詳しくは、「[Webhook 配信を検証する](/ja/enterprise-cloud@latest/webhooks/using-webhooks/validating-webhook-deliveries)」をご覧ください。\n7. 構成を追加した直後に Webhook をアクティブにするには、 **\\[アクティブ]** を選びます。\n8. **\\[Webhook の作成]** をクリックします。\n\n新しい webhook を作成すると、 GitHub は webhook を正しく設定したことを知らせる単純な `ping` イベントを送信します。 詳しくは、「[Webhook のイベントとペイロード](/ja/enterprise-cloud@latest/webhooks/webhook-events-and-payloads#ping)」をご覧ください。\n\n## GitHub Sponsors ウェブフックの作成\n\nスポンサーに関連するイベントに登録するWebhookを作成できます。 スポンサーされたアカウントのオーナーのみが、そのアカウントのスポンサー Webhook を作成できます。 スポンサー Webhook がサブスクライブしているイベントの詳細については、[`sponsorship`「Webhook イベント」](/ja/enterprise-cloud@latest/webhooks/webhook-events-and-payloads#sponsorship)を参照してください。\n\n1. 任意のページで、右上隅にあるプロフィール画像をクリックし、次に **\\[Your sponsors]** をクリックします。\n2. Webhook を作成するアカウントの横にある **\\[ダッシュボード]** をクリックします。\n3. 左のサイドバーで、 **\\[Webhooks]** をクリックします。\n4. **\\[Webhook の追加]** を選択します。\n5. \\[ペイロード URL] の下に、ペイロードを受信する URL を入力します。\n6. 必要に応じて、 **\\[コンテンツ タイプ]** ドロップダウン メニューを選び、Webhook ペイロードを受信するデータ形式をクリックします。\n * **application/json**は、JSONペイロードを`POST`リクエストのボディとして直接配信します。\n * **application/x-www-form-urlencoded** は、JSON ペイロードを payload というフォーム パラメーターとして送信します。`payload`\n7. 必要に応じて、 \\[シークレット] フィールドの下に、 `secret`キーとして使用する文字列を入力します。 エントロピーの高いランダムな文字列を選択してください。 webhook シークレットを使用して、受信要求を GitHubから送信された要求のみに制限できます。 詳しくは、「[Webhook 配信を検証する](/ja/enterprise-cloud@latest/webhooks/using-webhooks/validating-webhook-deliveries)」をご覧ください。\n8. 構成を追加した直後に Webhook をアクティブにするには、 **\\[アクティブ]** を選びます。\n9. **\\[Webhook の作成]** をクリックします。\n\n## GitHub App の Webhook の作成\n\nGitHub Appの所有者は、アプリを webhook イベントにサブスクライブして、特定のイベントが発生するたびに通知を受け取ることができます。 アプリ所有者が GitHub Appのアプリ マネージャーを指定している場合、アプリ マネージャーはアプリを webhook イベントにサブスクライブすることもできます。 詳しくは、「[GitHub Apps での Webhook の使用](/ja/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps)」をご覧ください。\n\n各 GitHub App には 1 つの Webhook があります。\nGitHub Appを登録するときに webhook を構成することも、既存のGitHub App登録の webhook 構成を編集することもできます。\n\nGitHub Appを登録するときに Webhook を構成する方法の詳細については、[GitHub アプリの登録](/ja/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/registering-a-github-app) を参照してください。\n\n既存の GitHub App 登録用に Webhook を構成するには:\n\n1. GitHub の任意のページの右上隅にある、自分のプロフィール写真をクリックします。\n\n2. アカウント設定にアクセスしてください。\n * 個人用アカウントが所有するアプリの場合は、**\\[設定]** をクリックします。\n * 組織が所有するアプリの場合:\n 1. **\\[自分の組織]** をクリックします。\n 2. 組織の右側にある **\\[設定]** をクリックします。\n * Enterprise が所有するアプリの場合:\n 1. Enterprise Managed Users を使用する場合は、**\\[Enterprise]** をクリックして Enterprise アカウントの設定に移動します。\n 2. 個人用アカウントを使用する場合は、**\\[Enterprise]** をクリックしてから、Enterprise の右側にある **\\[設定]** をクリックします。\n\n3. GitHub App 設定にアクセスしてください。\n * 個人用アカウントまたは組織が所有するアプリの場合:\n 1. 左側のサイドバーで、**\\[ Developer settings]** をクリックしてから、**\\[GitHub Apps]** をクリックします。\n * Enterprise が所有するアプリの場合:\n 1. 左側のサイドバーで、 \\[設定] から **GitHub Apps** をクリックします。\n\n4. Webhook を構成する GitHub App の横にある \\[ **編集**] をクリックします。\n\n5. \\[Webhook] で **\\[アクティブ]** を選択します。\n\n6. \\[Webhook URL] にペイロードを受信する URL を入力します。\n\n7. 必要に応じて、 \\[Webhook シークレット] フィールドに `secret` キーとして使用する文字列を入力します。 エントロピーの高いランダムな文字列を選択してください。 webhook シークレットを使用して、受信要求を GitHubから送信された要求のみに制限できます。 詳しくは、「[Webhook 配信を検証する](/ja/enterprise-cloud@latest/webhooks/using-webhooks/validating-webhook-deliveries)」をご覧ください。\n\n8. \\[ **変更の保存] をクリックします**。\n\n9. サイドバーで、**\\[アクセス許可とイベント]** をクリックします。\n\n10. GitHub App の登録で選択できる具体的な Webhook イベントは、アプリに対して選択したアクセス許可の種類によって決まります。 まず、アプリに付与するアクセス許可を選択する必要があります。これで、そのアクセス許可のセットに関連する Webhook イベントにアプリをサブスクライブできます。\n\n セクション \\[リポジトリのアクセス許可]、\\[組織のアクセス許可]、\\[アカウントのアクセス許可] で、アプリがサブスクライブするイベントに必要なアクセス許可を選びます。 詳しくは、「[GitHub アプリのアクセス許可の選択](/ja/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app)」をご覧ください。 アクセス許可を変更する際に考慮すべき事項の詳細については、「[GitHub App登録の変更](/ja/enterprise-cloud@latest/apps/maintaining-github-apps/modifying-a-github-app-registration#changing-the-permissions-of-a-github-app)」を参照してください。\n\n11. 「Subscribe to Events」で、GitHub App が受信する Webhook イベントを選択します。\n\n12. \\[ **変更の保存] をクリックします**。\n\nREST API を使用して、 GitHub Appの Webhook を作成することもできます。 詳しくは、「[GitHub App Webhook の REST API エンドポイント](/ja/enterprise-cloud@latest/rest/apps/webhooks)」をご覧ください。\n\n## 参考資料\n\n* [webhook について](/ja/enterprise-cloud@latest/webhooks/about-webhooks)\n* [webhookの配信処理](/ja/enterprise-cloud@latest/webhooks/using-webhooks/handling-webhook-deliveries)"}