Conectar o GitHub Enterprise Server ao GitHub Enterprise Cloud

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.

4. Na barra lateral esquerda, clique em GitHub Connect.

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.

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

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.

3. Na barra lateral esquerda, clique em GitHub Connect.

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

5. Leia as informações sobre a desconexão e clique em Disable GitHub Connect (Desabilitar o GitHub Connect).