Connecting your enterprise account 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.

Enterprise owners who are also owners of a GitHub Enterprise Cloud organization or enterprise account can enable GitHub Connect.

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 your enterprise accounts."

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 version of 您的 GitHub Enterprise Server 实例
  • The hostname 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 应用程序 owned by your GitHub Enterprise Cloud organization or enterprise account. GitHub Enterprise Server uses the GitHub 应用程序's credentials to make requests to GitHub.com.

GitHub Enterprise Server stores credentials from the GitHub 应用程序. These credentials will be replicated to any high availability or clustering environments, and stored in any backups, including snapshots created by GitHub Enterprise Server 备份实用程序.

  • 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.

For more information about managing enterprise accounts using the GraphQL API, see "Enterprise accounts."

Enabling GitHub Connect

  1. Sign in to your GitHub Enterprise Server instance and GitHub.com.

  2. 在 GitHub Enterprise Server 的右上角,单击您的个人资料照片,然后单击 Enterprise settings(Enterprise 设置)GitHub Enterprise Server 上个人资料照片下拉菜单中的"Enterprise settings(企业设置)"

  3. In the enterprise account sidebar, click GitHub Connect. GitHub Connect tab in the enterprise account sidebar

  4. Under "GitHub Connect is not enabled yet", click Enable GitHub Connect. By clicking Enable GitHub Connect, you agree to the "GitHub Terms for Additional Products and Features."

    Enable GitHub Connect button

  5. Next to the enterprise account or organization you'd like to connect, click Connect. Connect button next to an enterprise account or business

Disconnecting a GitHub Enterprise Cloud organization or enterprise account from your enterprise account

When you disconnect from GitHub Enterprise Cloud, the GitHub Connect GitHub 应用程序 is deleted from your enterprise account or organization and credentials stored on your GitHub Enterprise Server instance are deleted.

  1. 在 GitHub Enterprise Server 的右上角,单击您的个人资料照片,然后单击 Enterprise settings(Enterprise 设置)GitHub Enterprise Server 上个人资料照片下拉菜单中的"Enterprise settings(企业设置)"

  2. In the enterprise account sidebar, click GitHub Connect. GitHub Connect tab in the enterprise account sidebar

  3. Next to the enterprise account or organization you'd like to disconnect, click Disable GitHub Connect.

    Disable GitHub Connect button next to an enterprise account or organization name

  4. Read the information about disconnecting and click Disable GitHub Connect. Modal with warning information about disconnecting and confirmation button

此文档对您有帮助吗?

隐私政策

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或者, 了解如何参与。