Skip to main content

Gerenciando o GitHub Connect

Habilite o GitHub Connect para acessar recursos e fluxos de trabalho adicionais do sua instância do GitHub Enterprise Server.

Sobre o GitHub Connect

Acesse recursos e fluxos de trabalho adicionais do sua instância do GitHub Enterprise Server, habilitando o GitHub Connect. Para obter mais informações, confira "Sobre o GitHub Connect".

Ao habilitar o GitHub Connect, você configura uma conexão entre o sua instância do GitHub Enterprise Server e uma conta corporativa do GitHub Enterprise Cloud. A conexão usa HTTPS nas portas 443 ou 80 e é protegida pelo TLS.

Habilitar o GitHub Connect cria um GitHub App de propriedade da conta corporativa no GitHub Enterprise Cloud. O GitHub Enterprise Server usa as credenciais do GitHub App para fazer solicitações ao GitHub Enterprise Cloud.

O GitHub Enterprise Server armazena as credenciais dos GitHub App. As credenciais a seguir serão replicadas em todos os nós em um ambiente de alta disponibilidade ou de agrupamento e armazenadas em qualquer backup, incluindo instantâneos criados por GitHub Enterprise Server Backup Utilities.

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

Pré-requisitos

Para usar o GitHub Connect, é necessário ter uma conta corporativa no GitHub.com que usa o GitHub Enterprise Cloud. Você pode já ter GitHub Enterprise Cloud incluído no seu plano.

Observação: sua conta empresarial em GitHub.com deve ser faturada. Contas corporativas na avaliação gratuita de GitHub Enterprise Cloud ou que pagam por crédito cartão não podem ser conectadas a sua instância do GitHub Enterprise Server.

Se sua conta corporativa no GitHub.com usar listas de IPs permitidos, adicione o endereço IP ou a rede do sua instância do GitHub Enterprise Server à lista de IPs permitidos no GitHub.com. Para obter mais informações, confira a "Aplicando políticas para configurações de segurança na sua empresa" na documentação do GitHub Enterprise Cloud.

Para configurar uma conexão, sua configuração de proxy precisa permitir a conectividade com github.com, api.github.com e uploads.github.com. Para obter mais informações, confira "Configurando um servidor proxy Web de saída".

Habilitar o GitHub Connect

Para habilitar o GitHub Connect, é necessário ser proprietário de uma empresa tanto no GitHub Enterprise Server quanto no GitHub Enterprise Cloud.

  1. Entre no sua instância do GitHub Enterprise Server e no 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.

Como desabilitar o GitHub Connect

Os proprietários das empresas podem desabilitar GitHub Connect.

Quando você se desconecta do GitHub Enterprise Cloud, o GitHub App do GitHub Connect é excluído da conta corporativa e as credenciais armazenadas no sua instância do GitHub Enterprise Server são excluídas.

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

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

  3. Em "GitHub Connect", à direita da conta corporativa que você deseja desconectar, clique em Desabilitar o GitHub Connect .

  4. Leia as informações sobre a desconexão e clique em Desabilitar o GitHub Connect .