À propos de GitHub Connect
Vous pouvez accéder à des fonctionnalités et workflows supplémentaires pour votre instance GitHub Enterprise Server en activant GitHub Connect. Pour plus d’informations, consultez « About GitHub Connect ».
Lorsque vous activez GitHub Connect, vous configurez une connexion entre votre instance GitHub Enterprise Server et un compte d’entreprise sur GitHub Enterprise Cloud. La connexion utilise HTTPS sur les ports 443 ou 80 et est sécurisée par TLS.
L’activation de GitHub Connect a pour effet de créer une GitHub App dont est propriétaire le compte d’entreprise sur GitHub Enterprise Cloud. GitHub Enterprise Server utilise les informations d’identification de l’GitHub App pour adresser des demandes à GitHub Enterprise Cloud.
GitHub Enterprise Server stocke les informations d’identification de l’GitHub App. Les informations d’identification suivantes sont répliquées sur tous les nœuds d’un environnement à haute disponibilité ou de cluster, et sont stockées dans toutes les sauvegardes, y compris les instantanés créés par GitHub Enterprise Server Backup Utilities.
- Un jeton d’authentification, qui est valide pendant une heure
- Une clé privée, qui sert à générer un nouveau jeton d’authentification
Prérequis
Pour utiliser GitHub Connect, vous devez disposer d’un compte d’entreprise sur GitHub.com qui utilise GitHub Enterprise Cloud. GitHub Enterprise Cloud est peut-être déjà inclus dans votre plan.
Remarque : Votre compte d’entreprise sur GitHub.com doit être facturé. Les comptes d’entreprise qui utilisent l’essai gratuit de GitHub Enterprise Cloud ou qui payent par carte de crédit ne peuvent pas être connectés à votre instance GitHub Enterprise Server.
Si votre compte d’entreprise sur GitHub.com utilise des listes vertes d’adresses IP, vous devez ajouter l’adresse IP ou le réseau de votre instance GitHub Enterprise Server à votre liste verte d’adresses IP sur GitHub.com. Pour plus d’informations, consultez « Application de stratégies pour les paramètres de sécurité dans votre entreprise » dans la documentation GitHub Enterprise Cloud.
Pour configurer une connexion, la configuration de votre proxy doit autoriser la connexion à github.com, api.github.com et uploads.github.com. Pour plus d’informations, consultez « Configuration d’un serveur proxy web de trafic sortant ».
Activation de GitHub Connect
Pour activer GitHub Connect, vous devez être propriétaire d’entreprise sur GitHub Enterprise Server et sur GitHub Enterprise Cloud.
-
Connectez-vous à votre instance GitHub Enterprise Server et à GitHub.com.
-
Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.
-
Dans la barre latérale du compte d’entreprise, cliquez sur GitHub Connect .
-
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 ».
-
À droite du compte d’entreprise que vous souhaitez connecter, cliquez sur Connexion.
Désactivation de GitHub Connect
Les propriétaires d’entreprise peuvent désactiver GitHub Connect.
Quand vous vous déconnectez de GitHub Enterprise Cloud, l’GitHub Connect GitHub App est supprimée de votre compte d’entreprise et les informations d’identification stockées dans votre instance GitHub Enterprise Server sont supprimées.
-
Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.
-
Dans la barre latérale du compte d’entreprise, cliquez sur GitHub Connect .
-
Sous « GitHub Connect », à droite du compte d’entreprise que vous souhaitez déconnecter, cliquez sur Désactiver GitHub Connect .
-
Lisez les informations à propos de la déconnexion, puis cliquez sur Désactiver GitHub Connect .