{"meta":{"title":"Enterprise に GitHub アプリをインストールする","intro":"エンタープライズに GitHub Apps をインストールして、エンタープライズ アカウントを管理し、エンタープライズ レベルの操作を実行できます。","product":"アプリ","breadcrumbs":[{"href":"/ja/enterprise-cloud@latest/apps","title":"アプリ"},{"href":"/ja/enterprise-cloud@latest/apps/using-github-apps","title":"GitHub Apps を使用する"},{"href":"/ja/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-on-your-enterprise","title":"Enterprise にアプリをインストールする"}],"documentType":"article"},"body":"# Enterprise に GitHub アプリをインストールする\n\nエンタープライズに GitHub Apps をインストールして、エンタープライズ アカウントを管理し、エンタープライズ レベルの操作を実行できます。\n\n> \\[!NOTE]\n> エンタープライズインストールの GitHub Apps は パブリック プレビュー であり、変更される可能性があります。\n\n## 企業への GitHub Apps のインストールについて\n\nエンタープライズインストール GitHub Apps は、エンタープライズ レベルのアクセス許可を要求し、エンタープライズ アカウントに対して操作を実行できるアプリです。 組織またはユーザーのインストールとは異なり、組織やリポジトリのアクセス権限を持たず、企業そのものの管理のみを行います。\n\nエンタープライズ所有者が企業に GitHub App をインストールすると、アプリには、要求されたエンタープライズアクセス許可が付与されます。 これらのアクセス許可により、アプリは Enterprise 内での organization の作成、organization 全体へのアプリケーションのインストール、SCIM プロビジョニングの管理などの操作を実行できます。\n\n## 企業に GitHub App をインストールするための要件\n\nGitHub Appは、エンタープライズ レベルのアクセス許可を要求する必要があります。 他のアクセス許可も要求できますが、インストール時には Enterprise アクセス許可のみが付与されます。\n\nこのアプリは、企業、企業内の組織、またはサードパーティの開発者が所有できます。 サード パーティからパブリック アプリをインストールするには、アプリの開発者が提供するインストール リンクを使用します。 企業外のアカウントが所有するプライベート アプリをインストールすることはできません。\n\n> \\[!NOTE]\n> 企業間でサード パーティ製アプリをインストールする場合には、1 つの例外があります。 アプリが \"エンタープライズ組織のインストール\" アクセス許可を要求した場合、アプリを所有する企業にのみインストールできます。 このアプリが企業外に所有されている場合、このアプリを企業にインストールすることはできません。 EMU 企業と GHES では、企業のユーザーは企業内と見なされるため、アプリを企業にインストールできます。\n\n## 企業への GitHub App のインストール\n\n企業にアプリをインストールするには、 GitHub App インストール ページに移動します。 これは、アプリ開発者によってインストール リンクとして提供される場合や、また、アプリの登録情報に記載されている場合があります。 URL は `https://github.com/apps/APP-NAME/installations/new` のようになります。ここで、 `APP-NAME` は GitHub Appの名前です。\n\nアプリをインストールできる場合は、使用できるインストール場所の一覧に Enterprise が含まれます。 アプリをインストールするための企業を選択できます。\n\nインストール後、アプリで Enterprise 用のインストール トークンを作成したり、Enterprise レベルで Enterprise メンバーに代わって操作するために Enterprise メンバーをサインインしたりできるようになります。 ユーザーに代わって操作するには、ユーザーが Enterprise 内で目的の操作を実行できる必要があります。 たとえば、アプリがユーザーを Enterprise に招待する必要がある場合、ユーザーには Enterprise にメンバーを招待するアクセス許可も必要です。\n\n## Enterprise インストール アプリでできること\n\nエンタープライズインストール GitHub Apps では、すべてのエンタープライズ API を呼び出すことはできませんが、 GitHub Appsをサポートするためにいくつかの API が既に更新されています。 これらの API と GraphQL のミューテーションには次のものが含まれます。\n\n* [エンタープライズ内の組織の一覧表示と作成](/ja/enterprise-cloud@latest/graphql/reference/enterprise-admin#mutation-createenterpriseorganization)\n* [Enterprise 内のユーザーを管理する](/ja/enterprise-cloud@latest/graphql/reference/enterprise-admin#object-enterprise)\n* 組織での GitHub App インストールの作成と管理\n* エンタープライズ カスタム リポジトリのプロパティを管理する\n* 予算、コスト センター、使用状況レポートなど、エンタープライズ課金を管理します。 詳細については、「[請求の REST API エンドポイント](/ja/enterprise-cloud@latest/rest/billing)」を参照してください。\n* Enterprise SCIM API を呼び出す\n\n新しい API と[](https://github.blog/changelog/)のアクセス許可の更新に関する変更ログを確認してください。\n\n使用できるアクセス許可と API エンドポイントの詳細については、「[GitHub Apps に必要なアクセス許可](/ja/enterprise-cloud@latest/rest/authentication/permissions-required-for-github-apps)」を参照してください。\n\n## エンタープライズインストールのレート制限 GitHub Apps\n\nエンタープライズにインストールされた GitHub Apps のインストール トークンには、 GitHub Enterprise Cloud 組織と同じレート制限があります。 レート制限はインストールごとに適用されます。 たとえば、アプリが Enterprise と 2 つの organization にインストールされている場合、それらにアクセスするには 3 つのインストール トークンが必要になり、インストールごとに完全な独立したレート制限予算が設定されます。 詳細については、「[REST API のレート制限](/ja/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api)」および「[GraphQL API のレート制限とクエリ制限](/ja/enterprise-cloud@latest/graphql/overview/rate-limits-and-query-limits-for-the-graphql-api)」を参照してください。\n\n## 現在の制限\n\nエンタープライズ環境にインストールされたGitHub Appsは現在パブリック プレビューであり、以下の制限があります。\n\n### API のサポート\n\n一部の API では、エンタープライズインストール GitHub Apps はまだサポートされていません。 より多くのアクセス許可が構築され、API が更新されるにつれて、サポートはさらに拡大されます。 エンタープライズインストールの GitHub Appsをサポートする API とアクセス許可の詳細については、「 [GitHub Apps に必要なアクセス許可](/ja/enterprise-cloud@latest/rest/authentication/permissions-required-for-github-apps)」を参照してください。\n\n### Webhook のサポート\n\n現在、Enterprise インストールでは、Webhook はサポートされていません。 Enterprise レベルでインストールされたアプリは、Enterprise レベルのアクティビティの Webhook イベントを受け取ることができません。 それらのリソースに対する Webhook イベントを受け取るには、Organization またはリポジトリにインストールします。\n\n### 組織アクセス\n\nエンタープライズ インストールでは、組織インストール API を除き、当該エンタープライズ内の組織やリポジトリへのアクセス権は付与されません。 Organization またはリポジトリのリソースにアクセスするには、アクセス権が必要な organization ごとにアプリを個別にインストールする必要があります。\n\n多くの組織で同じアプリをインストールする必要がある場合は、API を使用してこれを自動化できます。 「[企業の組織でのアプリのインストールの自動化](/ja/enterprise-cloud@latest/admin/managing-github-apps-for-your-enterprise/automate-installations)」を参照してください。\n\n## 次のステップ\n\n* 特定の organization にアプリへのアクセス権を付与するには、その organization にアプリをインストールします。 詳しくは、「[サードパーティ製 GitHub App のインストール](/ja/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party)」をご覧ください。\n* 組織でインストールされているアプリの管理について学びます。 詳しくは、「[インストールされている GitHub Apps の確認と変更](/ja/enterprise-cloud@latest/apps/using-github-apps/reviewing-and-modifying-installed-github-apps)」をご覧ください。"}