À propos du nom d'hôte pour GitHub Enterprise Server
Pour assurer un accès fiable à votre instance GitHub Enterprise Server par le biais d'un nom connu sur le réseau, vous pouvez configurer un nom d'hôte. Si vous configurez un nom d'hôte plutôt que d'utiliser une adresse IP codée en dure, vous pouvez modifier le matériel physique sur lequel s'exécute votre instance GitHub Enterprise Server sans affecter les utilisateurs ou les logiciels clients.
Le paramètre de nom d’hôte de la Management Console doit être défini sur un nom de domaine complet approprié (FQDN) qui peut être résolu sur Internet ou dans votre réseau interne. Par exemple, si votre paramètre de nom d’hôte est défini sur github.companyname.com., les requêtes web et d’API seront redirigées automatiquement vers le nom d’hôte configuré dans la Management Console. Notez que localhost n’est pas un paramètre de nom d’hôte valide.
Les noms d’hôte doivent comprendre moins de 63 caractères, d’après la section 2.3.4 du RFC Domain Names Specification.
Après avoir configuré un nom d’hôte, vous pouvez activer l’isolation de sous-domaine pour renforcer la sécurité de votre instance GitHub Enterprise Server. Pour plus d’informations, consultez « Activation de l’isolation de sous-domaine ».
GitHub recommande vivement de ne pas modifier le nom d'hôte d'une instance GitHub Enterprise Server existante. La modification du nom d’hôte entraînera un comportement inattendu, pouvant aller jusqu’à l’interruption de l’instance. Vous devez plutôt configurer une nouvelle instance avec le nom d'hôte souhaité, puis restaurer les paramètres et les données de l'instance d'origine vers la nouvelle instance.
Pour plus d’informations sur les types de nom d’hôte pris en charge, consultez la section 2.1 de la RFC HTTP.
Configuration du nom d'hôte
-
À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
-
Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.
-
Dans la barre latérale « Administrateur de site », cliquez sur Management Console .
-
Dans la barre latérale « Paramètres », cliquez sur Nom d’hôte.
-
Sous « Nom d’hôte », tapez le nom d’hôte que vous souhaitez définir pour votre instance GitHub Enterprise Server.
-
Pour tester les paramètres DNS et SSL du nouveau nom d’hôte, cliquez sur Tester les paramètres de domaine.
-
Si vous ne voyez pas de coche verte à côté de toutes les entrées, vérifiez votre configuration pour le paramètre qui a échoué. Pour plus d’informations, consultez « Configuration de serveurs de noms DNS ».
-
Sous la barre latérale « Paramètres », cliquez sur Enregistrer les paramètres.
Remarque : l’enregistrement des paramètres dans la Management Console redémarre les services système, ce qui peut entraîner un temps d’arrêt visible pour l’utilisateur.
-
Attendez la fin de l’exécution de la configuration.
Pour atténuer diverses vulnérabilités de scripting intersite, nous vous recommandons d’activer l’isolation de sous-domaine pour votre instance GitHub Enterprise Server après avoir configuré un nom d’hôte. Pour plus d’informations, consultez « Activation de l’isolation de sous-domaine ».
Modification du nom d'hôte.
Si vous devez modifier le nom d'hôte de votre instance GitHub Enterprise Server, vous devez restaurer une sauvegarde de votre instance existante vers une nouvelle instance avec le nom d'hôte souhaité. Pour plus d’informations, consultez « Changing the hostname for your instance ».
Avertissement : ne modifiez pas le nom d’hôte de GitHub Enterprise Server après la configuration initiale. La modification du nom d’hôte entraînera un comportement inattendu, pouvant aller jusqu’à des interruptions de l’instance et l’invalidation des clés de sécurité des utilisateurs. Si vous avez modifié le nom d’hôte de votre instance et rencontrez des problèmes, contactez Support GitHub Enterprise ou Support Premium GitHub.