Enabling GitHub Connect for GitHub.com

Enable GitHub Connect to access additional features and workflows from GitHub.com on votre instance GitHub Enterprise Server.

Dans cet article

You can access additional features and workflows on votre instance GitHub Enterprise Server by enabling GitHub Connect. See "À propos de GitHub Connect."

What happens when GitHub Connect is enabled?

When you enable GitHub Connect, you configure a connection between votre instance GitHub Enterprise Server and an enterprise account on GitHub Enterprise Cloud. La connexion utilise HTTPS sur les ports 443 ou 80 et est sécurisée par 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 votre instance GitHub Enterprise Server.
  • If your enterprise account on GitHub.com uses IP allow lists, you must add the IP address or network for votre instance GitHub Enterprise Server to your IP allow list. See "Application de stratégies pour les paramètres de sécurité dans votre entreprise" 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 "Configuration d’un serveur proxy web de trafic sortant."
  • 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 "Activation de GitHub Connect pour 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 votre instance GitHub Enterprise Server and GitHub.com.

  2. Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.

    Capture d’écran du menu déroulant qui s’affiche lorsque vous cliquez sur la photo de profil sur GitHub Enterprise Server. L’option « Paramètres d’entreprise » est mise en évidence avec un contour orange foncé.

  3. Dans la barre latérale du compte d’entreprise, cliquez sur GitHub Connect .

  4. Sous « GitHub Connect n’est pas encore activé », cliquez sur Activer GitHub Connect . En cliquant sur Activer GitHub Connect , vous acceptez les « Conditions GitHub pour les produits et fonctionnalités supplémentaires ».

  5. À droite du compte d’entreprise que vous souhaitez connecter, cliquez sur Connexion.