Si vous configurez un nom d’hôte plutôt qu’une adresse IP codée de manière irréversible, 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 ».
Pour plus d’informations sur les types de nom d’hôte pris en charge, consultez la section 2.1 de la RFC HTTP.
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’à l’interruption de l’instance.
-
À 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 ».