{"meta":{"title":"授权 OAuth 应用","intro":"可以将 GitHub 身份连接到使用 OAuth 的第三方应用程序。 在授权 OAuth app 时，应确保您信任应用程序，查阅开发者是谁，并查阅应用程序要访问的信息类型。","product":"应用","breadcrumbs":[{"href":"/zh/apps","title":"应用"},{"href":"/zh/apps/oauth-apps","title":"OAuth 应用"},{"href":"/zh/apps/oauth-apps/using-oauth-apps","title":"使用 OAuth 应用"},{"href":"/zh/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps","title":"授权 OAuth 应用"}],"documentType":"article"},"body":"# 授权 OAuth 应用\n\n可以将 GitHub 身份连接到使用 OAuth 的第三方应用程序。 在授权 OAuth app 时，应确保您信任应用程序，查阅开发者是谁，并查阅应用程序要访问的信息类型。\n\n当 OAuth app 想要通过你在 GitHub 上的帐户识别你时，你会看到一个页面，其中包含该应用的开发者联系信息以及所请求的特定数据列表。\n\n> \\[!TIP]\n> 必须先[验证电子邮件地址](/zh/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/verifying-your-email-address)，才能为 OAuth app 授权。\n\n## OAuth app 访问\n\nOAuth apps 可以具有对 GitHub 数据的 *读取* 或 *写入* 权限。\n\n* 读取权限仅允许应用查看数据。\n* 写入权限允许应用更改数据。\n\n> \\[!TIP]\n> 我们建议您定期审查您授权的集成。 删除在一段时间内未使用的任何应用程序和令牌。 有关详细信息，请参阅“[审查授权的 OAuth 应用](/zh/apps/oauth-apps/using-oauth-apps/reviewing-your-authorized-applications-oauth)”。\n\n### 关于 OAuth 权限范围\n\n```\n          _范围_是 OAuth app 可以申请访问公共及非公共数据的权限组。\n```\n\n当你想使用集成了 OAuth app 的 GitHub 时，该应用程序可让你了解需要的数据访问权限类型。 如果您授予应用程序访问权限，则应用程序将能代您执行操作，例如读取或修改数据。 例如，如果要使用请求 `user:email` 作用域的应用，该应用将具有对专用电子邮件地址的只读访问权限。 有关详细信息，请参阅“[OAuth 应用的范围](/zh/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps)”。\n\n> \\[!NOTE]\n> 目前，无法将源代码访问范围限定为只读。\n\n令牌具有与令牌所有者相同的访问资源和对这些资源执行操作的能力，并且还受到授予令牌的任何范围或权限的限制。 令牌无法向用户授予额外访问权限功能。例如，应用程序可以创建配置了 `admin:org` 作用域的访问令牌，但如果应用程序的用户不是组织所有者，则不会向应用程序授予对组织的管理访问权限。\n\n每个用户/应用程序/作用域组合签发的令牌数量有限，速率限制是每小时创建十个令牌。 如果应用程序为同一用户和相同作用域创建超过十个令牌，则将撤销具有相同用户/应用程序/作用域组合的最旧令牌。 但是，达到每小时速率限制不会撤销最早的令牌。 相反，它会在浏览器中触发重新授权提示，要求用户仔细检查他们向你的应用授予的权限。 此提示旨在中断应用陷入的任何潜在的无限循环，因为应用几乎没有理由在一小时内向用户请求十个令牌。\n\n### 申请的数据类型\n\nOAuth apps 可以申请多种类型的数据。\n\n| 数据类型  | 说明                                                                               |\n| ----- | -------------------------------------------------------------------------------- |\n| 提交状态  | 您可以授权应用程序报告您的提交状态。 提交状态访问权限允许应用程序确定对特定提交的构建是否成功。 应用程序无法访问您的代码，但可以读取和写入特定提交的状态信息。 |\n| 部署    | 部署状态访问权限允许应用程序根据公共和私有仓库的特定提交确定部署是否成功。 应用程序无法访问您的代码。                              |\n| Gists |                                                                                  |\n\n```\n          [Gist](https://gist.github.com) 访问权限允许应用读取或写入您的公共和私人 Gist。 |\n```\n\n\\| 钩子 |\n[Webhook](/zh/webhooks-and-events/webhooks/about-webhooks) 访问权限允许应用在你管理的存储库上读取或写入挂钩配置。 |\n\\| 通知 | 通知访问权限允许应用程序读取你的 GitHub 通知，例如问题和拉取请求中的评论。 但应用程序仍然无法访问仓库中的任何内容。 |\n\\| 组织和团队 | 组织和团队访问权限允许应用程序访问并管理组织和团队成员资格。 |\n\\| 个人用户数据 | 用户数据包括您的用户个人资料中的信息，例如您的姓名、电子邮件地址和地点。 |\n\\| 存储库 | 仓库信息包括贡献者的姓名、您创建的分支以及仓库中的实际文件。 应用程序可以申请访问用户级别的公共或私有仓库。 |\n\\| 仓库删除 | 应用程序可以申请删除您管理的仓库，但无法访问您的代码。 |\n\\|  |\n\\| 项目 | 访问用户和组织 projects。 应用可以请求读/写或只读访问权限。 |\n\\|  |\n\n## 申请更新的权限\n\n当 OAuth apps 申请新的访问权限时，它们会通知您其当前权限与新权限之间的差异。\n\n## OAuth apps 和组织\n\n当你授权 OAuth app 访问你的个人帐户时，你还会看到该授权对你所在的每个组织的影响。\n\n* 对于\\_具有\\_ OAuth app 访问限制的组织，你可以请求组织所有者批准该应用程序在组织中的使用。\\*\\*\\*\\* 如果组织未批准应用程序，则应用程序只能访问组织的公共资源。 如果你是组织所有者，则可以自行[批准应用程序](/zh/organizations/managing-oauth-access-to-your-organizations-data/approving-oauth-apps-for-your-organization)。\n\n* 对于没有 OAuth app 访问限制的组织，将自动授予应用程序对该组织资源的访问权限。 因此，应注意批准哪些 OAuth apps 访问你的个人帐户资源以及任何组织资源。\n\n如果你属于启用了 SAML 单一登录 (SSO) 的任何组织，并且你过去已通过 SAML 进行身份验证为该组织创建了链接标识，则每次授权 OAuth app 时，都必须为每个组织创建一个活动的 SAML 会话。\n\n> \\[!NOTE]\n> 注意：如果在访问受 SAML 保护的组织时遇到授权 OAuth app 或 GitHub App 的问题，则可能需要从授权的 GitHub Apps 或授权的 OAuth apps 页面撤销应用，访问组织进行身份验证并建立活动的 SAML 会话，然后尝试通过访问应用重新授权该应用。[](https://github.com/settings/applications)[](https://github.com/settings/apps/authorizations)\n\n## 其他阅读材料\n\n* [关于 OAuth 应用访问限制](/zh/organizations/managing-oauth-access-to-your-organizations-data/about-oauth-app-access-restrictions)\n* [授权GitHub应用](/zh/apps/using-github-apps/authorizing-github-apps)\n* [GitHub市场支持](/zh/support/learning-about-github-support/github-marketplace-support)"}