{"meta":{"title":"从第三方途径安装 GitHub Apps","intro":"可以直接从应用所有者安装 GitHub Apps ，以在帐户上使用。","product":"应用","breadcrumbs":[{"href":"/zh/enterprise-server@3.20/apps","title":"应用"},{"href":"/zh/enterprise-server@3.20/apps/using-github-apps","title":"使用 GitHub Apps"},{"href":"/zh/enterprise-server@3.20/apps/using-github-apps/installing-a-github-app-from-a-third-party","title":"从第三方途径安装"}],"documentType":"article"},"body":"# 从第三方途径安装 GitHub Apps\n\n可以直接从应用所有者安装 GitHub Apps ，以在帐户上使用。\n\n## 关于安装 GitHub Apps\n\n> \\[!NOTE] 此安装流适用于任何 GitHub App应用，无论是第三方应用还是企业拥有的应用。 可以使用应用程序所有者提供的链接手动安装应用程序。\n\n若要在您的资源上使用某个GitHub App，您必须先在您的企业、组织或个人账户上安装该应用。 你可以在多个账户上安装同一个 GitHub App。 例如，如果在个人帐户和拥有的几个组织上安装应用，则可以在个人存储库、安装应用的组织以及这些组织所拥有的存储库中使用该应用。\n\n安装应用时，授予应用访问 它请求的企业或 组织和存储库资源的权限。 在安装过程中，GitHub 会告诉你 GitHub App 请求了哪些权限。 有关可以使用这些权限发出的 REST API 请求 GitHub App 的详细信息，请参阅 [GitHub应用所需的权限](/zh/enterprise-server@3.20/rest/authentication/permissions-required-for-github-apps)。\n\n安装请求存储库权限的应用时，还将选择要向其授予访问权限的 GitHub App 存储库。\n\n在安装 GitHub App 之前，应先确认你信任 GitHub App 的所有者。 你还应查看 GitHub App 正在请求的权限，并确保你愿意授予这些权限。 有关可以使用这些权限发出的 REST API 请求 GitHub App 的详细信息，请参阅 [GitHub应用所需的权限](/zh/enterprise-server@3.20/rest/authentication/permissions-required-for-github-apps)。\n\n可以安装的应用数量是没有限制的。\n\n### 安装与授权之间的区别\n\n安装 a GitHub App后，还可能会要求你授权应用。\n\n当您在自己的帐户或组织中**安装**GitHub App时，即表示您授予该应用访问其所请求的组织和仓库资源的权限。 还需要指定应用可以访问的存储库。 在安装过程中， GitHub App 将指示要授予的存储库和组织权限。 关于不同权限允许GitHub App执行的操作，请参阅[为GitHub应用选择权限](/zh/enterprise-server@3.20/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app)。\n\n例如，可以授予 GitHub App 读取存储库元数据和写入问题的权限，并可能授予 GitHub App 对所有存储库的访问权限。\n\n![用于安装 GitHub 应用的页面的屏幕截图。 该应用请求对元数据的读取权限以及对问题的写入权限。](/assets/images/github-apps/install-app.png)\n\n当您**授权**GitHub App时，您将根据该应用请求的账户权限，授予该应用访问您的GitHub账户的权限。 在授权过程中，应用将指示应用可以在你的帐户上访问的资源。 当你授权 GitHub App 时，你也授予该应用代表你执行操作的权限。\n\n例如，你可以授予 GitHub App 读取你的电子邮件地址和创建 Gist 的权限。\n\n![授权 GitHub 应用的页面的屏幕截图。 应用正在请求对电子邮件的读取访问权限和对 Gist 的写入访问权限。](/assets/images/github-apps/authorize-app.png)\n\n您无需先授权该应用，即可安装 GitHub App。 同样，无需安装应用即可授权应用。\n\n有关授权 GitHub Apps的详细信息，请参阅 [授权GitHub应用](/zh/enterprise-server@3.20/apps/using-github-apps/authorizing-github-apps)。\n\n## GitHub App 安装要求\n\nGitHub Apps任何人都可以在其个人帐户。\n\n组织所有者可以在其组织上安装 GitHub Apps。\n\n如果应用程序请求企业权限，企业所有者可以在 GitHub Apps 其企业帐户上安装。 该应用可以归企业、企业内部的组织或第三方开发人员所有。 第三方应用必须是公共应用，不能请求“企业组织安装”或“企业组织安装存储库”权限。\n\n如果应用未请求任何组织权限或“存储库管理”权限，则存储库管理员可以安装在 GitHub Apps 拥有存储库的组织中。 这样做时，他们只能安装可访问其具有管理员权限的存储库的应用。组织所有者可以限制GitHub App由存储库管理员进行的安装。 启用此限制后，存储库管理员无法安装 GitHub Apps ，必须改为请求组织所有者安装所需的应用。 有关详细信息，请参阅 [限制 OAuth 应用和GitHub应用访问请求和安装](/zh/enterprise-server@3.20/organizations/managing-programmatic-access-to-your-organization/limiting-oauth-app-and-github-app-access-requests-and-installations)。\n\n无法在组织上安装应用的组织成员和外部协作者仍然可以在安装过程中选择组织。 不会安装应用， GitHub 而是向组织所有者发送通知，以请求组织所有者安装应用。 可以使用应用访问请求策略来控制发出这些请求的能力。 请参阅“[限制 OAuth 应用和GitHub应用访问请求和安装](/zh/enterprise-server@3.20/organizations/managing-programmatic-access-to-your-organization/limiting-oauth-app-and-github-app-access-requests-and-installations)”。\n\n“应用管理员”角色不允许某人安装GitHub App在组织或企业上。 请参阅“[关于GitHub应用管理器](/zh/enterprise-server@3.20/apps/maintaining-github-apps/about-github-app-managers)”。\n\n## 安装 GitHub App\n\n在安装过程中，应用所有者会指引你到 GitHub URL 去安装 GitHub App。 URL 将显示为`http(s)://HOSTNAME/github-apps/APP-NAME/installations/new`，其中`APP-NAME`是GitHub App的名称。\n\n1. 选择要安装 GitHub App的位置。 可以选择你的个人帐户或你所属的组织。 如果你是企业所有者，还可以选择在企业上安装应用（如果应用支持企业）。\n\n2. 如果应用需要存储库权限，请选择“所有存储库”或“仅选定存储库”。\\*\\*\\*\\*\\*\\*\\*\\* 应用始终对所有 GitHub公共存储库具有至少只读访问权限。\n\n   如果应用不需要存储库权限，将省略这些选项。\n\n3. 如果在上一步中选择了“仅选定存储库”，则在“所选存储库”下拉列表下，选择希望应用访问的存储库。\\*\\*\\*\\*\\*\\*\\*\\*\n\n   如果应用创建了任何存储库，则应用也将自动获得访问这些存储库的权限。\n\n4. 查看应用正在请求的权限。 有关可以使用这些权限发出的 REST API 请求 GitHub App 的详细信息，请参阅 [GitHub应用所需的权限](/zh/enterprise-server@3.20/rest/authentication/permissions-required-for-github-apps)。\n\n5. 单击“安装”、“安装和请求”或“请求”。\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\* 显示的按钮取决于组织所有者是否必须批准应用请求的部分或全部访问权限或不批准。 无法请求企业安装 - 企业所有者必须直接安装应用。 有关详细信息，请参阅 [GitHub App](#requirements-to-install-a-github-app)安装要求。"}