{"meta":{"title":"修改GitHub应用注册","intro":"数据可复用.短描述.修改_github_apps %}","product":"应用","breadcrumbs":[{"href":"/zh/apps","title":"应用"},{"href":"/zh/apps/maintaining-github-apps","title":"维护 GitHub Apps"},{"href":"/zh/apps/maintaining-github-apps/modifying-a-github-app-registration","title":"修改应用设置"}],"documentType":"article"},"body":"# 修改GitHub应用注册\n\n数据可复用.短描述.修改_github_apps %}\n\n## 关于 GitHub App 修改\n\n可以修改 GitHub App 注册以最初更改注册应用时选择的任何设置。 有关在注册 GitHub App 时可以选择的设置的详细信息，请参阅“[注册GitHub应用](/zh/apps/creating-github-apps/creating-github-apps/creating-a-github-app)”。\n\n例如，可以更改应用的名称和说明、授予应用的权限、应用订阅的 Webhook 或应用的可见性。\n\n你还可以选择测试 GitHub App 的新可选功能。 请参阅“[激活GitHub应用的可选功能](/zh/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 上任意页的右上角，单击你的个人资料图片。\n2. 导航到你的帐户设置。\n   * 对于由个人帐户拥有的应用，请单击“设置”\\*\\*\\*\\*。\n   * 对于组织拥有的应用：\n     1. 单击“你的组织”。\n     2. 在组织的右侧，单击**设置**。 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”\\*\\*\\*\\*。\n3. 在左侧边栏中，单击“GitHub Apps”。1. 在要修改的 GitHub App 右边，单击“编辑”。\n\n## 更改 GitHub App 的基本信息\n\n可以更改 GitHub App 的基本信息，例如应用的名称、应用的说明和应用的主页 URL。\n\n导航到应用程序设置，在这篇文章中\n\n1. 在“基本信息”下，修改要更改的 GitHub App 信息。\n2. 单击“保存更改”。\n\n## 在安装过程中请求用户授权 (OAuth)\n\n在用户安装 GitHub App 时，可以提示用户对其进行授权，并生成用户访问令牌。 在安装过程中请求用户授权 (OAuth) 时，还必须提供回叫 URL，用户在授权安装后将重定向到该 URL。 请参阅“[为 GitHub 应用生成用户访问令牌](/zh/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/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/apps/creating-github-apps/creating-github-apps/creating-a-github-app)”。\n\n如果选择“在安装过程中请求用户授权 (OAuth)”，你将无法输入安装 URL。 用户将转而在授权流期间重定向到回叫 URL，你可在其中描述其他设置。 请参阅“[关于用户授权回调 URL](/zh/apps/creating-github-apps/creating-github-apps/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/webhooks-and-events/webhooks/webhook-events-and-payloads?actionType=new_permissions_accepted#installation) 来了解用户何时接受应用的新权限。\n\n如果您从 GitHub App 中移除权限或 webhook，更改将立即生效。 如果删除以前授予应用的权限，应用将不再能够访问这些资源。\n\n更改应用的权限还可能会更改应用可以订阅的 Webhook 以及应用可以使用 API 执行的操作。 请参阅“[为GitHub应用选择权限](/zh/apps/creating-github-apps/creating-github-apps/choosing-permissions-for-a-github-app)”。\n\n1. 导航到要修改的应用的设置页面。 有关详细信息，请参阅本文中的“[导航到 GitHub App 设置](#navigating-to-your-github-app-settings)”。\n2. 在 GitHub Apps 设置边栏中，单击“权限和事件”。\n3. 在“存储库权限”、“组织权限”和“帐户权限”部分下，修改要更改的权限。 对于每种类型的权限，从下拉列表中选择“只读”、“读取和写入”或“无访问权限”。 请参阅“[为GitHub应用选择权限](/zh/apps/creating-github-apps/creating-github-apps/choosing-permissions-for-a-github-app)”。\n4. （可选）在“向用户添加注释”下，添加注释，告诉用户为什么要更改 GitHub App 请求的权限。\n5. 单击“保存更改”。\n\n## 激活或停用 GitHub App Webhook\n\n可以将 GitHub App配置为接收 GitHub 上特定事件的 Webhook，并自动对其执行操作。 请参阅“[将 Webhook 与 GitHub 应用配合使用](/zh/apps/creating-github-apps/creating-github-apps/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。 GitHub 强烈建议设置 Webhook 密钥。\n\n## 更改 GitHub App 的 Webhook 事件订阅\n\n可以使用以下步骤更改 GitHub App 订阅的 Webhook 事件。\n\n可以为 GitHub App 注册选择的具体 Webhook 事件根据为应用选择的权限类型而定。 首先需要选择希望应用拥有的权限，然后可以让应用订阅与该权限集相关的 Webhook 事件。 请参阅 [将 Webhook 与 GitHub 应用配合使用](/zh/apps/creating-github-apps/creating-github-apps/using-webhooks-with-github-apps)。\n\n1. 导航到要修改的应用的设置页面。 有关详细信息，请参阅本文中的“[导航到 GitHub App 设置](#navigating-to-your-github-app-settings)”。\n2. 激活 GitHub App webhook。 请参阅本文中的[激活或停用 GitHub App Webhook](/zh/apps/maintaining-github-apps/modifying-a-github-app#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/apps/creating-github-apps/creating-github-apps/making-a-github-app-public-or-private)”。\n\n1. 导航到要修改的应用的设置页面。 有关详细信息，请参阅本文中的“[导航到 GitHub App 设置](#navigating-to-your-github-app-settings)”。1. 在左侧边栏中，单击“高级”。\n2. 在“危险区域”下，根据 GitHub App 的当前可见性，单击“设为公用”或“设为专用” 。"}