# GitHub Apps の使用について

GitHub App とは何か、そして GitHub App を使う理由について説明します。

## GitHub Apps について

GitHub Apps は、GitHub の機能を拡張するツールです。 GitHub Apps を使うと、GitHub で、issue を開く、pull request にコメントする、プロジェクトを管理する、といったことを行うことができます。 また、GitHub で発生するイベントに基づいて、GitHub の外部で何かを行うこともできます。 たとえば、GitHub で issue が開かれたときに、GitHub App で Slack に投稿できます。

## GitHub Apps の検索

GitHub Apps は、[GitHub Marketplace](https://github.com/marketplace) で見つけることができます。

独自の GitHub App を作成することもできます。 詳しくは、「[GitHub アプリの作成について](/ja/apps/creating-github-apps/setting-up-a-github-app/about-creating-github-apps)」をご覧ください。

## GitHub Apps を使用する

GitHub App を使用するには、ユーザーまたは組織アカウントにアプリをインストールする必要があります。 アプリをインストールすると、アカウントのデータの読み取りまたは変更のアクセス許可がアプリに付与されます。 具体的なアクセス許可はアプリによって異なり、アプリで要求されているアクセス許可は、アプリをインストールする前に GitHub によって示されます。 Organization またはユーザー アカウントにアプリをインストールするときに、アプリがアクセスできるリポジトリも指定します。

アプリで追加の構成が必要な場合は、その構成を行うようアプリで指示されます。 詳細については、「[個人向けアカウント用に GitHub Marketplace から GitHub アプリをインストールする](/ja/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-personal-account)」、「[Organization の GitHub Marketplace から GitHub アプリをインストールする](/ja/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-organizations)」、「[サードパーティ製 GitHub App のインストール](/ja/apps/using-github-apps/installing-a-github-app-from-a-third-party)」、「[独自のGitHub アプリのインストール](/ja/apps/using-github-apps/installing-your-own-github-app)」を参照してください。

また、ID の検証、アクセスできるリソースの把握、ユーザーの代理でのアクションの実行を、GitHub App に承認することが必要な場合もあります。 アプリを承認する必要がある場合は、それを求めるメッセージがアプリで表示されます。 アプリがユーザーに代わって操作する場合、リソースを所有するアカウントにそのアプリがインストールされ、適切なアクセス許可が付与されている限り、そのアプリはユーザーと同じリソースにアクセスできます。 詳しくは、「[GitHub アプリの承認](/ja/apps/using-github-apps/authorizing-github-apps)」をご覧ください。

場合によっては、更新されたアクセス許可を GitHub App が要求することがあります。 これが発生すると、GitHub によって通知されます。 アプリを引き続き機能させるには、更新されたアクセス許可を確認して承認する必要があります。 詳しくは、「[GitHub アプリの更新されたアクセス許可の承認](/ja/apps/using-github-apps/approving-updated-permissions-for-a-github-app)」をご覧ください。

GitHub App をインストールまたは承認する前に、アプリの開発者を信頼できることを確認する必要があります。 アプリを使わなくなった場合は、アプリの一時停止またはアンインストールと、アプリの承認の取り消しの両方または一方を、行う必要があります。 詳細については、「[インストールされている GitHub Apps の確認と変更](/ja/apps/using-github-apps/reviewing-and-modifying-installed-github-apps#blocking-access)」および「[GitHub アプリの承認の確認と取り消し](/ja/apps/using-github-apps/reviewing-your-authorized-integrations)」を参照してください。

## GitHub Apps と OAuth apps

GitHub は、OAuth apps もサポートします。 GitHub Apps とは異なり、ユーザーが OAuth app をインストールしたり、アクセスできるリポジトリを制御したりすることはありません。

OAuth apps と GitHub Apps はどちらも OAuth 2.0 を使います。

OAuth apps はユーザーに代わってのみ動作できるのに対し、GitHub Apps はユーザーの代わりに、またはユーザーと関係なく動作できます。

詳細については、「[GitHub アプリと OAuth アプリの違い](/ja/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)」および「[OAuth アプリの承認](/ja/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps)」を参照してください。