GitHub Apps の概要
GitHub Apps は、 GitHubの機能を拡張するツールです。 GitHub Apps では、未解決の問題、pull request に関するコメント、プロジェクトの管理など、 GitHub に関する操作を行うことができます。 また、GitHubで発生するイベントに基づいて、GitHubの外部で行うこともできます。 たとえば、 GitHub App は、 GitHubで問題が開かれたときに Slack に投稿できます。
検索 GitHub Apps
サードパーティ製アプリケーションを企業にインストールすることはできません。 サード パーティのアプリの機能を使いたい場合は、マニフェストまたは URL パラメーターからアプリを作成する方法について、アプリ開発者に問い合わせてください。 詳細については、 マニフェストからのGitHub アプリの登録 と URL パラメーターを使用したGitHub アプリの登録 を参照してください。
独自の GitHub Appを構築することもできます。 詳しくは、「GitHub アプリの作成について」をご覧ください。
GitHub Apps の使用
GitHub Appを使用するには、ユーザー、または組織アカウントにアプリをインストールする必要があります。 アプリをインストールすると、アカウントのデータの読み取りまたは変更のアクセス許可がアプリに付与されます。 特定のアクセス許可はアプリによって異なり、 GitHub はアプリをインストールする前にアプリが要求したアクセス許可を示します。 組織またはユーザー アカウントにアプリをインストールするときに、アプリがアクセスできるリポジトリも指定します。
アプリで追加の構成が必要な場合は、その構成を行うようアプリで指示されます。 詳細については、「 サードパーティ製 GitHub App のインストール 、 独自のGitHub アプリのインストール」を参照してください。
また、ID を確認したり、アクセスできるリソースを把握したり、ユーザーに代わってアクションを実行したりするために、 GitHub App を承認する必要がある場合もあります。 アプリを承認する必要がある場合は、それを求めるメッセージがアプリで表示されます。 アプリがユーザーに代わって操作する場合、リソースを所有するアカウントにそのアプリがインストールされ、適切なアクセス許可が付与されている限り、そのアプリはユーザーと同じリソースにアクセスできます。 詳しくは、「GitHub アプリの承認」をご覧ください。
場合によっては、 GitHub App は更新されたアクセス許可を要求します。 GitHub は、これが発生すると通知します。 アプリを引き続き機能させるには、更新されたアクセス許可を確認して承認する必要があります。 詳しくは、「GitHub アプリの更新されたアクセス許可の承認」をご覧ください。
GitHub Appをインストールまたは承認する前に、アプリ開発者を信頼していることを確認する必要があります。 アプリを使わなくなった場合は、アプリの一時停止またはアンインストールと、アプリの承認の取り消しの両方または一方を、行う必要があります。 詳細については、「インストールされている GitHub Apps の確認と変更」および「GitHub アプリの承認の確認と取り消し」を参照してください。
GitHub Apps および OAuth apps
GitHub では、 OAuth appsもサポートされます。 GitHub Appsとは異なり、OAuth appをインストールしたり、アクセスできるリポジトリを制御したりすることはありません。
OAuth appsとGitHub Appsの両方で OAuth 2.0 が使用されます。
OAuth apps はユーザーに代わってのみ動作できますが、 GitHub Apps はユーザーの代わりに動作することも、ユーザーとは独立して動作することもできます。
詳細については、「GitHub アプリと OAuth アプリの違い」および「OAuth アプリの承認」を参照してください。