# GitHub Apps の使用について

GitHub Appの概要と、GitHub Appを使用する理由について説明します。

## GitHub Apps の概要

GitHub Apps は、 GitHubの機能を拡張するツールです。
GitHub Apps では、未解決の問題、pull request に関するコメント、プロジェクトの管理など、 GitHub に関する操作を行うことができます。 また、GitHubで発生するイベントに基づいて、GitHubの外部で行うこともできます。 たとえば、 GitHub App は、 GitHubで問題が開かれたときに Slack に投稿できます。

## GitHub Apps の検出

サードパーティ製アプリケーションを企業にインストールすることはできません。 サード パーティのアプリの機能を使いたい場合は、マニフェストまたは URL パラメーターからアプリを作成する方法について、アプリ開発者に問い合わせてください。 詳細については、 [マニフェストからのGitHub アプリの登録](/ja/enterprise-server@3.22/apps/sharing-github-apps/registering-a-github-app-from-a-manifest) と [URL パラメーターを使用したGitHub アプリの登録](/ja/enterprise-server@3.22/apps/sharing-github-apps/registering-a-github-app-using-url-parameters) を参照してください。

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

## GitHub Apps の使用

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

アプリで追加の構成が必要な場合は、その構成を行うようアプリで指示されます。 詳細については、「 [サードパーティ製 GitHub App のインストール](/ja/enterprise-server@3.22/apps/using-github-apps/installing-a-github-app-from-a-third-party) 、 [独自のGitHub アプリのインストール](/ja/enterprise-server@3.22/apps/using-github-apps/installing-your-own-github-app)」を参照してください。

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

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

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

## 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/enterprise-server@3.22/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)」および「[OAuth アプリの承認](/ja/enterprise-server@3.22/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps)」を参照してください。