サードパーティ製 GitHub App のインストール

GitHub Appsは、アカウントで使用するアプリ所有者から直接インストールできます。

この記事で

インストールについて GitHub Apps

この記事では、GitHub Appからではなく、アプリ所有者から直接GitHub Marketplaceをインストールする方法について説明します。 GitHub AppsからのGitHub Marketplaceのインストールの詳細については、個人向けアカウント用に GitHub Marketplace から GitHub アプリをインストールする と Organization の GitHub Marketplace から GitHub アプリをインストールする を参照してください。 所有している GitHub Apps のインストールの詳細については、 独自のGitHub アプリのインストール を参照してください。

メモ

このインストール フローは、サードパーティのアプリでも、企業が所有するアプリでも、任意の GitHub Appに適用されます。 アプリのオーナーが提供するリンクを使用して、アプリを手動でインストールできます。

リソースにGitHub Appを使用するには、企業、の組織または個人アカウントアプリをインストールする必要があります。 複数のアカウントに同じ GitHub App をインストールできます。 たとえば、自分の個人アカウントと、自分が所有するいくつかの組織にアプリをインストールした場合は、個人リポジトリ、アプリをインストールした組織、それらの組織が所有するリポジトリで、そのアプリを使用できます。

アプリをインストールするときは、要求した エンタープライズリソースまたは 整理リソースとリポジトリ リソースにアクセスするためのアクセス許可をアプリに付与します。 インストール プロセス中に、 GitHub は、 GitHub App が要求したアクセス許可を通知します。 GitHub Appがこれらのアクセス許可を使用して行うことができる REST API 要求の詳細については、GitHub Apps に必要なアクセス許可 を参照してください。

リポジトリのアクセス許可を要求するアプリをインストールするときに、 GitHub App アクセス権を付与するリポジトリも選択します。

GitHub Appをインストールする前に、GitHub Appの所有者を信頼する必要があります。 また、 GitHub App が要求しているアクセス許可を確認し、それらのアクセス許可を快適に付与していることを確認する必要があります。 GitHub Appがこれらのアクセス許可を使用して行うことができる REST API 要求の詳細については、GitHub Apps に必要なアクセス許可 を参照してください。

インストールできるアプリの数に上限はありません。

インストールと承認の違い

GitHub Appをインストールした後、アプリの承認を求めることもできます。

アカウントまたは組織に**** をGitHub Appする場合は、要求した組織およびリポジトリ リソースにアクセスするためのアクセス許可をアプリに付与します。 また、アプリからアクセスできるリポジトリも指定します。 インストール プロセス中に、付与するリポジトリと組織のアクセス許可が GitHub App によって示されます。 GitHub Appを有効にするさまざまなアクセス許可の詳細については、「GitHub アプリのアクセス許可の選択」を参照してください。

たとえば、リポジトリメタデータの読み取りと問題の書き込みに対する GitHub App アクセス許可を付与したり、 GitHub App にすべてのリポジトリへのアクセス権を付与したりすることができます。

GitHub アプリをインストールするページのスクリーンショット。 アプリは、メタデータへの読み取りアクセスと、issue への書き込みアクセスを要求します。

** **をGitHub Appするときは、アプリが要求したアカウントのアクセス許可に基づいて、GitHub アカウントへのアクセス権をアプリに付与します。 承認プロセス中に、アプリによりアプリがアカウントでアクセスできるリソースが示されます。 GitHub Appを承認すると、ユーザーに代わって動作するアクセス許可もアプリに付与されます。

たとえば、電子メール アドレスを読み取り、gists を書き込むためのアクセス許可を GitHub App に付与できます。

GitHub アプリを承認するページのスクリーンショット。 アプリは、電子メールへの読み取りアクセスと、gist への書き込みアクセスを要求しています。

アプリを承認しなくても、 GitHub App をインストールできます。 同様に、アプリをインストールしなくてもアプリを承認できます。

GitHub Appsの承認の詳細については、GitHub アプリの承認 を参照してください。

をインストールするための要件 GitHub App

誰でもGitHub Appsでない限り、自分の個人アカウントにEnterprise Managed Userをインストールできます。

組織の所有者は、組織に GitHub Apps をインストールできます。

エンタープライズ所有者は、エンタープライズ アカウントに GitHub Apps をインストールできます。アプリケーションがエンタープライズのアクセス許可を要求し、企業またはそのいずれかの組織が所有している場合です。

リポジトリ管理者は、アプリが組織のアクセス許可や "リポジトリ管理" アクセス許可を要求しない場合、リポジトリを所有する組織に GitHub Apps をインストールできます。 その場合、管理者が管理するリポジトリにアクセスできるアプリのみをインストールできます。 組織の所有者は、リポジトリ管理者 GitHub App インストールを制限できます。 この制限を有効にすると、リポジトリ管理者は GitHub Apps をインストールできず、代わりに組織の所有者が目的のアプリをインストールすることを要求する必要があります。 詳細については、 AUTOTITLE を参照してください。

組織のメンバーと、組織にアプリをインストールできない外部のコラボレーターは、インストール プロセス中に組織を選択できます。 アプリをインストールする代わりに、 GitHub は組織の所有者に通知を送信し、組織の所有者にアプリのインストールを要求します。 これらの要求を行う機能は、アプリ アクセス要求ポリシーを使用して制御できます。 「OAuth アプリと GitHub アプリのアクセス要求とインストールの制限」を参照してください。

"アプリ マネージャー" ロールでは、組織GitHub App企業にをインストールすることはできません。 「アプリ マネージャー GitHubについて」を参照してください。

GitHub App をインストールする

インストール プロセス中に、アプリ所有者から GitHub URL に誘導され、 GitHub Appがインストールされます。 URL は https://github.com/apps/APP-NAME/installations/new のようになります。ここで、 APP-NAME は GitHub Appの名前です。

  1. GitHub Appをインストールする場所を選択します。 個人アカウントまたは自分がメンバーになっている組織を選択できます。 エンタープライズ所有者の場合は、アプリが企業をサポートしている場合は、企業にアプリをインストールすることもできます。

    メモ

    Organization で SAML SSO を使用しており、Organization が一覧表示されない場合、Organization のアクティブな SAML セッションを開始することが必要な場合があります。 詳しくは、「SAML アプリと GitHub Apps」をご覧ください。

  2. アプリにリポジトリ権限が必要な場合は、[すべてのリポジトリ] または [選択したレポジトリのみ] を選びます。 アプリは常に、 GitHub上のすべてのパブリック リポジトリへの読み取り専用アクセス権を持つことになります。

    アプリでリポジトリのアクセス許可が必要ない場合、これらのオプションは表示されません。

  3. 前の手順で [選択したリポジトリのみ] を選んだ場合は、[リポジトリの選択] ドロップダウンで、アプリでアクセスするリポジトリを選択します。

    アプリがリポジトリを作成する場合、そのリポジトリに対するアクセス権も自動的に付与されます。

  4. アプリが要求しているアクセス許可を確認します。 GitHub Appがこれらのアクセス許可を使用して行うことができる REST API 要求の詳細については、GitHub Apps に必要なアクセス許可 を参照してください。

  5. [インストール]、[インストールして要求]、または [要求] を選択します。 表示されるボタンは、組織の所有者がアプリに対して要求されたアクセス権のうち、いずれか、またはいくつか、またはすべてを承認する必要があるかどうかによって異なります。 エンタープライズ インストールは要求できません。エンタープライズ所有者はアプリを直接インストールする必要があります。 詳細については、「GitHub Appをインストールするための要件」を参照してください。