可以在企业帐户下创建一个 GitHub App 。 该应用只能安装在 组织上,并且只能由企业成员授权。 无法将该应用安装在用户帐户上。
步骤 1:注册 GitHub App
若要创建GitHub App,必须先注册该应用。 请参阅“注册GitHub应用”。
应用也可以从成员或组织转移到企业。 要转移应用,请参阅 转让GitHub应用的所有权。
步骤 1a:添加企业应用管理者
企业所有者可以将企业成员作为应用管理者添加到应用。 应用管理者可以管理应用的设置和凭据,但不能安装应用。 有关详细信息,请参阅 关于GitHub应用管理器。
步骤 2:生成 GitHub App
注册 GitHub App 后,您需要编写代码让您的 GitHub App 执行某些操作。 有关如何编写代码的示例,请参阅:
- GitHub应用构建快速入门
- 构建响应 Webhook 事件的GitHub应用
- 使用 GitHub 应用生成“使用 GitHub 登录”按钮
- 使用 GitHub 应用生成 CLI
- 在GitHub Actions工作流中使用GitHub应用发出经过身份验证的 API 请求
你的目标应该是遵循最佳做法。 请参阅“创建GitHub应用的最佳做法”。
步骤 3:授权或安装您的 GitHub App
您的GitHub App注册后,您需要根据应用的用途,通过授权或安装使其可供使用。
企业所有者 和应用管理员 可以随时修改其企业拥有的应用的权限。 如果企业所有者进行了更改,则企业 中的组织将自动接受权限更改。 否则,仅当应用管理器也是组织所有者且组织所有者必须接受所有其他组织的更新请求时,才会接受这些更改。
步骤 3a:授权您的 GitHub App
某些 GitHub Apps扩展(如 Copilot 扩展)需要 授权 ,但不需要在组织上安装。 企业中的用户可以授权应用访问组织内的资源。 但是,该应用只能访问其安装位置中的 GitHub 资源。 请参阅“授权GitHub应用”。
步骤 3b:通过安装链接共享你的GitHub App
对于需要安装才能正常运行的应用,可以为组织所有者提供安装链接。 安装后,该应用将有权访问组织的资源。 请参阅“共享 GitHub 应用”。
第 4 步:安装 GitHub App(如果需要)
如果 GitHub App 需要安装(而不仅仅是授权),组织所有者可以使用安装链接在其组织上安装该应用。 请参阅“从第三方途径安装 GitHub Apps”。