Esta versão do GitHub Enterprise foi descontinuada em 2021-06-09. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Conectar o GitHub Enterprise Server ao GitHub Enterprise Cloud

Ao habilitar o GitHub Connect, você poderá compartilhar recursos e fluxos de trabalho específicos entre a sua instância do GitHub Enterprise Server e o GitHub Enterprise Cloud.

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

Sobre o GitHub Connect

Para habilitar o GitHub Connect, você deve configurar a conexão na sua instância do GitHub Enterprise Server e na sua organização do GitHub Enterprise Cloud ou na conta corporativa.

Para configurar uma conexão, sua configuração de proxy deve permitir conectividade com o github.com e o api.github.com. Para obter mais informações, consulte "Configurar servidor proxy web de saída".

Após habilitar o GitHub Connect, você poderá ativar recursos como a pesquisa unificada e as contribuições unificadas. Para obter mais informações sobre todos os recursos disponíveis, consulte "Gerenciar conexões entre o GitHub Enterprise Server e o GitHub Enterprise Cloud".

Ao conectar a sua instância do GitHub Enterprise Server ao GitHub Enterprise Cloud, um registro no GitHub.com armazena as informações sobre a conexão:

  • A parte da chave pública da sua licença do GitHub Enterprise Server;
  • Um hash da sua licença do GitHub Enterprise Server;
  • O nome do cliente da sua licença do GitHub Enterprise Server;
  • O nome de host da sua instância do GitHub Enterprise Server;
  • A versão da sua instância do GitHub Enterprise Server;
  • A conta da organização ou empresa em GitHub.com que estiver conectada a sua instância do GitHub Enterprise Server
  • O token de autenticação usado pela sua instância do GitHub Enterprise Server para fazer solicitações ao GitHub.com.

Habilitar o GitHub Connect também cria um aplicativo GitHub pertencente à sua conta corporativa ou organização do GitHub Enterprise Cloud. O GitHub Enterprise Server usa as credenciais do aplicativo GitHub para fazer solicitações ao GitHub.com.

O GitHub Enterprise Server armazena as credenciais do aplicativo GitHub. Essas credenciais serão replicadas em qualquer ambiente de clustering ou alta disponibilidade e serão armazenadas em qualquer backup, inclusive os instantâneos criados pelo GitHub Enterprise Server Backup Utilities.

  • Um token de autenticação válido por uma hora;
  • Uma chave privada usada para gerar um novo token de autenticação.

Habilitar o GitHub Connect não permitirá que os usuários do GitHub.com façam alterações no GitHub Enterprise Server.

Para obter mais informações sobre o gerenciamento de contas corporativas usando a API GraphQL, consulte "Contas corporativas".

Habilitar o GitHub Connect

  1. Entre na sua instância do GitHub Enterprise Server e no GitHub.com.

  2. Acesse a conta corporativa visitando https://HOSTNAME/enterprises/ENTERPRISE-NAME, substituindo HOSTNAME pelo nome de host da sua instância e ENTERPRISE-NAME pelo nome da conta da sua empresa.

  3. Na barra lateral da conta corporativa, clique em Settings. Aba de configurações na barra lateral de contas corporativas

  4. Na barra lateral esquerda, clique em GitHub Connect. Aba GitHub Connect na barra lateral de configurações da conta de negócios

  5. Em "GitHub.com ainda não está habilitado", clique em Enable GitHub Connect (Habilitar o GitHub Connect). Ao clicar em Enable GitHub Connect (Habilitar o GitHub Connect), você concorda com o GitHub Connect Adendo ao contrato de licença do GitHub Enterprise. Botão Enable GitHub Connect (Habilitar o GitHub Connect)

  6. Ao lado da conta corporativa ou organização que você pretende conectar, clique em Connect (Conectar). Botão Connect (Conectar) ao lado de uma conta corporativa ou empresa

Desconectar uma conta corporativa ou organização do GitHub Enterprise Cloud da sua instância do GitHub Enterprise Server

Ao se desconectar do GitHub Enterprise Cloud, o aplicativo GitHub do GitHub Connect é excluído da sua conta corporativa ou organização e as credenciais armazenadas na sua instância do GitHub Enterprise Server são excluídas.

  1. Acesse a conta corporativa visitando https://HOSTNAME/enterprises/ENTERPRISE-NAME, substituindo HOSTNAME pelo nome de host da sua instância e ENTERPRISE-NAME pelo nome da conta da sua empresa.

  2. Na barra lateral da conta corporativa, clique em Settings. Aba de configurações na barra lateral de contas corporativas

  3. Na barra lateral esquerda, clique em GitHub Connect. Aba GitHub Connect na barra lateral de configurações da conta de negócios

  4. Ao lado da conta corporativa ou organização que você gostaria de desconectar, clique em Disable GitHub Connect) (Desabilitar o GitHub Connect). Desabilitar o botão GitHub Connect ao lado do nome de uma conta corporativa ou organização

  5. Leia as informações sobre a desconexão e clique em Disable GitHub Connect (Desabilitar o GitHub Connect). Botão Modal com informações de aviso sobre desconexão e confirmação