Organization の GitHub Marketplace から GitHub アプリをインストールする

GitHub Marketplace

について

この記事は、GitHub Marketplace から GitHub Apps をインストールおよび購入する場合に適用されます。 GitHub Marketplace 以外のソースから GitHub Apps をインストールする方法については、サードパーティ製 GitHub App のインストール を参照してください。

Organization アカウントに GitHub App をインストールし、有料プランを選択した場合、Organization の現在の請求日に、Organization で既に使用している支払い方法を使用してアプリのサブスクリプション料金が請求されます。

無料のトライアルがある有料プランを選択した場合、トライアルの期間中にはいつでも課金されることなくキャンセルができますが、アプリケーションへのアクセスは自動的にできなくなります。 有料プランは 14 日間のトライアルの終了時に開始されます。 詳しくは、「GitHub Marketplace アプリのサブスクリプション」をご覧ください。

GitHub Marketplace から GitHub App の代わりに OAuth app をインストールする方法については、「Organization での OAuth アプリのインストール」を参照してください。

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

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

アプリをインストールすると、要求された organization およびリポジトリ リソースにアクセスするアクセス許可がアプリに付与されます。 インストール プロセス中、GitHub App によって要求されたアクセス許可が GitHub によって通知されます。 これらのアクセス許可で GitHub App が実行できる REST API 要求の詳細については、「GitHub Appに必要な権限」を参照してください。

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

GitHub App のインストール前に、GitHub App の所有者を信頼するようにしてください。 また、GitHub App から要求されているアクセス許可を見て、そうした許可を与えることに問題がないことを確認してください。 これらのアクセス許可で GitHub App が実行できる REST API 要求の詳細については、「GitHub Appに必要な権限」を参照してください。

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

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

GitHub App をインストールした後、アプリの承認を求められる場合があります。

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

たとえば、GitHub App にリポジトリのメタデータの読み取り、イシューを書き込む権限を付与し、GitHub App にすべてのリポジトリへのアクセス権を付与できます。

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

たとえば、GitHub App に、メール アドレスを読み取ったり、gist を書き込んだりするアクセス許可を付与できます。

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

GitHub Apps の承認について詳しくは、「GitHub App の承認」を参照してください。

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

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

クレジットカードで支払っている Enterprise の場合、Enterprise の所有者と Organization の所有者を兼ねているユーザーは、Enterprise 内の Organization に GitHub Apps をインストールできます。

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

"アプリ マネージャー" ロールでは、Organization に GitHub App をインストールできません。 詳しくは、「GitHub App マネージャーについて」をご覧ください。

これらのステップを実行してください：

Organization で GitHub Appをインストールする

1. GitHub Marketplace を開くには、GitHub の左上隅にある を選んでから、[ Marketplace] をクリックします。

   

2. インストールしたいアプリケーションを探し、アプリケーション名をクリックしてください。

3. アプリのページの [Pricing and setup] (価格とセットアップ) で、使用する価格プランをクリックします。

4. [無料でインストール] 、 [GitHub で購入] 、 [14 日間無料で試す] のいずれかをクリックします。

5. アプリのインストール組織を選びます。 組織のサービス使用条件に応じて、このプロセスは若干異なります。

   • 組織の名前と住所の情報を収集するための GitHub アクセス許可を持っている場合は、[課金情報] セクションで、 [Switch billing account] (課金アカウントの切り替え) ドロップダウン メニューを選んで、アプリをインストールする組織をクリックします。
   
   • それ以外の場合は、[Review your order] (注文の確認) で [アカウント] ドロップダウン メニューを選んで、アプリをインストールする組織をクリックします。
   

6. 有料プランを選択したなら、支払い方法をレビューしてください。

   • 組織に登録されている既存の支払い方法を変更するには、 [編集] をクリックし、フォームに記入して新しい支払い方法を追加します。
   • Organization に登録されている支払い方法がない場合は、 [支払い方法の追加] をクリックし、フォームに記入してクレジット カードまたは PayPal アカウントを追加します。

7. [注文を完了してインストール開始] をクリックします。

8. アプリがリポジトリへのアクセスを必要とする場合、 [すべてのリポジトリ] または [選択したレポジトリのみ] を選びます。

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

9. アプリケーションに対して、あなたのリポジトリすべてではなく、限定されたリポジトリへのアクセスを与えることにしたなら、アプリケーションにアクセスさせたいそれぞれのリポジトリ名を入力し、そのリポジトリ名をクリックして選択してください。

10. アプリのアクセス権をレビューして、 [インストール] をクリックします。

参考資料

•           [AUTOTITLE](/billing/managing-your-billing/managing-your-payment-and-billing-information)
  

•           [AUTOTITLE](/apps/using-github-apps/installing-an-app-in-your-personal-account)