Skip to main content

About GitHub Connect

GitHub Connect enhances GitHub Enterprise Server by giving you access to data and workflows from GitHub Enterprise Cloud.

GitHub Connect allows your GitHub Enterprise Server instance to connect to your enterprise on GitHub Enterprise Cloud in limited ways.

After you enable GitHub Connect, you can choose which features to enable. For example, you can:

  • Automatically sync license usage between environments
  • Unify search results and user contribution data
  • Enable features that rely on GitHub.com, such as Dependabot alerts for security vulnerabilities that are tracked in the GitHub Advisory Database

About the connection

To enable GitHub Connect, you configure a connection between your GitHub Enterprise Server instance and an enterprise account on GitHub.com or GHE.com. The connection uses HTTPS over ports 443 or 80 and is secured by TLS.

  • GitHub Connect does not open your GitHub Enterprise Server instance to the public internet.
  • None of your enterprise's private data is exposed to GitHub Enterprise Cloud users.
  • GitHub Connect transmits only the limited data needed for the features you enable. Unless you enable license sync, no personal data is transmitted. For more information, see "Data transmission."
  • Enabling GitHub Connect will not allow GitHub Enterprise Cloud users to make changes to GitHub Enterprise Server.

GitHub Connect features

After you configure the connection between your GitHub Enterprise Server instance and GitHub Enterprise Cloud, you can enable individual features of GitHub Connect.

If you're connecting to an enterprise on GHE.com, features that rely on data from GitHub.com are not available.

Connections to GitHub.com

FeatureDescriptionMore information
Automatic user license syncManage license usage across your GitHub Enterprise deployments by automatically syncing user licenses from your GitHub Enterprise Server instance to GitHub Enterprise Cloud."Enabling automatic user license sync for your enterprise"
DependabotAllow users to find and fix vulnerabilities in code dependencies."Enabling Dependabot for your enterprise"
GitHub.com actionsAllow users to use actions from GitHub.com in public workflow files."Enabling automatic access to GitHub.com actions using GitHub Connect"
Server StatisticsAnalyze your own aggregate data from GitHub Enterprise Server, and help us improve GitHub products."Enabling Server Statistics for your enterprise"
Unified searchAllow users to include repositories on GitHub Enterprise Cloud in their search results when searching from your GitHub Enterprise Server instance."Enabling unified search for your enterprise"
Unified contributionsAllow users to include anonymized contribution counts for their work on your GitHub Enterprise Server instance in their contribution graphs on GitHub Enterprise Cloud."Enabling unified contributions for your enterprise"

Connections to GHE.com

FeatureDescriptionMore information
Unified searchAllow users to include repositories on GitHub Enterprise Cloud in their search results when searching from your GitHub Enterprise Server instance."Enabling unified search for your enterprise"
Unified contributionsAllow users to include anonymized contribution counts for their work on your GitHub Enterprise Server instance in their contribution graphs on GitHub Enterprise Cloud."Enabling unified contributions for your enterprise"

Data transmission

When GitHub Connect is enabled, a record on GitHub Enterprise Cloud stores information about the connection. If you enable individual features of GitHub Connect, additional data is transmitted.

Note: No repositories, issues, or pull requests are ever transmitted from GitHub Enterprise Server to GitHub Enterprise Cloud by GitHub Connect.

Data transmitted when GitHub Connect is enabled

When you enable GitHub Connect or specific GitHub Connect features, a record on GitHub Enterprise Cloud stores the following information about the connection.

  • The public key portion of your GitHub Enterprise Server license
  • A hash of your GitHub Enterprise Server license
  • The customer name on your GitHub Enterprise Server license
  • The version of your GitHub Enterprise Server instance
  • The hostname of your GitHub Enterprise Server instance
  • The enterprise account on GitHub Enterprise Cloud that's connected to your GitHub Enterprise Server instance
  • The authentication token that's used by your GitHub Enterprise Server instance to make requests to GitHub Enterprise Cloud
  • If Transport Layer Security (TLS) is enabled and configured on your GitHub Enterprise Server instance
  • The GitHub Connect features that are enabled on your GitHub Enterprise Server instance, and the date and time of enablement
  • The dormancy threshold for your enterprise
  • The number of dormant users for your enterprise
  • A count of license-consuming seats, which does not include suspended users

GitHub Connect syncs the above connection data between your GitHub Enterprise Server instance and GitHub Enterprise Cloud weekly, starting from the day and approximate time that GitHub Connect was enabled.

Data transmitted by individual features of GitHub Connect

Additional data is transmitted if you enable individual features of GitHub Connect.

FeatureDataWhich way does the data flow?Where is the data used?
Automatic user license syncEach GitHub Enterprise Server user's user ID and email addresses, and whether the user consumes a license for GitHub Advanced SecurityFrom GitHub Enterprise Server to GitHub Enterprise CloudGitHub Enterprise Cloud
Dependabot alertsVulnerability alertsFrom GitHub.com to GitHub Enterprise ServerGitHub Enterprise Server
Dependabot updatesDependencies and the metadata for each dependency's repository

If a dependency is stored in a private repository on GitHub.com, data will only be transmitted if Dependabot is configured and authorized to access that repository.
From GitHub.com to GitHub Enterprise ServerGitHub Enterprise Server
GitHub.com actionsName of action, action (YAML file from GitHub Marketplace)From GitHub.com to GitHub Enterprise Server

From GitHub Enterprise Server to GitHub.com
GitHub Enterprise Server
Server StatisticsAggregate metrics about your usage of GitHub Enterprise Server. For the complete list of metrics, see "About Server Statistics."From GitHub Enterprise Server to GitHub Enterprise CloudGitHub Enterprise Cloud
Unified searchSearch terms, search resultsFrom GitHub Enterprise Cloud to GitHub Enterprise Server

From GitHub Enterprise Server to GitHub Enterprise Cloud
GitHub Enterprise Server
Unified contributionsContribution countsFrom GitHub Enterprise Server to GitHub Enterprise CloudGitHub Enterprise Cloud

Enabling GitHub Connect

To enable GitHub Connect, see the article for your GitHub Enterprise Cloud environment.