Skip to main content

此版本的 GitHub Enterprise 已停止服务 2022-06-03. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

Authorizing OAuth Apps

You can connect your GitHub Enterprise Server identity to third-party applications using OAuth. When authorizing an OAuth 应用程序, you should ensure you trust the application, review who it's developed by, and review the kinds of information the application wants to access.

When an OAuth 应用程序 wants to identify you by your account on 您的 GitHub Enterprise Server 实例, you'll see a page with the app's developer contact information and a list of the specific data that's being requested.

OAuth 应用程序 access

OAuth 应用程序 can have read or write access to your GitHub Enterprise Server data.

  • Read access only allows an app to look at your data.
  • Write access allows an app to change your data.

Tip: 我们建议您定期审查您授权的集成。 � 除在一段时间内未使用的任何应用程序和令牌。 更多信息请参阅“>审查授权的集成”。

About OAuth scopes

Scopes are named groups of permissions that an OAuth 应用程序 can request to access both public and non-public data.

When you want to use an OAuth 应用程序 that integrates with GitHub Enterprise Server, that app lets you know what type of access to your data will be required. If you grant access to the app, then the app will be able to perform actions on your behalf, such as reading or modifying data. For example, if you want to use an app that requests user:email scope, the app will have read-only access to your private email addresses. For more information, see "About scopes for OAuth 应用程序."

Note: Currently, you can't scope source code access to read-only.

每个用户/应用程序/作用域组合签发的令牌数量有限。 如果应用程序为同一用户和相同作用域创建超过 10 个令牌,则将吊销具有相同用户/应用程序/作用域组合的最旧令牌。

Types of requested data

OAuth 应用程序 can request several types of data.

Type of dataDescription
Commit statusYou can grant access for an app to report your commit status. Commit status access allows apps to determine if a build is a successful against a specific commit. Apps won't have access to your code, but they can read and write status information against a specific commit.
DeploymentsDeployment status access allows apps to determine if a deployment is successful against a specific commit for public and private repositories. Apps won't have access to your code.
GistsGist access allows apps to read or write to both your public and secret Gists.
HooksWebhooks access allows apps to read or write hook configurations on repositories you manage.
NotificationsNotification access allows apps to read your GitHub Enterprise Server notifications, such as comments on issues and pull requests. However, apps remain unable to access anything in your repositories.
Organizations and teamsOrganization and teams access allows apps to access and manage organization and team membership.
Personal user dataUser data includes information found in your user profile, like your name, e-mail address, and location.
RepositoriesRepository information includes the names of contributors, the branches you've created, and the actual files within your repository. Apps can request access for either public or private repositories on a user-wide level.
Repository deleteApps can request to delete repositories that you administer, but they won't have access to your code.

Requesting updated permissions

When OAuth 应用程序 request new access permissions, they will notify you of the differences between their current permissions and the new permissions.