Skip to main content

Enterprise Server 3.15 目前作为候选发布提供。

关于使用 GitHub 应用

了解什么是 GitHub App,以及为何要使用 GitHub App。

关于 GitHub Apps

GitHub Apps 是扩展 GitHub 功能的工具。 GitHub Apps 可以对 GitHub 执行一些操作,例如打开问题、对拉取请求添加注释和管理项目。 它们还可以根据 GitHub 上发生的事件在 GitHub 之外执行操作。 例如,在 GitHub 上打开问题时,GitHub App 可以在 Slack 上发布。

查找 GitHub Apps

无法在企业版上安装第三方应用程序。 如果要使用第三方应用的功能,可以联系应用开发人员,了解如何从清单或 URL 参数创建应用。 有关详细信息,请参阅“从清单注册 GitHub 应用”和“使用 URL 参数注册 GitHub 应用”。

还可以构建自己的 GitHub App。 有关详细信息,请参阅“关于创建 GitHub 应用”。

使用 GitHub Apps

若要使用 GitHub App,必须在用户或组织帐户上安装该应用。 安装应用时,即授予应用读取或修改存储库和组织数据的权限。 具体权限取决于应用,GitHub 将告诉你在安装应用之前应用请求了哪些权限。 安装应用时,还将指定应用可以访问的存储库。 如果应用需要任何其他配置,应用将指示你执行此操作。 有关详细信息,请参阅“从第三方途径安装 GitHub Apps”和“安装自己的 GitHub 应用”。

可能还需要授权 GitHub App 以验证你的标识、了解你可以访问哪些资源或代表你执行操作。 如果需要授权应用,应用会提示你进行授权。 有关详细信息,请参阅“授权 GitHub Apps”。

有时,GitHub App 会请求更新的权限。 GitHub 会在发生这种情况时通知你。 为了使应用继续正常运行,你将需要查看并批准更新的权限。 有关详细信息,请参阅“批准 GitHub 应用的更新权限”。

在安装或授权 GitHub App 之前,应确保信任应用开发人员。 如果不再使用该应用,则应暂停或卸载应用和/或撤销对应用的授权。 有关详细信息,请参阅“查看和修改已安装的 GitHub 应用”和“查看和撤销 GitHub 应用的授权”。

GitHub Apps 和 OAuth apps

GitHub 还支持 OAuth apps。 与 GitHub Apps 不同,不安装 OAuth app 或控制它可以访问的存储库。

OAuth apps 和 GitHub Apps 使用 OAuth 2.0。

OAuth apps 只能代表用户执行操作,而 GitHub Apps 可以代表用户或独立于用户执行操作。

有关详细信息,请参阅“GitHub 应用和 OAuth 应用之间的差异”和“授权 OAuth 应用”。