# 在企业上安装 GitHub App

您可以在企业环境中安装 GitHub Apps，以管理您的企业账户并执行企业级操作。

> \[!NOTE]
> 企业安装的 GitHub Apps 处于 公开预览，可能会有变化。

## 关于在您的企业中安装 GitHub Apps

企业安装的 GitHub Apps 是请求企业级权限的应用，可以在企业帐户上执行操作。 与组织或用户安装不同，它们无权访问任何组织或仓库权限，它们只管理企业本身。

当企业所有者在企业上安装应用 GitHub App 时，应用将被授予它请求的企业权限。 这些权限允许应用执行创建企业内组织、跨组织安装应用程序和管理 SCIM 预配等操作。

## 在您的企业中安装 GitHub App 的要求

GitHub App 必须申请企业级权限。 它也可以请求其他权限，但安装时只会被授予企业权限。

应用可以由企业、企业内的组织或第三方开发人员拥有。 若要从第三方安装公共应用，请使用应用的开发人员提供的安装链接。 不能安装企业外部帐户拥有的专用应用。

> \[!NOTE]
> 跨企业安装第三方应用有一个例外。 如果应用请求“企业组织安装”权限，则只能在拥有该应用的企业上安装它。 如果此应用在企业外部拥有，则无法在企业上安装此应用。 在 EMU 企业和 GHES 中，企业的用户算作企业内部，因此可以在企业上安装其应用。

## 在您的企业中安装 GitHub App

若要在企业上安装应用，请导航到 GitHub App 安装页。 应用开发人员可能会提供安装页面作为安装链接，或者你可以在应用的注册中找到它。 URL 将显示为`https://github.com/apps/APP-NAME/installations/new`，其中`APP-NAME`是GitHub App的名称。

如果可以安装应用，则可用安装位置列表中将包括你的企业。 可以选择你的企业来安装应用。

安装后，应用将能够为企业创建安装令牌或登录企业成员，以便在企业级别代表他们操作。 代表用户操作要求用户能够在企业内执行所需操作。 例如，如果应用需要邀请用户加入企业，则用户还必须具有邀请成员加入企业的权限。

## 企业安装应用的功能

企业安装的 GitHub Apps 不能调用每个企业 API，但已更新多个 API 以支持 GitHub Apps。 这些 API 和 GraphQL 变更包括：

* [在企业中列出和创建组织](/zh/enterprise-cloud@latest/graphql/reference/enterprise-admin#mutation-createenterpriseorganization)
* [在企业中管理用户](/zh/enterprise-cloud@latest/graphql/reference/enterprise-admin#object-enterprise)
* 在您的组织中创建和管理 GitHub App 的安装
* 管理企业自定义存储库属性
* 管理企业计费，包括预算、成本中心和使用情况报告。 有关详细信息，请参阅“[计费 REST API 端点](/zh/enterprise-cloud@latest/rest/billing)”。
* 调用企业 SCIM API

检查 [更改日志](https://github.blog/changelog/) 中是否有有关新 API 和权限的 GitHub Apps更新。

有关可用权限和 API 终结点的详细信息，请参阅 [GitHub应用所需的权限](/zh/enterprise-cloud@latest/rest/authentication/permissions-required-for-github-apps)。

## 企业安装的 GitHub Apps 的速率限制

企业安装的 GitHub Apps 的安装令牌的速率限制与 GitHub Enterprise Cloud 组织相同。 速率限制是针对每个安装的。 例如，如果应用安装在企业和两个组织上，则需要 3 个安装令牌才能访问它们，并且每个安装都有完整、独立的速率限制预算。 有关详细信息，请参阅 [REST API 的速率限制](/zh/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api) 和 [GraphQL API 的速率限制和查询限制](/zh/enterprise-cloud@latest/graphql/overview/rate-limits-and-query-limits-for-the-graphql-api)。

## 当前限制

企业安装的 GitHub Apps 目前处于 公开预览 阶段，但存在以下限制。

### API 支持

并非所有 API 都尚支持企业安装 GitHub Apps 。 随着构建更多权限和更新 API，支持范围将更广。 有关支持企业安装的 GitHub AppsAPI 和权限的详细信息，请参阅 [GitHub应用所需的权限](/zh/enterprise-cloud@latest/rest/authentication/permissions-required-for-github-apps)。

### Webhook 支持

企业安装目前不支持 webhook。 在企业级别安装的应用无法接收企业级活动的 webhook 事件。 将它们安装在组织或仓库上以接收这些资源的 webhook 事件。

### 组织访问权限

企业安装不会被授予对企业内组织或仓库的访问权限，组织安装 API 除外。 要访问组织或仓库资源，必须将应用单独安装在每个需要访问的组织上。

如果需要在许多组织中安装同一应用，可以使用 API 自动执行此作。 请参阅“[在企业组织中自动执行应用安装](/zh/enterprise-cloud@latest/admin/managing-github-apps-for-your-enterprise/automate-installations)”。

## 后续步骤

* 要将应用访问权限授予特定组织，请在这些组织上安装应用。 有关详细信息，请参阅“[从第三方途径安装 GitHub Apps](/zh/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party)”。
* 了解如何管理组织中安装的应用。 有关详细信息，请参阅“[查看和修改已安装GitHub应用](/zh/enterprise-cloud@latest/apps/using-github-apps/reviewing-and-modifying-installed-github-apps)”。