You can enable shared features and workflows by connecting your GitHub Enterprise instance to a GitHub.com organization on GitHub Business Cloud.
In this guide
- About connections between GitHub Enterprise and GitHub.com
- Connecting GitHub Enterprise to GitHub.com
You must configure the connection in both your GitHub Enterprise instance and in your GitHub.com organization. To configure the connection, you must be a site administrator for your GitHub Enterprise instance and be an owner for the GitHub.com organization.
After you connect the environments, you will be able to search across your GitHub Enterprise instance and GitHub.com. For more information, see "Enabling unified search between GitHub Enterprise and GitHub.com."
When you connect your GitHub Enterprise instance to your GitHub.com organization, a record on GitHub.com stores information about the connection:
- The public key portion of your GitHub Enterprise license
- A hash of your GitHub Enterprise license
- The customer name on your GitHub Enterprise license
- The hostname of your GitHub Enterprise instance
- The version of your GitHub Enterprise instance
- The organization on GitHub.com that's connected to your GitHub Enterprise instance
- The authentication token that's used by your GitHub Enterprise instance to make requests to GitHub.com
Connecting your GitHub Enterprise instance to a GitHub.com organization also creates an GitHub App owned by your GitHub.com organization. GitHub Enterprise uses the GitHub App's credentials to make requests to GitHub.com.
GitHub Enterprise stores credentials from the GitHub App. These credentials will be replicated to any High Availability or Clustering environments, and stored in any backups, including snapshots created by GitHub Enterprise Backup Utilities.
- An authentication token, which is valid for one hour
- A private key, which is used to generate a new authentication token
Connecting your GitHub Enterprise instance to GitHub.com will not allow GitHub.com users to make changes to GitHub Enterprise.
- Sign in to your GitHub Enterprise instance and GitHub.com.
In the upper-right corner of any page, click .
In the left sidebar, click Admin center.
In the Admin center sidebar, click GitHub.com connection.
Under "GitHub.com connection", click Connect to GitHub.com.
- Read the addendum to the GitHub Enterprise License Agreement, then click I agree, connect to GitHub.com.
- After you're redirected to GitHub.com, next to the organization you'd like to connect to, click Connect.
- Review the permissions requested by the connection GitHub App, then click Install.