Article version: Enterprise Server 2.17
Connecting GitHub Enterprise Server to GitHub Enterprise Cloud
After you enable GitHub Connect, you can share specific features and workflows between your GitHub Enterprise Server instance and GitHub Enterprise Cloud.
About GitHub Connect
To enable GitHub Connect, you must configure the connection in both your GitHub Enterprise Server instance and in your GitHub Enterprise Cloud organization or enterprise account.
To configure a connection, your proxy configuration must allow connectivity to github.com
and api.github.com
. For more information, see "Configuring an outbound web proxy server."
After enabling GitHub Connect, you will be able to enable features such as unified search and unified contributions. For more information about all of the features available, see "Managing connections between GitHub Enterprise Server and GitHub Enterprise Cloud."
When you connect your GitHub Enterprise Server instance to GitHub Enterprise Cloud, a record on GitHub.com stores 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 hostname of your GitHub Enterprise Server instance
- The version of your GitHub Enterprise Server instance
- The organization or enterprise account on GitHub.com 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.com
Enabling GitHub Connect also creates a GitHub App owned by your GitHub Enterprise Cloud organization or enterprise account. GitHub Enterprise Server uses the GitHub App's credentials to make requests to GitHub.com.
GitHub Enterprise Server 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 Server Backup Utilities.
- An authentication token, which is valid for one hour
- A private key, which is used to generate a new authentication token
Enabling GitHub Connect will not allow GitHub.com users to make changes to GitHub Enterprise Server.
Enabling GitHub Connect
- Sign in to your GitHub Enterprise Server instance and GitHub.com.
- In the upper-right corner of any page, click .
- In the left sidebar, click Enterprise.
- In the enterprise account sidebar, click Settings.
- In the left sidebar, click GitHub Connect.
- Under "GitHub.com is not enabled yet", click Enable GitHub Connect. By clicking Enable GitHub Connect, you agree to the GitHub Connect Addendum to the GitHub Enterprise License Agreement.
- Next to the enterprise account or organization you'd like to connect, click Connect.
Disconnecting a GitHub Enterprise Cloud organization or enterprise account from your GitHub Enterprise Server instance
When you disconnect from GitHub Enterprise Cloud, the GitHub Connect GitHub App is deleted from your enterprise account or organization and credentials stored on your GitHub Enterprise Server instance are deleted.
- In the upper-right corner of any page, click .
- In the left sidebar, click Enterprise.
- In the enterprise account sidebar, click Settings.
- In the left sidebar, click GitHub Connect.
- Next to the enterprise account or organization you'd like to disconnect, click Disable GitHub Connect.
- Read the information about disconnecting and click Disable GitHub Connect.