Mettre en place un sous-domaine

Version 3.4 par Clément AUBIN le 2021/04/18 09:08

Lorsqu'une VM est mise en place, et que le service qu'elle doit héberger est installé, il est grand temps de rendre ce service accessible à l'extérieur du réseau d'ATILLA.

Idée générale

Avant de suivre les étapes de mise en place, c’est intéressant de comprendre ce qu’on va faire .

Dans l'infra d'ATILLA, les connexions à un service web (members.atilla.org, learn.atilla.org, …) passent en grande majorité par Bill, qui acte comme d'un frontal web : c’est lui qui réceptionne les connexions HTTP(s) et qui les renvoie aux bons services internes par la suite. On dit également que Bill joue le rôle de reverse-proxy.

En plus de cela, Bill gère la terminaison des connexions HTTPs : c’est à dire que lorsqu’une connexion HTTPs arrive sur Bill, elle est déchiffrée, puis renvoyée en HTTP à la machine virtuelle qui correspond. Cela permet de ne pas complexifier l’installation des services, et d’avoir un endroit central ou gérer les certificats SSL.

reverse-proxy-arch.png

En pratique, Bill dispose d'un serveur Nginx, qui va avoir réceptionner toute requête HTTP(s) sur un des sites d'ATILLA et qui transfère cette requête à la VM qui héberge le service correspondant.

Enregistrement du sous-domaine

La première chose à faire est de déclarer au monde que le domaine sur lequel vous souhaitez déployer votre service existe. Il n’y a pas de convention à proprement parler sur le choix du sous-domaine. Si vous déployez un service de gestion de tickets (par exemple, GLPI), le domaine auquel ce service pourra être accessible peut très bien être glpi.atilla.org ou même tickets.atilla.org.

Pour déclarer ce domaine, rendez-vous sur la machine qui sert de DNS dans l’infra (aujourd’hui, il s’agit de Bill). Deux fichiers devront être édités :

  • /etc/bind/internal/db.atilla.org : les entrées DNS qui sont exposées à tous les utilisateurs au sein du réseau d’ATILLA et de l’EISTI
  • /etc/bind/external/db.atilla.org : les entrées DNS qui sont exposées à tous les utilisateurs venant de l’extérieur

Dans ces deux fichiers, rajoutez une ligne comme celle-ci :

monservice IN CNAME bill

… puis redémarrez le serveur DNS :

systemctl restart bind9

Cela aura pour effet de déclarer le sous-domaine monservice.atilla.org.

Si vous devez déclarer un service sur *.eistiens.net, il faudra éditer les fichiers db.eistiens.net dans les dossiers internal et external de la configuration du DNS.

Warning

Lorsqu’on fait une modification dans une configuration DNS, il y a toujours un temps dit de "propagation", pendant lequel l’entrée qui a été déclarée n’est pas tout de suite accessible par tout le monde. Cela peut prendre jusqu’à 24h pour qu’une entrée soit réellement accessible par tous. Cela est également vrai lorsqu’on modifie ou supprime une entrée.

Mise en place des certificats SSL

Mise en place de la configuration Nginx