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

組織で使うため、GitHub Marketplace から GitHub Apps をインストールできます。

この記事の内容

GitHub Marketplace

について

この記事は、GitHub Marketplace からの GitHub Apps のインストールと購入に当てはまります。 GitHub Marketplace 以外のソースから GitHub Apps をインストールする方法については、「サード パーティからの GitHub App のインストール」をご覧ください。

Note

GitHub Marketplace のアプリは、現在 GHE.com で使用できません。

Organization アカウントに GitHub App をインストールし、有料プランを選ぶ場合、Organization の既存の支払方法を使い、Organization の現行の請求日付にアプリ サブスクリプションの料金を支払います。

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

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

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

リポジトリまたは組織で GitHub App を使うには、組織または個人のアカウントにアプリをインストールする必要があります。 同じ 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 アプリをインストールするページのスクリーンショット。 アプリは、メタデータへの読み取りアクセスと、イシューへの書き込みアクセスを要求しています。 アプリは、電子メールへの読み取りアクセスと gist への書き込みアクセスのユーザー承認を要求することもできます。

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

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

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

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

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

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

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

クレジット カードで支払うエンタープライズの場合、組織所有者でもあるエンタープライズ所有者は、エンタープライズ内の組織に GitHub Apps をインストールできます。

組織が所有しているリポジトリの管理者は、自分が管理者であるリポジトリへのアクセスのみをアプリに許可する場合、且つアプリが組織の権限または "リポジトリ管理" 権限を要求しない場合に、組織に GitHub Apps をインストールすることもできます。　 組織所有者は、リポジトリ管理者である外部コラボレーターが GitHub Apps をインストールできないようにすることができます。

Organization の "アプリ マネージャー" ロールは、Organization に GitHub App をインストールする権限をユーザーに与えるものではありません。 詳しくは、「GitHub App マネージャーについて」を参照してください。

エンタープライズ マネージド ユーザー アカウントの場合、企業の所有者のみが、エンタープライズの organization 用に有料の GitHub App を購入してインストールできます。 エンタープライズ メンバーは、有料の GitHub App を購入できません。 エンタープライズ マネージド ユーザー アカウントを持つ organization の所有者は、引き続き無料の GitHub App をインストールできます。

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

  1. GitHub Marketplace を開くには、GitHub の左上隅にある を選択し、 [マーケットプレース] をクリックします。

    GitHub Enterprise Cloud のナビゲーション バーの スクリーンショット。 [グローバル ナビゲーション メニューを開く] アイコンが濃いオレンジ色の枠線で囲まれています。

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

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

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

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

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

    GitHub Marketplace アプリ購入画面のスクリーンショット。 [Switch billing account] (課金アカウントの切り替え) というラベルが付いた、折りたたまれた青色のドロップダウン メニューが、濃いオレンジ色で囲まれています。

    • それ以外の場合は、[Review your order] (注文の確認) で [アカウント] ドロップダウン メニューを選んで、アプリをインストールする組織をクリックします。

    GitHub Marketplace アプリ購入画面のスクリーンショット。 [アカウント] というラベルが付いた、折りたたまれた灰色のドロップダウン メニューが、濃いオレンジ色で囲まれています。

    Note

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

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

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

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

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

    アプリによって何らかのリポジトリが作成される場合、そのようなリホームにアクセスする権限もアプリに自動的に与えられます。

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

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

参考資料