cClaude.rocks ☕ Le blog

Un nom de domaine avec une adresse IP qui n’est pas fixe, comment on s’en sort ?

La fonction d’un nom de domaine est de permettre de retrouver l’adresse IP d’une machine à partir d’un nom. Ce service doit donc connaître l’adresse de la machine même si celle-ci change.

Voici une solution si votre domaine est chez [Gandi.net]. Lien supprimé.

Contexte

Vous souhaitez exposer un service (un ordinateur particulier) derrière une box (à votre domicile) cependant vous fournisseurs d’accès internet (FAI) ne vous propose pas d’adresse IP fixe.

La solution proposée se limite à une box en IPv4, pour une box en IPv6 des adaptations seront à prévoir.

Vous disposez :

• d’une box en IPv4,
• d’un ordinateur proposant un service (par exemple un serveur web),
• d’un nom de domaine chez Gandi et la clé d’API correspondante.

Préliminaires

Ce billet n’a pas vocation à expliquer en détail comment exposer un service, mais voici quelques éléments :

Vous devez commencer par configurer votre box afin qu’elle accepte les connexions entrantes. En général on trouve cela dans une rubrique nommée « Redirection de ports » en IPv4 cela peut être associé à la notion de « NAT » (Network address translation) et en IPv6 au « Filtrage d’adresses ».

Dans le cas d’une BOX en IPv4 :

Pour cela vous devez identifier l’adresse IP de la machine sur le réseau local et le ou les ports que vous souhaitez exposer.

Pour l’exemple on considéra que :

• Sur le réseau local l’ordinateur à l’adresse IP : 192.168.1.191,
• Les services se trouve sur les ports 80 et 433 (en internet et en externe) et qu’ils utilisent le protocole TCP.

En IPv4, vous devrez configurer la redirection de ports :

Les libellés et les champs dépendent de votre box, mais vous devez trouver quelque chose de similaire dans l’interface d’administration.

Le tableau ci-dessus propose l’exemple d’un serveur web répondant en http et en https.

Concernant la valeur du champ protocole, c’est soit TCP, soit UDP, soit TCP/UDP*. Sur vous avec un doute sachez qu’il est plus probable que vous ayez besoin que de TCP. Si ce n’est pas le cas, c’est généralement bien documenter par le service que vous souhaitez exposer.

Le code associé

Le code se compose de fichiers bash (attention BusyBox n’est pas supporté) qui nécessite la commande curl et qui à pour vocation la mise à jour de la configuration Gandi et en particulier le DNS.

• Le fichier gandi-config-commons-api.sh contient des fonctions globales, vous devez « sourcer » ce fichier avant d’utiliser les autres fichiers *-api.sh
• Le fichier gandi-config-dns-api.sh contient les fonctions suivantes :

La plupart des fonctions nécessitent que la variable GANDI_CONFIG_API_KEY contienne votre clé d’api de Gandi,
certaines nécessitent la variable GANDI_CONFIG_DNS_DEFAULT_TTL.

• gandi_config_dns_get_external_ip — Retourne l’IP externe (IP de la box).
• gandi_config_dns_get_href_for_domain DOMAIN_NAME — Retourne la référence pour la zone (zone_records_href).
• gandi_config_dns_get_records_for_domain DOMAIN_NAME — Retourne toutes les entrées du domaine.
• gandi_config_dns_auto_update_A_record DOMAIN_NAME SUBDOMAINE_NAME TTL — Créer ou mettre a jour une entrée de type A avec l'ip externe.
• gandi_config_dns_update_A_record DOMAIN_NAME SUBDOMAINE_NAME TTL IP — Créer ou mettre à jour une entrée de type A avec l'ip donnée.
• gandi_config_dns_update_A_record_from_href DOMAIN_HREF SUBDOMAINE_NAME TTL IP — Créer ou mettre à jour une entrée de type A avec l'ip donnée.
• `gandi_config_dns_create_record_from_href DOMAIN_HREF SUBDOMAINE_NAME TYPE TTL IP – Créer ou mettre à jour une entrée du type donné avec l’IP donnée.
• gandi_config_dns_update_domain_from_JSON IP DOMAIN_JSON_STR -
• gandi_config_dns_update_domains_from_JSON IP DOMAINS_JSON_FILE -

• Le fichier gandi-config-dns-update.sh est un script bash exécutable, qui utilise l’API ci-dessus.

La commande prend les paramètres suivants (tous facultatifs) :

gandi-config-dns-update.sh --help

gandi-config-dns-update.sh [--api-key KEY] [--config JSONFILE] [--ip IP_ADDRESS] [--ttl TTL] [--debug]

Si l’option --config n’est pas précisée la configuration sera recherché à travers les fichiers suivants dans cet ordre :

• Dans le répertoire courant : gandi-config.json
• ${HOME}/.config/gandi-config.json
• /etc/gandi-config.json
• /root/gandi-config.json

Notez que le script doit pouvoir lire le fichier, faites attention aux droits utilisateurs, car le contenu de fichier est sensible…

Format du fichier de configuration :

{
  "gandi": {
    "global": {
      "api-key": "ZzZzZzZzZzZzZzZzZzZzZzZz",
      "ip": {
        "last-ip-file": "/etc/last-external-ip",
        "logfile":      "/var/log/pi/external-ip.log"
      },
      "ttl": 1200
    },
    "domains": [
      {
        "name": "exemple.org"
        "hosts": [
          "@",
          "blog",
          "drive",
          "git",
          "www"
        ]
      },
      {
        "name": "exemple2.org"
        "hosts": [
          "@",
          "cdn",
          "www"
        ]
      }
    ]
  }
}

Liens

• [Documentation de l’API Gandi] Lien supprimé

ᦿ