{"meta":{"title":"修改GitHub应用注册","intro":"注册 GitHub App 后，可以对其进行更改。","product":"应用","breadcrumbs":[{"href":"/zh/enterprise-cloud@latest/apps","title":"应用"},{"href":"/zh/enterprise-cloud@latest/apps/maintaining-github-apps","title":"维护 GitHub Apps"},{"href":"/zh/enterprise-cloud@latest/apps/maintaining-github-apps/modifying-a-github-app-registration","title":"修改应用设置"}],"documentType":"article"},"body":"# 修改GitHub应用注册\n\n注册 GitHub App 后，可以对其进行更改。\n\n## 关于GitHub App的修改\n\n可以修改 GitHub App 注册以更改最初注册应用时选择的任何设置。 有关注册 GitHub App时可以选择的设置的详细信息，请参阅 [注册GitHub应用](/zh/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)。\n\n例如，可以更改应用的名称和说明、授予应用的权限、应用订阅的 Webhook 或应用的可见性。\n\n你还可以选择为你的 GitHub App 测试新的可选功能。 请参阅“[激活GitHub应用的可选功能](/zh/enterprise-cloud@latest/apps/maintaining-github-apps/activating-optional-features-for-github-apps)”。\n\n<!-- Anchor to maintain links to this heading -->\n\n<a name=\"navigating-to-your-github-app-settings\"></a>\n\n## 导航到设置GitHub App\n\n若要修改GitHub App，请先前往应用设置页面。\n\n1. 在 GitHub 上任意页的右上角，单击你的个人资料图片。\n\n2. 导航到你的帐户设置。\n   * 对于由个人帐户拥有的应用，请单击“设置”\\*\\*\\*\\*。\n   * 对于组织拥有的应用：\n     1. 单击“你的组织”。\n     2. 在组织的右侧，单击**设置**。\n   * 对于由企业拥有的应用：\n     1. 如果使用的是 Enterprise Managed Users，请单击**你的企业**，以直接转到企业帐户设置。\n     2. 如果使用的是个人帐户，请单击**你的企业**，然后单击企业右侧的**设置**。\n\n3. 导航到 GitHub App 设置。\n   * 对于由个人帐户或组织拥有的应用：\n     1. 在左侧边栏中，单击“<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-code\" aria-label=\"code\" role=\"img\"><path d=\"m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z\"></path></svg> Developer settings”，然后单击“GitHub Apps”\\*\\*\\*\\*\\*\\*\\*\\*。\n   * 对于由企业拥有的应用：\n     1. 在左侧边栏中，在“设置”下，单击 **GitHub Apps**。\n\n4. 在要修改的 GitHub App 右边，单击“编辑”。\n\n## 更改GitHub App的基本信息\n\n可以更改你的 GitHub App基本信息，例如应用的名称、应用的说明和应用的主页 URL。\n\n1. 导航到要修改的应用的设置页面。 有关详细信息，请参阅本文中的“[导航到 GitHub App 设置](#navigating-to-your-github-app-settings)”。\n2. 在“基本信息”下，修改您想更改的 GitHub App 信息。\n3. 单击“保存更改”。\n\n## 在安装过程中请求用户授权 (OAuth)\n\n你可以在用户安装你的 GitHub App 时提示其进行授权，并生成用户访问令牌。 在安装过程中请求用户授权 (OAuth) 时，还必须提供回叫 URL，用户在授权安装后将重定向到该 URL。 请参阅“[为 GitHub 应用生成用户访问令牌](/zh/enterprise-cloud@latest/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)”。\n\n1. 导航到要修改的应用的设置页面。 有关详细信息，请参阅本文中的“[导航到 GitHub App 设置](#navigating-to-your-github-app-settings)”。\n2. 在“识别和授权用户”下，选择或取消选择“在安装过程中请求用户授权 (OAuth)”。\n3. 在“回叫 URL”下，输入用户授权安装后要重定向到的完整 URL。\n\n## 启用或禁用设备流\n\n可以使用设备流程授权用户使用无头应用，例如 CLI 工具或 Git 凭据管理器。 有关如何将设备流与 GitHub Apps 结合使用的详细信息，请参阅 [为 GitHub 应用生成用户访问令牌](/zh/enterprise-cloud@latest/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app#using-the-device-flow-to-generate-a-user-access-token)。\n\n1. 导航到要修改的应用的设置页面。 有关详细信息，请参阅本文中的“[导航到 GitHub App 设置](#navigating-to-your-github-app-settings)”。\n2. 在“识别和授权用户”下，选择或取消选择“启用设备流”。\n\n## 添加或更新安装 URL\n\n安装应用后，可以将用户重定向到特定 URL。 请参阅“[注册GitHub应用](/zh/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)”。\n\n如果选择“在安装过程中请求用户授权 (OAuth)”，你将无法输入安装 URL。 用户将转而在授权流期间重定向到回叫 URL，你可在其中描述其他设置。 请参阅“[关于用户授权回调 URL](/zh/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/about-the-user-authorization-callback-url)”。\n\n1. 导航到要修改的应用的设置页面。 有关详细信息，请参阅本文中的“[导航到 GitHub App 设置](#navigating-to-your-github-app-settings)”。\n2. 在“安装后”下的“安装 URL”字段中，输入用户安装应用后要重定向到的 URL。\n3. （可选）如果要在用户更新安装后将其重定向到设置 URL，请选择“更新时重定向”。 更新包括添加或删除安装的存储库。 如果“设置 URL”为空，这将被忽略。\n\n## 更改GitHub App的权限\n\n您可以按照以下步骤更改授予 GitHub App 的访问权限。\n\n为应用添加新 **的存储库**、 **组织**或 **企业** 权限时，安装应用的每个帐户都需要批准新权限。 为应用添加帐户权限时，每个已授权该应用的用户都需要批准权限更改。\\*\\*\\*\\* 在这两种情况下， GitHub 都会向每个组织所有者或用户发送电子邮件，通知他们更新应用权限的请求。 在批准新权限之前，更新的权限不会对安装或用户授权生效。 可以使用[安装 Webhook](/zh/enterprise-cloud@latest/webhooks/webhook-events-and-payloads?actionType=new_permissions_accepted#installation) 来了解用户何时接受应用的新权限。\n\n如果您从您的 GitHub App 中移除权限或 Webhook，这些更改将立即生效。 如果删除以前授予应用的权限，应用将不再能够访问这些资源。\n\n如果更改企业拥有的应用的权限，则如果你是企业所有者，这些更改将立即对企业 内应用的所有安装生效。 如果你是应用管理员，则这些更改只会在你是组织所有者的组织中被自动接受。\n\n如果首次向应用添加仓库权限，则无法自动接受更新。 在这种情况下，每个组织所有者都需要批准更新，以便他们可以选择应用有权访问的存储库。\n\n更改应用的权限还可能会更改应用可以订阅的 Webhook 以及应用可以使用 API 执行的操作。 请参阅“[为GitHub应用选择权限](/zh/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app)”。\n\n1. 导航到要修改的应用的设置页面。 有关详细信息，请参阅本文中的“[导航到 GitHub App 设置](#navigating-to-your-github-app-settings)”。\n2. 在 GitHub Apps 设置边栏中，单击 **“权限和事件**”。\n3. 在“存储库权限”、“组织权限”和“帐户权限”部分下，修改要更改的权限。 对于每种类型的权限，从下拉列表中选择“只读”、“读取和写入”或“无访问权限”。 请参阅“[为GitHub应用选择权限](/zh/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app)”。\n4. 您也可以在“向用户添加备注”下添加一则备注，向用户说明您为什么要更改您的 GitHub App 所请求的权限。\n5. 单击“保存更改”。\n\n## 激活或停用 GitHub App Webhook\n\n你可以配置你的 GitHub App，使其接收来自 GitHub 上特定事件的 Webhook，并自动对这些事件执行操作。 请参阅“[将 Webhook 与 GitHub 应用配合使用](/zh/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps)”。\n\n1. 导航到要修改的应用的设置页面。 有关详细信息，请参阅本文中的“[导航到 GitHub App 设置](#navigating-to-your-github-app-settings)”。\n2. 在“Webhook”下，若要启用或禁用 Webhook，请选择或取消选择**Active**。\n3. 如果您在上一步中选择了 **Active**，请在“Webhook URL”下方输入 GitHub 应将 webhook 事件发送到的 URL。\n4. 可选：如果你在上一步选择了“**启用**”，在“Webhook 密钥”下输入一个密钥令牌以保护你的 webhook。\n   GitHub 强烈建议您设置 Webhook 密钥。\n\n## 更改GitHub App的 Webhook 事件订阅\n\n您可以使用以下步骤更改 GitHub App 订阅的 Webhook 事件。\n\n可以为 GitHub App 注册选择的具体 Webhook 事件根据为应用选择的权限类型而定。 首先需要选择希望应用拥有的权限，然后可以让应用订阅与该权限集相关的 Webhook 事件。 请参阅 [将 Webhook 与 GitHub 应用配合使用](/zh/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps)。\n\n1. 导航到要修改的应用的设置页面。 有关详细信息，请参阅本文中的“[导航到 GitHub App 设置](#navigating-to-your-github-app-settings)”。\n2. 启用GitHub AppWebhook。 请参阅本文中的[激活或停用GitHub App webhook](/zh/enterprise-cloud@latest/apps/maintaining-github-apps/modifying-a-github-app-registration#activating-or-deactivating-the-github-app-webhook)。\n3. 在 GitHub Apps 设置边栏中，单击 **“权限和事件**”。\n4. 在“存储库权限”、“组织权限”和“帐户权限”部分下，选择应用将订阅的事件所需的权限。 请参阅[更改某个GitHub App的权限](#changing-the-permissions-of-a-github-app)。\n5. 在“订阅事件”下，选择你希望 GitHub App 接收的 Webhook 事件。\n6. 单击“保存更改”。\n\n## 更改GitHub App的可见性\n\n您可以更改您的 GitHub App 的可见性设置，以控制哪些人可以安装它。 如果公共应用安装在其他帐户上，则不能将其设为专用应用。 请参阅“[将GitHub应用公开或专用](/zh/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/making-a-github-app-public-or-private)”。\n\n无法更改企业拥有的 GitHub App 的可见性。\nGitHub Apps由企业拥有的内容只能安装到企业内部的组织或企业本身。\n\n1. 导航到要修改的应用的设置页面。 有关详细信息，请参阅本文中的“[导航到 GitHub App 设置](#navigating-to-your-github-app-settings)”。\n2. 在左侧边栏中，单击“高级”。\n3. 在“危险区域”下，根据 GitHub App 当前的可见性，点击 **“设为公开”** 或 **“设为专用”**。"}