{"meta":{"title":"GitHub アプリの登録","intro":"GitHub App は、個人用アカウント 、自分が所有する Organization  で登録できます。","product":"アプリ","breadcrumbs":[{"href":"/ja/apps","title":"アプリ"},{"href":"/ja/apps/creating-github-apps","title":"GitHub アプリの作成"},{"href":"/ja/apps/creating-github-apps/registering-a-github-app","title":"GitHub App の登録"},{"href":"/ja/apps/creating-github-apps/registering-a-github-app/registering-a-github-app","title":"GitHub App を登録する"}],"documentType":"article"},"body":"# GitHub アプリの登録\n\nGitHub App は、個人用アカウント 、自分が所有する Organization  で登録できます。\n\n## GitHub Apps\n\nの登録について\n\nGitHub App は、いくつかの方法で登録できます。\n\n* **個人用アカウント**の下で\n* **自分が所有する組織の下**\n* あなたが全アプリを管理する権限を得ている組織の配下で。 「[組織内でGitHubアプリのマネージャーを追加および削除する方法](/ja/organizations/managing-programmatic-access-to-your-organization/adding-github-app-managers-in-your-organization)」を参照してください。\n\nユーザーまたは organization は、最大 100 個の GitHub Apps を登録できますが、1 つのアカウントにインストールできる GitHub Apps の数に制限はありません。\n\n## GitHub App の登録\n\n1. GitHub の任意のページの右上隅にある、自分のプロフィール写真をクリックします。\n\n2. アカウント設定にアクセスしてください。\n   * 個人用アカウントが所有するアプリの場合は、**\\[設定]** をクリックします。\n   * 組織が所有するアプリの場合:\n     1. **\\[自分の組織]** をクリックします。\n     2. 組織の右側にある **\\[設定]** をクリックします。\n\n3. 左側のサイドバーの **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-code\" aria-label=\"code\" role=\"img\"><path d=\"m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z\"></path></svg> \\[Developer settings]** をクリックします。\n\n4. 左側のサイドバーで、 **\\[GitHub Apps]** をクリックします。\n\n5. ```\n          **新しい GitHub App** をクリックします。\n   ```\n\n6. \\[GitHub App 名] に、アプリの名前を入力します。 わかりやすく短い名前を選ぶ必要があります。 名前は 34 文字より長くすることはできません。 アプリでアクションが実行されると、アプリの名前 (小文字に変換され、スペースが `-` に置き換えられ、特殊文字が置き換えられる) がユーザー インターフェイスに表示されます。 たとえば、`My APp Näme` は `my-app-name` として表示されます。\n\n   名前は GitHub 全体で一意である必要があります。 既存の GitHub アカウントと同じ名前を使用することはできません。ただし、それがあなた自身のユーザー名や組織名である場合は例外です。\n\n7. 必要に応じて、\\[説明] にアプリの説明を入力します。 アプリのインストール時に、この説明がユーザーに表示されます。\n\n8. \\[ホームページの URL] に、アプリのウェブサイトの完全な URL を入力します。 専用 URL がなく、アプリのコードがパブリック リポジトリに格納されている場合は、そのリポジトリ URL を使用できます。 または、アプリを所有するアカウントの URL を使うこともできます。\n\n9. 必要に応じて、\\[コールバック URL] に、ユーザーがインストールを承認した後にリダイレクトされる URL を完全な形で入力します。\n\n   コールバック URL は最大 10 個入力できます。 さらにコールバック URL を追加するには、 **\\[コールバック URL の追加]** をクリックします。\n\n   アプリがユーザーの代わりに動作する必要がない (ユーザー アクセス トークンを生成する必要がない) 場合、このフィールドは無視されます。 アプリで Web アプリケーション フローではなくデバイス フローを使用してユーザー アクセス トークンを生成する場合、このフィールドは無視されます。\n\n   コールバック URL の詳細については、「[ユーザー承認コールバック URL について](/ja/apps/creating-github-apps/setting-up-a-github-app/about-the-user-authorization-callback-url)」を参照してください。 ユーザーの代わりに動作するユーザー アクセス トークンの生成の詳細については、「[ユーザーに代わってGitHub アプリで認証する](/ja/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-with-a-github-app-on-behalf-of-a-user)」と「[GitHub アプリのユーザー アクセス トークンの生成](/ja/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)」を参照してください。\n\n10. 必要に応じて、ユーザー アクセス トークンの有効期限が切れないようにするには、 **\\[ユーザー承認トークンの期限切れ]** の選択を解除します。 GitHub では、このオプションを選択したままにすることを強くお勧めします。 期限切れトークンの更新と、有効期限が切れるユーザー アクセス トークンの利点の詳細については、「[ユーザー アクセス トークンを更新する](/ja/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens)」を参照してください。 アプリでユーザー アクセス トークンを生成する必要がない場合、このフィールドは無視されます。\n\n11. 必要に応じて、アプリのインストール時にユーザーに承認を求めるメッセージを表示するには、 **\\[インストール中にユーザー承認 (OAuth) を要求する]** を選びます。 ユーザーがアプリを認可した場合、アプリでそのユーザーに代わって API 要求を行い、アプリ アクティビティをユーザーに属性付けるために、ユーザー アクセス トークンを生成できます。 詳細については、「[ユーザーに代わってGitHub アプリで認証する](/ja/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-with-a-github-app-on-behalf-of-a-user)」および「[GitHub アプリのユーザー アクセス トークンの生成](/ja/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)」を参照してください。\n\n12. 必要に応じて、デバイス フローを使用してユーザー アクセス トークンを生成する場合は、 **\\[デバイス フローを有効にする]** を選択します。 詳しくは、「[GitHub アプリのユーザー アクセス トークンの生成](/ja/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)」をご覧ください。\n\n13. 必要に応じて、\\[セットアップ URL] に、アプリのインストール後にユーザーをリダイレクトする URL を入力します。 インストール後に追加のセットアップが必要な場合は、この URL を使用して、インストール後に行う手順をユーザーに伝えることができます。 詳しくは、「[セットアップ URL について](/ja/apps/creating-github-apps/setting-up-a-github-app/about-the-setup-url)」をご覧ください。\n\n    前の手順で **\\[インストール中にユーザー承認 (OAuth) を要求する]** を選んだ場合、ここに URL を入力することはできません。 代わりに、ユーザーは承認フローの一部としてコールバック URL にリダイレクトされます。ここで、追加のセットアップを説明できます。\n\n14. 必要に応じて、インストールの更新後にユーザーをセットアップ URL にリダイレクトする場合は、 **\\[更新時にリダイレクト]** を選択します。 更新には、インストール用のリポジトリの追加または削除が含まれます。 \\[セットアップ URL] が空白の場合、これは無視されます。\n\n15. 必要に応じて、アプリで Webhook イベントを受信しないようにする場合は、 **\\[アクティブ]** の選択を解除します。 たとえば、アプリが認証にのみ使用されるか、Webhook に応答する必要がない場合は、このオプションの選択を解除します。 詳しくは、「[GitHub Apps での Webhook の使用](/ja/apps/creating-github-apps/setting-up-a-github-app/using-webhooks-with-github-apps)」をご覧ください。\n\n16. 前の手順で **\\[アクティブ]** を選択した場合は、\\[Webhook URL] に、GitHub が Webhook イベントを送信する必要がある URL を入力します。 詳しくは、「[GitHub Apps での Webhook の使用](/ja/apps/creating-github-apps/setting-up-a-github-app/using-webhooks-with-github-apps)」をご覧ください。\n\n17. 必要に応じて、前の手順で **\\[アクティブ] を** 選択した場合は、\\[Webhook シークレット] に、Webhook をセキュリティで保護するためのシークレット トークンを入力します。 GitHub では、Webhook シークレットを設定することを強くお勧めします。 詳しくは、「[GitHub Apps での Webhook の使用](/ja/apps/creating-github-apps/setting-up-a-github-app/using-webhooks-with-github-apps)」をご覧ください。\n\n18. Webhook URL を入力した場合は、\\[SSL 検証] で、SSL 検証を有効にするかどうかを選びます。 GitHub では、SSL 検証を有効にすることを強くお勧めします。\n\n19. \\[アクセス許可] で、アプリに必要なアクセス許可を選びます。 アクセス許可ごとに、ドロップダウン メニューを選び、 **\\[読み取り専用]** 、 **\\[読み取りおよび書き込み]** 、または **\\[アクセス権なし]** をクリックします。 アプリに必要な最小限のアクセス許可を選ぶ必要があります。 詳しくは、「[GitHub アプリのアクセス許可の選択](/ja/apps/creating-github-apps/setting-up-a-github-app/choosing-permissions-for-a-github-app)」をご覧ください。\n\n20. 前の手順で **\\[アクティブ]** を選び、アプリで Webhook イベントを受信する必要があることを示した場合は、\\[イベントのサブスクライブ] で、アプリで受信する Webhook イベントを選びます。 前の手順で選んだアクセス許可によって、使用できる Webhook イベントが決まります。 各 Webhook イベントの詳細については、「[Webhook のイベントとペイロード](/ja/webhooks-and-events/webhooks/webhook-events-and-payloads)」を参照してください。\n\n21. \\[この GitHub App アプリをインストールできる場所] で、**\\[このアカウントのみ]** または **\\[任意のアカウント]** を選択します。インストール オプションの詳細については、「[GitHub アプリをパブリックまたはプライベートにする](/ja/apps/creating-github-apps/setting-up-a-github-app/making-a-github-app-public-or-private)」を参照してください。\n\n22. ```\n           **GitHub App を作成する** をクリックします。\n    ```\n\n## 次のステップ\n\nGitHub App を登録した後は、GitHub App に何かを実行させるコードを書くことになります。 コードを書く方法の例については、次を参照してください。\n\n* [GitHub Apps の構築に関するクイック スタート](/ja/apps/creating-github-apps/writing-code-for-a-github-app/quickstart)\n* [webhook イベントに応答するGitHub アプリの構築](/ja/apps/creating-github-apps/guides/building-a-github-app-that-responds-to-webhook-events)\n* [GitHub アプリを使用して \\[GitHub でログイン\\] ボタンをビルドする](/ja/apps/creating-github-apps/guides/building-a-login-with-github-button-with-a-github-app)\n* [GitHub アプリを使用した CLI の構築](/ja/apps/creating-github-apps/guides/building-a-cli-with-a-github-app)\n* [GitHub Actions ワークフローでGitHub アプリを使用して認証済み API 要求を作成する](/ja/apps/creating-github-apps/writing-code-for-a-github-app/making-authenticated-api-requests-with-a-github-app-in-a-github-actions-workflow)\n\nベスト プラクティスに従うようにする必要があります。 詳しくは、「[GitHub アプリを作成するためのベスト プラクティス](/ja/apps/creating-github-apps/setting-up-a-github-app/best-practices-for-creating-a-github-app)」をご覧ください。\n\nGitHub App が完全に構築されたら、GitHub App をインストールし、GitHub App を他のユーザーと共有できます。 詳細については、「[独自のGitHub アプリのインストール](/ja/apps/using-github-apps/installing-your-own-github-app)」および「[GitHub App の共有](/ja/apps/sharing-github-apps/sharing-your-github-app)」を参照してください。\n\nGitHub App の設定はいつでも変更できます。 詳しくは、「[GitHub アプリの登録の変更](/ja/apps/maintaining-github-apps/modifying-a-github-app)」をご覧ください。"}