Skip to main content

Configuration d’un nom d’hôte

Nous vous recommandons de définir un nom d’hôte pour votre appliance au lieu d’utiliser une adresse IP codée en dur.

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 your GitHub Enterprise Server instance 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 your GitHub Enterprise Server instance. 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.

  1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur dans le coin supérieur droit de n’importe quelle page.

    Capture d’écran de l’icône représentant une fusée qui donne accès aux paramètres d’administration du site

  2. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.

    Capture d’écran du lien « Administrateur du site » 1. Dans la barre latérale gauche, cliquez sur Management Console . Onglet Management Console dans la barre latérale gauche 3. Dans la barre latérale gauche, cliquez sur Nom d’hôte. Onglet Nom d’hôte dans la barre latérale des paramètres

  3. Tapez le nom d’hôte que vous souhaitez définir pour your GitHub Enterprise Server instance. Champ permettant de définir un nom d’hôte

  4. Pour tester les paramètres DNS et SSL du nouveau nom d’hôte, cliquez sur Tester les paramètres de domaine. Bouton Tester les paramètres de domaine 1. 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 des serveurs de noms DNS ». Tableau montrant l’état des configurations DNS et SSL 1. Sous la barre latérale gauche, cliquez sur Enregistrer les paramètres.

    Capture d’écran du bouton Enregistrer les paramètres de la Management Console

    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.

  5. Attendez la fin de l’exécution de la configuration.

    Configuration de votre instance

Pour atténuer diverses vulnérabilités de scripting intersite, nous vous recommandons d’activer l’isolation de sous-domaine pour your GitHub Enterprise Server instance après avoir configuré un nom d’hôte. Pour plus d’informations, consultez « Activation de l’isolation de sous-domaine ».