Dynamique DNS (DDNS)

• Exemples
  • ddclient
  • Curl
  • Synology
  • Home Assistant
  • Unifi

Les routeurs et clients DDNS qui prennent en charge le protocole DynDNS2 peuvent utiliser notre API sur ddns.simply.com.

La documentation complète est disponible ici : https://ddns.simply.com/doc/

Exemple :

https://ddns.simply.com/nic/update?hostname=home.example.com&domain=example.com&myip=1.2.3.4

Pour les scripts et autres automatisations DNS, nous recommandons notre API REST, qui peut créer, modifier et supprimer des enregistrements DNS.

L'authentification se fait avec HTTP Basic Authentication, où le mot de passe est la clé API du compte. Le nom d'utilisateur peut être n'importe quoi, par exemple le nom du compte. La clé API d'un compte doit être créée via notre panneau de contrôle.

Si le paramètre myip est omis, l'adresse IP utilisée est celle d'où provient la requête. Les mises à jour doivent se faire via HTTPS.

L'enregistrement doit exister dans la zone DNS avant de pouvoir être mis à jour : un enregistrement A pour IPv4 et un enregistrement AAAA pour IPv6. S'il n'existe pas, la réponse sera nohost, il faut alors créer l'enregistrement dans le panneau de contrôle d'abord.

Le paramètre domain indique le domaine. Il doit être envoyé lorsque le domaine lui‑même est mis à jour, par exemple hostname=example.com&domain=example.com, et peut être utilisé lorsque le domaine ne peut pas être déduit de hostname.

Les réponses suivent le protocole DynDNS2, par exemple good lors d'une mise à jour et nochg lorsque l'adresse IP n'a pas changé.

L'adresse https://ddns.simply.com/myip renvoie l'adresse IP publique d'où provient la requête, et ne nécessite pas d'authentification.

¶Exemples

¶ddclient

protocol=dyndns2
ssl=yes
server=ddns.simply.com
login=ACCOUNTNAME
password=APIKEY
home.example.com

¶Curl

Utilisez la commande Curl suivante pour définir home.example.com sur l'IP externe du client demandeur :

curl -s -u "ACCOUNTNAME:APIKEY" "https://ddns.simply.com/nic/update?hostname=home.example.com"

Vous pouvez programmer cette commande dans une crontab, sur une machine locale, toutes les 15 minutes environ.

¶Synology

Sur Synology, vous pouvez utiliser la syntaxe suivante comme fournisseur DDNS personnalisé

https://ddns.simply.com/nic/update?hostname=__HOSTNAME__&myip=__MYIP__

hostname doit ensuite être indiqué comme le nom de domaine complet que vous souhaitez mettre à jour, par exemple home.example.com.

¶Home Assistant

Le capteur récupère l'adresse IP publique toutes les 5 minutes, et l'automatisation ne met à jour le DNS que lorsque l'adresse change, et au démarrage de Home Assistant. La clé API est stockée dans secrets.yaml.

# configuration.yaml
sensor:
  - platform: rest
    name: Public IP
    resource: https://ddns.simply.com/myip
    value_template: "{{ value | trim }}"
    scan_interval: 300

rest_command:
  simplycom_ddns:
    url: "https://ddns.simply.com/nic/update?hostname=home.example.com"
    username: "ACCOUNTNAME"
    password: !secret simply_api_key

# secrets.yaml
simply_api_key: "APIKEY"

# Automation
alias: Simply.com DDNS
triggers:
  - trigger: state
    entity_id: sensor.public_ip
  - trigger: homeassistant
    event: start
actions:
  - action: rest_command.simplycom_ddns

¶Unifi

Dans UniFi OS, vous devez configurer un fournisseur Dynamic DNS personnalisé et saisir la chaîne suivante dans le champ "Server".

ddns.simply.com/nic/update?hostname=%h&myip=%i