Skip to main content

注册 GitHub 应用

你可以在你的个人帐户或你所属的任何组织下注册 GitHub App。

关于注册 GitHub Apps

你可以在你的个人帐户、你拥有的组织或授予你管理其所有应用的权限的组织下注册 GitHub App。 有关详细信息,请参阅“在组织中添加和删除 GitHub App 管理员”。

用户或组织最多可以注册 100 个 GitHub Apps,但帐户中可以安装的 GitHub Apps 数没有限制。

注册 GitHub App

  1. 在 GitHub 上任意页的右上角,单击你的个人资料照片。

  2. 导航到你的帐户设置。

    • 对于由个人帐户拥有的应用,请单击“设置”****。
    • 对于组织拥有的应用:
      1. 单击“你的组织”。
      2. 在组织右侧,单击“设置”。
  3. 在左侧边栏中,单击“ 开发人员设置”。

  4. 在左侧边栏中,单击“GitHub Apps”。

  5. 单击“新建 GitHub 应用”。

  6. 在“GitHub 应用名称”下,为应用输入名称。 你应选择一个易懂而简短的名称。 应用执行操作时,应用的名称(转换为小写,且空格替换为 -,并替换特殊字符)将在用户界面中显示。 例如,My APp Näme 将显示为 my-app-name

    该名称在 GitHub 中必须是唯一的。 所用名称不能与现有 GitHub 帐户同名,除非它是你自己的用户或组织的名称。

  7. (可选)在“描述”下,键入应用的描述。 用户和组织在安装你的应用时会看到此描述。

  8. 在“主页 URL”下,键入应用网站的完整 URL。 如果没有专用 URL,且应用代码存储在公共存储库中,则可以使用该存储库 URL。 或者,可以使用拥有该应用的组织或用户的 URL。

  9. (可选)在“回叫 URL”下,输入用户授权安装后要重定向到的完整 URL。

    可最多输入 10 个回叫 URL。 若要添加其他回叫 URL,请单击“添加回叫 URL”。

    如果应用不需要代表用户执行操作(不需要生成用户访问令牌),则将忽略该字段。 如果应用使用设备流而不是 Web 应用流来生成用户访问令牌,则将忽略此字段。

    有关回叫 URL 的详细信息,请参阅“关于用户授权回调 URL”。 有关生成用户访问令牌以代表用户执行操作的详细信息,请参阅“代表用户使用 GitHub 应用进行身份验证”和“为 GitHub 应用生成用户访问令牌”。

  10. (可选)若要防止用户访问令牌过期,请取消选择“使用户授权令牌过期”。 GitHub 强烈建议选择此选项。 有关刷新过期令牌和过期用户访问令牌的优势的详细信息,请参阅“刷新用户访问令牌”。 如果应用不需要生成用户访问令牌,则将忽略此字段。

  11. (可选)若要在用户安装应用时提示用户为其授权,请选择“安装时请求用户授权 (OAuth)”。 如果用户为应用授权,应用可以生成用户访问令牌,以代表用户发出 API 请求并将应用活动分配给用户。 有关详细信息,请参阅“代表用户使用 GitHub 应用进行身份验证”和“为 GitHub 应用生成用户访问令牌”。

  12. (可选)如果要使用设备流生成用户访问令牌,请选择“启用设备流”。 有关详细信息,请参阅“为 GitHub 应用生成用户访问令牌”。

  13. (可选)在“设置 URL”下,输入用户安装应用后重定向到的 URL。 如果安装后需要其他设置,可以使用此 URL 告知用户安装后要执行的步骤。 有关详细信息,请参阅“关于设置 URL”。

    如果在先前的步骤中选择了“安装时请求用户授权 (OAuth)”,你将无法在此处输入 URL。 用户将转而在授权流期间重定向到回叫 URL,你可在其中描述其他设置。

  14. (可选)如果要在用户更新安装后将其重定向到设置 URL,请选择“更新时重定向”。 更新包括添加或删除安装的存储库。 如果“设置 URL”为空,这将被忽略。

  15. (可选)如果不希望应用接收 webhook 事件,请取消选择“活动”。 例如,如果应用仅用于身份验证或不需要响应 webhook,请取消选择此选项。 有关详细信息,请参阅“将 Webhook 与 GitHub 应用配合使用”。

  16. 如果在上一步中选择了“活动”,则在“Webhook URL”下,输入 GitHub 应将 webhook 事件发送到的 URL。 有关详细信息,请参阅“将 Webhook 与 GitHub 应用配合使用”。

  17. (可选)如果在上一步中选择了“活动”,则在“Webhook 机密”下,输入用于保护 webhook 的机密令牌。 GitHub 强烈建议设置 webhook 机密。 有关详细信息,请参阅“将 Webhook 与 GitHub 应用配合使用”。

  18. 如果输入了 webhook URL,请在“SSL 验证”下选择是否启用 SSL 验证。 GitHub 强烈建议启用 SSL 验证。

  19. 在“权限”下,选择应用所需的权限。 对于每种权限,请选择下拉菜单,然后单击“只读”、“读写”或“无访问权限” 。 你应选择应用所需的最小权限。 有关详细信息,请参阅“为 GitHub Apps 选择权限”。

  20. 如果在先前的步骤中选择了“活动”,表示应用应接收 webhook 事件,则请在“订阅事件”下选择希望应用接收的 webhook 事件。 在上一步中选择的权限决定哪些 Webhook 事件可用。 有关每个 webhook 事件的详细信息,请参阅“Webhook 事件和有效负载”。

  21. 在“此 GitHub 应用可以安装在哪些位置?”下,选择“仅在此帐户上”或“任何帐户” 。 有关安装选项的详细信息,请参阅“将 GitHub 应用程序设为公共或私有”。

  22. 单击“创建 GitHub 应用”。

后续步骤

注册 GitHub App 后,你需要编写代码,让 GitHub App 执行某些操作。 有关如何编写代码的示例,请参阅:

你的目标应该是遵循最佳做法。 有关详细信息,请参阅“创建 GitHub 应用的最佳做法”。

完全生成 GitHub App 后,可以安装 GitHub App 并与其他人共享你的 GitHub App。 有关详细信息,请参阅“安装自己的 GitHub 应用”和“共享 GitHub 应用”。

始终可以更改 GitHub App 的设置。 有关详细信息,请参阅“修改 GitHub 应用注册”。