{"meta":{"title":"GitHub Apps のドキュメント","intro":"API や Webhook との統合、GitHubワークフローのカスタマイズ、コミュニティとのアプリの構築と共有を行うことで、GitHubをさらに深めることができます。","product":"アプリ","breadcrumbs":[{"href":"/ja/enterprise-server@3.19/apps","title":"アプリ"}],"documentType":"product"},"body":"# GitHub Apps のドキュメント\n\nAPI や Webhook との統合、GitHubワークフローのカスタマイズ、コミュニティとのアプリの構築と共有を行うことで、GitHubをさらに深めることができます。\n\n## Recommended\n\n* [GitHub アプリの概要](/ja/enterprise-server@3.19/apps/overview)\n\n  GitHub Appsを使用して、GitHubの機能を拡張できます。\n\n* [GitHub Apps の構築に関するクイック スタート](/ja/enterprise-server@3.19/apps/creating-github-apps/writing-code-for-a-github-app/quickstart)\n\n  pull request にコメントする GitHub App をすばやく作成します。\n\n* [GitHub アプリの作成について](/ja/enterprise-server@3.19/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps)\n\n  GitHub Apps では、プロセスを自動化し、 GitHubの機能を拡張するための統合を構築できます。\n\n* [GitHub アプリの登録](/ja/enterprise-server@3.19/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)\n\n  GitHub App は、個人アカウント、自分が所有する任意の組織、あなたのエンタープライズ  に登録できます。\n\n* [GitHub アプリでの認証について](/ja/enterprise-server@3.19/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app)\n\n  GitHub Appは、それ自体として、アプリのインストールとして、またはユーザーの代わりに認証できます。\n\n* [GitHub アプリの承認](/ja/enterprise-server@3.19/apps/using-github-apps/authorizing-github-apps)\n\n  GitHub App が GitHub アカウントに関する情報を取得し、あなたに代わって変更を加えることを承認できます。\n\n* [GitHub アプリと OAuth アプリの違い](/ja/enterprise-server@3.19/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)\n\n  一般に、 GitHub Apps は、きめ細かいアクセス許可を使用し、アプリがアクセスできるリポジトリをより細かく制御し、有効期間の短いトークンを使用するため、 OAuth apps することをお勧めします。\n\n* [webhook イベントに応答するGitHub アプリの構築](/ja/enterprise-server@3.19/apps/creating-github-apps/writing-code-for-a-github-app/building-a-github-app-that-responds-to-webhook-events)\n\n  webhook イベントに応答して API 要求を行う GitHub App を構築する方法について説明します。\n\n* [GitHub アプリを作成するためのベスト プラクティス](/ja/enterprise-server@3.19/apps/creating-github-apps/about-creating-github-apps/best-practices-for-creating-a-github-app)\n\n  GitHub Appのセキュリティとパフォーマンスを向上させるには、次のベスト プラクティスに従ってください。\n\n## Links\n\n### Getting started\n\n* [GitHub アプリの概要](/ja/enterprise-server@3.19/apps/overview)\n\n  GitHub Appsを使用して、GitHubの機能を拡張できます。\n\n* [GitHub Apps の構築に関するクイック スタート](/ja/enterprise-server@3.19/apps/creating-github-apps/writing-code-for-a-github-app/quickstart)\n\n  pull request にコメントする GitHub App をすばやく作成します。\n\n## Articles\n\n* [GitHub アプリの概要](/ja/enterprise-server@3.19/apps/overview)\n\n  GitHub Appsを使用して、GitHubの機能を拡張できます。\n\n* [GitHub Apps の使用について](/ja/enterprise-server@3.19/apps/using-github-apps/about-using-github-apps)\n\n  GitHub Appの概要と、GitHub Appを使用する理由について説明します。\n\n* [サードパーティ製 GitHub App のインストール](/ja/enterprise-server@3.19/apps/using-github-apps/installing-a-github-app-from-a-third-party)\n\n  GitHub Appsは、アカウントで使用するアプリ所有者から直接インストールできます。\n\n* [独自のGitHub アプリのインストール](/ja/enterprise-server@3.19/apps/using-github-apps/installing-your-own-github-app)\n\n  アプリを所有するアカウントで作成した GitHub App をインストールできます。 アプリがパブリックの場合は、GitHub App を他のアカウントにもインストールできます。\n\n* [Enterprise に GitHub アプリをインストールする](/ja/enterprise-server@3.19/apps/using-github-apps/installing-a-github-app-on-your-enterprise)\n\n  エンタープライズに GitHub Apps をインストールして、エンタープライズ アカウントを管理し、エンタープライズ レベルの操作を実行できます。\n\n* [GitHub アプリの承認](/ja/enterprise-server@3.19/apps/using-github-apps/authorizing-github-apps)\n\n  GitHub App が GitHub アカウントに関する情報を取得し、あなたに代わって変更を加えることを承認できます。\n\n* [GitHub アプリの更新されたアクセス許可の承認](/ja/enterprise-server@3.19/apps/using-github-apps/approving-updated-permissions-for-a-github-app)\n\n  GitHub Appが追加のアクセス許可を要求すると、アクセス許可が有効にする動作を確認し、アクセス許可を承認するかどうかを決定できます。\n\n* [GitHub アプリの承認の確認と取り消し](/ja/enterprise-server@3.19/apps/using-github-apps/reviewing-and-revoking-authorization-of-github-apps)\n\n  承認した GitHub Apps を確認し、承認を取り消すことができます。\n\n* [インストールされている GitHub Apps の確認と変更](/ja/enterprise-server@3.19/apps/using-github-apps/reviewing-and-modifying-installed-github-apps)\n\n  アクセス許可を確認し、インストールした GitHub Apps のリポジトリ アクセスを変更できます。 また、 GitHub App がアカウントまたは組織が所有するリソースに一時的または永続的にアクセスできないようにすることもできます。\n\n* [GitHub 特権アプリ](/ja/enterprise-server@3.19/apps/using-github-apps/privileged-github-apps)\n\n  一部の GitHub Apps は、特別な機能が付与されている、 GitHubが所有する特権アプリです。\n\n* [GitHub アプリの作成について](/ja/enterprise-server@3.19/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps)\n\n  GitHub Apps では、プロセスを自動化し、 GitHubの機能を拡張するための統合を構築できます。\n\n* [GitHub アプリをビルドするタイミングを決定する](/ja/enterprise-server@3.19/apps/creating-github-apps/about-creating-github-apps/deciding-when-to-build-a-github-app)\n\n  統合を構築するときは、GitHub App、OAuth app、またはpersonal access tokenではなく、次のシナリオでGitHub Actionsを使用することを検討する必要があります。\n\n* [GitHub アプリを作成するためのベスト プラクティス](/ja/enterprise-server@3.19/apps/creating-github-apps/about-creating-github-apps/best-practices-for-creating-a-github-app)\n\n  GitHub Appのセキュリティとパフォーマンスを向上させるには、次のベスト プラクティスに従ってください。\n\n* [OAuth アプリを GitHub Apps に移行する](/ja/enterprise-server@3.19/apps/creating-github-apps/about-creating-github-apps/migrating-oauth-apps-to-github-apps)\n\n  OAuth appをGitHub Appに移行する利点と、OAuth appを移行する方法について説明します。\n\n* [GitHub アプリの登録](/ja/enterprise-server@3.19/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)\n\n  GitHub App は、個人アカウント、自分が所有する任意の組織、あなたのエンタープライズ  に登録できます。\n\n* [ユーザー承認コールバック URL について](/ja/enterprise-server@3.19/apps/creating-github-apps/registering-a-github-app/about-the-user-authorization-callback-url)\n\n  ユーザーが GitHub Appを承認した後にリダイレクトできる URL を指定できます。\n\n* [セットアップ URL について](/ja/enterprise-server@3.19/apps/creating-github-apps/registering-a-github-app/about-the-setup-url)\n\n  ユーザーが GitHub Appをインストールした後にリダイレクトされる URL を指定できます。\n\n* [GitHub アプリのアクセス許可の選択](/ja/enterprise-server@3.19/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app)\n\n  GitHub アプリのアクセス許可によって、アプリがGitHubの API で実行できることと、アプリが受け取ることができる Webhook が決まります。\n\n* [GitHub Apps での Webhook の使用](/ja/enterprise-server@3.19/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps)\n\n  GitHub Appは Webhook イベントをサブスクライブして、特定のアクティビティが発生するたびに通知を受信できます。\n\n* [GitHub アプリをパブリックまたはプライベートにする](/ja/enterprise-server@3.19/apps/creating-github-apps/registering-a-github-app/making-a-github-app-public-or-private)\n\n  GitHub Appを登録するときに、他のGitHub アカウントがアプリをインストールできるように公開したり、アプリを所有するアカウントにのみアプリをインストールできるようにプライベートにしたりできます。\n\n* [GitHub アプリのレート制限](/ja/enterprise-server@3.19/apps/creating-github-apps/registering-a-github-app/rate-limits-for-github-apps)\n\n  レート制限は、GitHub.com へのトラフィックのレートを制限し、すべてのユーザーに一貫したアクセスを確保するのに役立ちます。\n\n* [GitHub アプリのカスタム バッジの作成](/ja/enterprise-server@3.19/apps/creating-github-apps/registering-a-github-app/creating-a-custom-badge-for-your-github-app)\n\n  独自のロゴ画像をアップロードし、背景をカスタマイズすることによって、GitHub Appのデフォルトのバッジを置き換えられます。\n\n* [GitHub アプリでの認証について](/ja/enterprise-server@3.19/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app)\n\n  GitHub Appは、それ自体として、アプリのインストールとして、またはユーザーの代わりに認証できます。\n\n* [GitHub アプリとしての認証](/ja/enterprise-server@3.19/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app)\n\n  インストール アクセス トークンを生成したり、アプリを管理したりするために、GitHub App として認証できます。\n\n* [GitHub App インストールとしての認証](/ja/enterprise-server@3.19/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app-installation)\n\n  GitHub Appをインストールとして認証し、アプリがインストールされているアカウントが所有するリソースに影響する API 要求を行うことができます。\n\n* [ユーザーに代わってGitHub アプリで認証する](/ja/enterprise-server@3.19/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-with-a-github-app-on-behalf-of-a-user)\n\n  GitHub App は、issue の作成、コメントの投稿、デプロイの作成などのアクションをユーザーの代わりに実行できます。\n\n* [GitHub アプリの秘密キーの管理](/ja/enterprise-server@3.19/apps/creating-github-apps/authenticating-with-a-github-app/managing-private-keys-for-github-apps)\n\n  秘密キーを管理して、 GitHub Appで認証できます。\n\n* [GitHub アプリの JSON Web トークン (JWT) の生成](/ja/enterprise-server@3.19/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-json-web-token-jwt-for-a-github-app)\n\n  GitHub App を使用して特定の REST API エンドポイントに対して認証する JSON Web トークン (JWT) を作成する方法について説明します。\n\n* [GitHub アプリのインストール アクセス トークンの生成](/ja/enterprise-server@3.19/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app)\n\n  GitHub Appのインストール アクセス トークンを生成する方法について説明します。\n\n* [GitHub アプリのユーザー アクセス トークンの生成](/ja/enterprise-server@3.19/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)\n\n  アプリ アクティビティをユーザーに属性付けするために、 GitHub App のユーザー アクセス トークンを生成できます。\n\n* [ユーザー アクセス トークンを更新する](/ja/enterprise-server@3.19/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens)\n\n  定期的なトークン ローテーションを適用し、侵害されたトークンの影響を軽減するには、有効期限が切れたユーザー アクセス トークンを使用するように GitHub App を構成します。\n\n* [GitHub Actions ワークフローでGitHub アプリを使用して認証済み API 要求を作成する](/ja/enterprise-server@3.19/apps/creating-github-apps/authenticating-with-a-github-app/making-authenticated-api-requests-with-a-github-app-in-a-github-actions-workflow)\n\n  GitHub Appからのインストール アクセス トークンを使用して、GitHub Actions ワークフローで認証された API 要求を行うことができます。 トークンをカスタム アクションに渡して、アクションで認証済み API 要求を行えるようにすることもできます。\n\n* [GitHub アプリのコードの記述について](/ja/enterprise-server@3.19/apps/creating-github-apps/writing-code-for-a-github-app/about-writing-code-for-a-github-app)\n\n  GitHub Appに機能を追加するコードを記述する必要があります。\n\n* [GitHub Apps の構築に関するクイック スタート](/ja/enterprise-server@3.19/apps/creating-github-apps/writing-code-for-a-github-app/quickstart)\n\n  pull request にコメントする GitHub App をすばやく作成します。\n\n* [webhook イベントに応答するGitHub アプリの構築](/ja/enterprise-server@3.19/apps/creating-github-apps/writing-code-for-a-github-app/building-a-github-app-that-responds-to-webhook-events)\n\n  webhook イベントに応答して API 要求を行う GitHub App を構築する方法について説明します。\n\n* [GitHub アプリを使用して \\[GitHub でログイン\\] ボタンをビルドする](/ja/enterprise-server@3.19/apps/creating-github-apps/writing-code-for-a-github-app/building-a-login-with-github-button-with-a-github-app)\n\n  このチュートリアルに従って、 GitHub Appの Web アプリケーション フローを介してユーザー アクセス トークンを生成する Ruby コードを記述します。\n\n* [GitHub アプリを使用した CLI の構築](/ja/enterprise-server@3.19/apps/creating-github-apps/writing-code-for-a-github-app/building-a-cli-with-a-github-app)\n\n  このチュートリアルに従って、デバイス フローを介して GitHub App のユーザー アクセス トークンを生成する CLI を Ruby で記述します。\n\n* [GitHub アプリを使用した CI チェックのビルド](/ja/enterprise-server@3.19/apps/creating-github-apps/writing-code-for-a-github-app/building-ci-checks-with-a-github-app)\n\n  GitHub Appとチェックを使用してテストを実行する継続的インテグレーション サーバーを構築します。\n\n* [GitHub App の共有](/ja/enterprise-server@3.19/apps/sharing-github-apps/sharing-your-github-app)\n\n  GitHub Appを他のユーザーと共有できます。\n\n* [GitHub Enterprise Server でGitHub アプリを使用できるようにする](/ja/enterprise-server@3.19/apps/sharing-github-apps/making-your-github-app-available-for-github-enterprise-server)\n\n  GitHub Enterprise Server インスタンスでGitHub Appを使用するには、追加の手順を実行する必要があります。\n\n* [マニフェストからのGitHub アプリの登録](/ja/enterprise-server@3.19/apps/sharing-github-apps/registering-a-github-app-from-a-manifest)\n\n  GitHub App マニフェストは、構成済みのGitHub App登録を他のユーザーと共有する方法です。 マニフェスト フローを使用すると、だれかが GitHub Appをすばやく登録できます。\n\n* [URL パラメーターを使用したGitHub アプリの登録](/ja/enterprise-server@3.19/apps/sharing-github-apps/registering-a-github-app-using-url-parameters)\n\n  URL クエリ パラメーターを使用すると、事前に選択した特定の構成を使用して、他のユーザーが新しい GitHub App をすばやく設定するのに役立ちます。\n\n* [GitHub アプリの登録の変更](/ja/enterprise-server@3.19/apps/maintaining-github-apps/modifying-a-github-app-registration)\n\n  GitHub App を登録した後に変更を加えることができます。\n\n* [GitHub アプリのオプション機能のアクティブ化](/ja/enterprise-server@3.19/apps/maintaining-github-apps/activating-optional-features-for-github-apps)\n\n  GitHub Appsの新しいオプション機能をテストできます。\n\n* [アプリ マネージャー GitHubについて](/ja/enterprise-server@3.19/apps/maintaining-github-apps/about-github-app-managers)\n\n  アプリ マネージャーは、アカウントが所有する GitHub App 登録の一部またはすべてを管理できます。\n\n* [GitHub アプリのインストールの中断](/ja/enterprise-server@3.19/apps/maintaining-github-apps/suspending-a-github-app-installation)\n\n  GitHub Appをインストールしたアカウントが所有するリソースにGitHub Appがアクセスするのを一時的にブロックできます。\n\n* [GitHub アプリの所有権の譲渡](/ja/enterprise-server@3.19/apps/maintaining-github-apps/transferring-ownership-of-a-github-app)\n\n  GitHub App 登録の所有権は、他のユーザーや組織に移譲できます。\n\n* [GitHub アプリの削除](/ja/enterprise-server@3.19/apps/maintaining-github-apps/deleting-a-github-app)\n\n  アプリを使用または保守する必要がなくなった場合は、所有している GitHub Apps を削除できます。\n\n* [OAuth アプリの承認](/ja/enterprise-server@3.19/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps)\n\n  OAuth を使用して、 GitHub ID をサードパーティのアプリケーションに接続できます。\n  OAuth appを承認するときは、アプリケーションを信頼し、そのアプリケーションの開発元を確認し、アプリケーションがアクセスする情報の種類を確認する必要があります。\n\n* [承認された OAuth アプリをレビューする](/ja/enterprise-server@3.19/apps/oauth-apps/using-oauth-apps/reviewing-your-authorized-oauth-apps)\n\n  プライベート リポジトリにアクセス権があるような、広範囲な権限がある新しいアプリケーションが許可されていないことを検証するために、許可されたお使いのアプリケーションをレビューしてください。\n\n* [サードパーティアプリケーションと接続する](/ja/enterprise-server@3.19/apps/oauth-apps/using-oauth-apps/connecting-with-third-party-applications)\n\n  OAuth を使用して、 GitHub ID をサードパーティのアプリケーションに接続できます。 これらのアプリケーションを認可する際には、そのアプリケーションを信頼するか、誰が開発したのか、そのアプリケーションがどういった種類の情報にアクセスしたいのかを確認すべきです。\n\n* [特権 OAuth アプリ](/ja/enterprise-server@3.19/apps/oauth-apps/using-oauth-apps/privileged-oauth-apps)\n\n  一部の OAuth apps は、特別な機能が付与されている、 GitHubが所有する特権アプリです。\n\n* [GitHub アプリと OAuth アプリの違い](/ja/enterprise-server@3.19/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)\n\n  一般に、 GitHub Apps は、きめ細かいアクセス許可を使用し、アプリがアクセスできるリポジトリをより細かく制御し、有効期間の短いトークンを使用するため、 OAuth apps することをお勧めします。\n\n* [OAuth アプリのレート制限](/ja/enterprise-server@3.19/apps/oauth-apps/building-oauth-apps/rate-limits-for-oauth-apps)\n\n  レート制限は、GitHub.com へのトラフィックのレートを制限し、すべてのユーザーに一貫したアクセスを確保するのに役立ちます。\n\n* [OAuth アプリの作成](/ja/enterprise-server@3.19/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app)\n\n  OAuth app は、個人アカウント、または管理アクセス権がある Organization で作成して登録できます。 OAuth app を作成する際には、公開してもよいと考える情報だけを使用して、プライバシーを保護することを忘れないようにしてください。\n\n* [OAuth アプリを使用した REST API の認証](/ja/enterprise-server@3.19/apps/oauth-apps/building-oauth-apps/authenticating-to-the-rest-api-with-an-oauth-app)\n\n  さまざまな認証方法について、いくつかの例で学びます。\n\n* [OAuth アプリの承認](/ja/enterprise-server@3.19/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps)\n\n  他のユーザーが OAuth app を承認できるようにすることができます。\n\n* [OAuth アプリのスコープ](/ja/enterprise-server@3.19/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps)\n\n  スコープによって、必要なアクセスの種類を正確に指定できます。 スコープによって OAuth トークンへのアクセスが *制限* されます。 ユーザがすでに持っている範囲を超えた権限を許可することはありません。\n\n* [OAuth アプリのカスタムバッジを作成する](/ja/enterprise-server@3.19/apps/oauth-apps/building-oauth-apps/creating-a-custom-badge-for-your-oauth-app)\n\n  独自のロゴ画像をアップロードし、背景をカスタマイズすることによって、OAuth app の既定のバッジを置き換えることができます。\n\n* [OAuth アプリを作成するためのベスト プラクティス](/ja/enterprise-server@3.19/apps/oauth-apps/building-oauth-apps/best-practices-for-creating-an-oauth-app)\n\n  OAuth appのセキュリティとパフォーマンスを向上させるには、次のベスト プラクティスに従ってください。\n\n* [OAuth アプリの変更](/ja/enterprise-server@3.19/apps/oauth-apps/maintaining-oauth-apps/modifying-an-oauth-app)\n\n  OAuth app を作成して登録した後、それに変更を加えることができます。\n\n* [OAuth アプリのオプション機能のアクティブ化](/ja/enterprise-server@3.19/apps/oauth-apps/maintaining-oauth-apps/activating-optional-features-for-oauth-apps)\n\n  OAuth apps の新しいオプション機能をテストすることができます。\n\n* [OAuth アプリの所有権を移譲する](/ja/enterprise-server@3.19/apps/oauth-apps/maintaining-oauth-apps/transferring-ownership-of-an-oauth-app)\n\n  OAuth app の所有権は、他のユーザーまたは Organization に譲渡できます。\n\n* [認可リクエストエラーのトラブルシューティング](/ja/enterprise-server@3.19/apps/oauth-apps/maintaining-oauth-apps/troubleshooting-authorization-request-errors)\n\n  ユーザのOAuthトークンを取得する場合、初期の認可リクエストのフェーズでエラーが生じることがあります。\n\n* [OAuth アプリ アクセス トークンのリクエスト エラーのトラブルシューティング](/ja/enterprise-server@3.19/apps/oauth-apps/maintaining-oauth-apps/troubleshooting-oauth-app-access-token-request-errors)\n\n  アクセストークンのコードを交換する場合、発生しうるエラーが増えます。 これらのレスポンスのフォーマットは、渡したacceptヘッダによって決まります。\n\n* [OAuth アプリの削除](/ja/enterprise-server@3.19/apps/oauth-apps/maintaining-oauth-apps/deleting-an-oauth-app)\n\n  OAuth apps は、使わなくなったら削除できます。\n\n* [GitHub 認証の発見エンドポイント](/ja/enterprise-server@3.19/apps/github-authentication-discovery-endpoints)\n\n  GitHub は、OAuth 2.0 および OpenID Connect メタデータ ドキュメントを発行します。"}