Skip to main content

Enabling GitHub Connect for GitHub.com

Enable GitHub Connect to access additional features and workflows from GitHub.com on sua instância do GitHub Enterprise Server.

You can access additional features and workflows on sua instância do GitHub Enterprise Server by enabling GitHub Connect. See "Sobre o GitHub Connect."

What happens when GitHub Connect is enabled?

When you enable GitHub Connect, you configure a connection between sua instância do GitHub Enterprise Server and an enterprise account on GitHub Enterprise Cloud. A conexão usa HTTPS nas portas 443 ou 80 e é protegida pelo TLS.

Enabling GitHub Connect creates a GitHub App owned by the enterprise account on GitHub Enterprise Cloud. GitHub Enterprise Server uses the GitHub App's credentials to make requests to GitHub Enterprise Cloud.

GitHub Enterprise Server stores credentials from the GitHub App. The following credentials will be replicated to all nodes in a high availability or cluster environment, 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

Prerequisites

  • You must have an enterprise account on GitHub.com that uses GitHub Enterprise Cloud.
  • Your enterprise account on GitHub.com must be invoiced. Enterprise accounts on the free trial of GitHub Enterprise Cloud or that pay by credit card cannot be connected to sua instância do GitHub Enterprise Server.
  • If your enterprise account on GitHub.com uses IP allow lists, you must add the IP address or network for sua instância do GitHub Enterprise Server to your IP allow list. See "Aplicando políticas para configurações de segurança na sua empresa" in the GitHub Enterprise Cloud documentation.
  • To configure a connection, your proxy configuration must allow connectivity to github.com, api.github.com, and uploads.github.com. For more information, see "Configurando um servidor proxy Web de saída."
  • If you have previously enabled GitHub Connect for an enterprise on GHE.com, you must change your configuration to allow connections to GitHub.com. See "Enabling GitHub Connect for GHE.com."

Enabling GitHub Connect

To enable GitHub Connect, you must be an enterprise owner on both GitHub Enterprise Server and GitHub Enterprise Cloud.

  1. Sign in to sua instância do GitHub Enterprise Server and GitHub.com.

  2. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

    Captura de tela do menu suspenso que aparece quando você clica na foto de perfil no GitHub Enterprise Server. A opção "Configurações da empresa" está realçada em um contorno laranja escuro.

  3. Na barra lateral da conta corporativa, clique em GitHub Connect .

  4. Em "O GitHub Connect ainda não está habilitado", clique em Habilitar o GitHub Connect . Ao clicar em Habilitar GitHub Connect , você concorda com "Termos do GitHub para produtos e recursos adicionais".

  5. À direita da conta corporativa que você deseja conectar, clique em Conectar.