この記事では、 Marketplace からではなく、アプリ所有者から直接 App をインストールする方法について説明します。 Marketplace からの Apps のインストールの詳細については、「個人向けアカウント用に Marketplace から アプリをインストールする」と「Organization の Marketplace から アプリをインストールする」を参照してください。 自分が所有する Apps のインストールについては、「独自の App のインストール」を参照してください。
メモ
このインストール フローは、サード パーティのアプリか Enterprise が所有するアプリかに関わらず、すべての App に適用されます。 アプリのオーナーが提供するリンクを使用して、アプリを手動でインストールできます。
リポジトリまたは組織で App を使うには、組織または個人のアカウントにアプリをインストールする必要があります。 同じ App を複数のアカウントにインストールできます。 たとえば、自分の個人アカウントと、自分が所有するいくつかの組織にアプリをインストールした場合は、個人リポジトリ、アプリをインストールした組織、それらの組織が所有するリポジトリで、そのアプリを使用できます。
アプリをインストールするとき、Organization とそれに要求されたリポジトリ リソースにアクセスする許可をアプリに与えます。 インストール プロセス中、 App によって要求されたアクセス許可が によって通知されます。 これらのアクセス許可で App が実行できる REST API 要求の詳細については、「 Appに必要な権限」を参照してください。
アプリをインストールするとき、 App にアクセス権を与えるリポジトリも選びます。
App のインストール前に、 App の所有者を信頼するようにしてください。 また、 App から要求されているアクセス許可を見て、そうした許可を与えることに問題がないことを確認してください。 これらのアクセス許可で App が実行できる REST API 要求の詳細については、「 Appに必要な権限」を参照してください。
インストールできるアプリの数に上限はありません。
App のインストール後、アプリの認可を求められることもあります。
アカウントまたは組織に App をインストールするときに、アプリが要求した組織とリポジトリのリソースにアクセスするためのアクセス許可をアプリに付与します。 また、アプリからアクセスできるリポジトリも指定します。 インストール プロセス中、 App により、付与するリポジトリと組織のアクセス許可が示されます。 さまざまなアクセス許可により App で実行可能となることの詳細については、「 アプリのアクセス許可を選択する」を参照してください。
たとえば、 App にリポジトリのメタデータの読み取り、イシューを書き込む権限を付与し、 App にすべてのリポジトリへのアクセス権を付与できます。
App を承認する際に、アプリが要求したアカウントのアクセス許可に基づいて、 アカウントへのアクセス権をそのアプリに付与します。 承認プロセス中に、アプリによりアプリがアカウントでアクセスできるリソースが示されます。 App を承認したら、ユーザーに代わって動作するアプリのアクセス許可も付与します。
たとえば、 App に、メール アドレスを読み取ったり、gist を書き込んだりするアクセス許可を付与できます。
アプリを承認しなくても、 App をインストールできます。 同様に、アプリをインストールしなくてもアプリを承認できます。
Apps の認可の詳細については、「 App の承認」を参照してください。
Apps は、誰でも自分の個人用アカウントにインストールできます。
組織の所有者は、組織に Apps をインストールできます。
組織が所有しているリポジトリの管理者は、自分が管理者であるリポジトリへのアクセスのみをアプリに許可する場合、且つアプリが組織の権限または "リポジトリ管理" 権限を要求しない場合に、組織に Apps をインストールすることもできます。 組織所有者は、リポジトリ管理者である外部コラボレーターが Apps をインストールできないようにすることができます。
Organization 所有者でもリポジトリ管理者でもない Organization メンバーは引き続き、インストール プロセス中に Organization を選ぶことができます。 アプリをインストールする代わりに、 では Organization 所有者に通知を送信し、Organization 所有者にアプリのインストールを要求します。
Organization の "アプリ マネージャー" ロールは、Organization に App をインストールする権限をユーザーに与えるものではありません。 「 App マネージャーについて」を参照してください。
インストール プロセス中に、アプリ所有者は、 App をインストールする URL に誘導します。 URL は https://.com/apps/APP-NAME/installations/new のようになります。ここで、APP-NAME は App の名前です。
App をインストールする場所を選びます。 個人用アカウント、または自分がメンバーである Organization を選ぶことができます。
メモ
Organization で SAML SSO を使用しており、Organization が一覧表示されない場合、Organization のアクティブな SAML セッションを開始することが必要な場合があります。 詳しくは、「SAML と Apps」をご覧ください。
アプリでリポジトリのアクセス許可が必要な場合は、 [すべてのリポジトリ] または [選択したレポジトリのみ] を選びます。 アプリは常に、 上のすべてのパブリック リポジトリへの読み取り専用アクセス権を持つようになります。
アプリでリポジトリのアクセス許可が必要ない場合、これらのオプションは省略されます。
前の手順で [選択したリポジトリのみ] を選んだ場合は、 [リポジトリの選択] ドロップダウンで、アプリでアクセスするリポジトリを選びます。
アプリによって何らかのリポジトリが作成される場合、それらのリポジトリにアクセスする権限もアプリに自動的に与えられます。
アプリが要求しているアクセス許可を確認します。 これらのアクセス許可で App が実行できる REST API 要求の詳細については、「 Appに必要な権限」を参照してください。
[インストール] 、 [インストールと要求] 、または [要求] をクリックします。 表示されるボタンは、組織の所有者がアプリへのアクセスの要求を承認しない、一部承認する、またはすべて承認する、のいずれを行う必要があるかによって異なります。 詳細については、「 App をインストールするための要件」を参照してください。