Aide et guides

Fritz!Box (AVM)

Internet → Autoriser l'accès → DynDNS

Fournisseur:

Personnalisé

URL de mise à jour:

https://api.dnsbeacon.com/nic/update?hostname=<domain>&myip=<ipaddr>

Nom de domaine:

myhouse.dnsfollowme.uk

Nom d'utilisateur:

ton adresse e-mail

Mot de passe:

ta clé API

Ubiquiti UniFi

Settings → Internet → WAN → Dynamic DNS

Service:

custom (ou dyndns)

Nom d'hôte:

myhouse.dnsfollowme.uk

Nom d'utilisateur:

ton adresse e-mail

Mot de passe:

ta clé API

Serveur:

api.dnsbeacon.com/nic/update?hostname=%h&myip=%i

Remarque : UniFi n'envoie de mises à jour que lorsque l'IP WAN change réellement. Pour forcer une mise à jour, désactive la configuration DynDNS, enregistre, réactive, enregistre.

pfSense / OPNsense

Services → Dynamic DNS → Add

Type de service:

Custom

URL de mise à jour:

https://api.dnsbeacon.com/nic/update?hostname=%h&myip=%IP%

Nom d'hôte:

myhouse.dnsfollowme.uk

Nom d'utilisateur:

ton adresse e-mail

Mot de passe:

ta clé API

Synology NAS

Panneau de configuration → Accès externe → DDNS → Ajouter

Fournisseur:

Personnalisé

Nom d'hôte:

myhouse.dnsfollowme.uk

Nom d'utilisateur:

ton adresse e-mail

Mot de passe:

ta clé API

URL du serveur:

https://api.dnsbeacon.com/nic/update?hostname=__HOSTNAME__&myip=__MYIP__

Autres appareils (compatibles DynDNS2)

Tout appareil qui parle DynDNS2 fonctionne avec ce qui suit :

URL de mise à jour:

https://api.dnsbeacon.com/nic/update?hostname=<host>&myip=<ip>

Authentification:

Basic Auth (e-mail / clé API)

IPv6 (optionnel):

paramètre supplémentaire &myipv6=<ipv6>

Cloudflare

Prérequis : le domaine est délégué à Cloudflare (serveurs de noms réglés sur Cloudflare).

1. Sur dash.cloudflare.com/profile/api-tokens crée un jeton.
2. Utilise le modèle « Edit zone DNS » — permissions : Zone:DNS:Edit.
3. Sous Zone Resources choisis soit Specific zone → ton-domaine.com soit All zones.
4. Copie le jeton et colle-le dans le tableau de bord sous Domaines → Ajouter un domaine.

Hetzner DNS

Prérequis : le domaine est configuré comme zone dans la console DNS Hetzner.

1. Sur dns.hetzner.com/settings/api-token crée un jeton API.
2. Copie le jeton — il n'est affiché qu'une seule fois.
3. Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « Hetzner DNS » et colle le jeton.

united-domains

Prérequis : l'option payante DNS API est activée pour la zone chez united-domains. Sans elle, le jeton ne renvoie aucune zone.

1. Souscris à l'option DNS API dans le portefeuille united-domains.
2. Génère la clé API dans ton espace client.
3. Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « united-domains » et colle la clé.

Limite de débit : 1 200 requêtes/heure par jeton.

IONOS

Prérequis : le domaine est dans ton compte IONOS et l'accès API est activé dans le portail développeurs.

1. Ouvre developer.hosting.ionos.de/keys et crée une nouvelle paire de clés (public prefix + secret).
2. Copie le jeton combiné au format « <prefix>.<secret> » — il n'est affiché qu'une seule fois.
3. Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « IONOS » et colle le jeton combiné.

Les enregistrements TXT sont pris en charge — les certificats Let's Encrypt via DNS-01 fonctionnent pour les zones hébergées chez IONOS.

INWX

Prérequis : le domaine est dans ton compte INWX.

1. Connecte-toi à l'espace client INWX et crée un sous-utilisateur API sans 2FA dans « Compte → Gestion des utilisateurs ».
2. Note le nom d'utilisateur et le mot de passe du sous-utilisateur.
3. Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « INWX » et saisis le nom d'utilisateur et le mot de passe.

Important : la connexion API INWX échoue si le compte a la 2FA Mobile-TAN activée. Crée un sous-utilisateur séparé sans 2FA pour cela — ton compte principal peut (et devrait) conserver la 2FA.

netcup

Prérequis : le domaine est géré via ton compte netcup.

1. Dans le Customer Control Panel netcup sous « Stammdaten ändern → API », crée une nouvelle paire de clés API.
2. Note le numéro client, la clé API et le mot de passe API (le mot de passe n'est affiché qu'une seule fois).
3. Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « netcup » et colle les trois valeurs.

Note : l'API netcup est basée sur recordset (chaque modification remplace l'intégralité du jeu d'enregistrements). Si tu édites des enregistrements DNS manuellement dans le CCP au moment où nous posons un enregistrement TXT Let's Encrypt, une modification peut être perdue. En fonctionnement normal (mises à jour DynDNS, renouvellements de certificats) ce n'est pas un problème.

OVHcloud

Prérequis : le domaine est dans ton compte OVHcloud et tu utilises l'endpoint européen (eu.api.ovh.com).

1. Crée une nouvelle application API sur ovh.com/auth/api/createApp — tu obtiens une application key et un application secret.
2. Ouvre l'OVH Token Maker, saisis l'application key et le secret, puis génère une consumer key.
3. Important : accorde à la consumer key ces droits (GET, POST, PUT, DELETE chacun sur /domain/zone/*), confirme dans ton compte OVH et copie la consumer key obtenue.
4. Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « OVHcloud » et colle les trois valeurs.

Note : nous utilisons par défaut l'endpoint EU. Les comptes CA/US nécessitent une URL de base différente — merci de nous contacter au préalable.

deSEC

Prérequis : un compte (gratuit) chez deSEC.io avec une zone configurée.

1. Crée un nouveau jeton API sur desec.io/tokens.
2. Copie le jeton immédiatement — il n'est affiché qu'une seule fois.
3. Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « deSEC » et colle le jeton.

deSEC est compatible ACME-DNS-01 — les certificats Let's Encrypt fonctionnent sans configuration particulière.

Gandi

Prérequis : le domaine est géré via ton compte Gandi.

1. Ouvre admin.gandi.net et connecte-toi.
2. Dans Authentication options → Personal Access Tokens, crée un nouveau jeton avec la permission « Manage DNS records ».
3. Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « Gandi » et colle le jeton.

Gandi LiveDNS impose un TTL minimum de 300s — nous remontons automatiquement les valeurs inférieures.

Mittwald

Prérequis : un compte Mittwald avec un projet, et le domaine configuré comme zone DNS.

1. Dans mStudio, sous Profil → API Tokens, crée un nouveau jeton avec accès en écriture aux zones DNS.
2. Note l'ID de projet (UUID) qui contient la zone — visible dans l'URL mStudio.
3. Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « Mittwald » et colle le jeton API et l'ID de projet.

Note : Mittwald crée un objet « DNS Zone » distinct dans ton projet pour chaque sous-domaine (délégation de sous-zones). 10 hôtes DynDNS → 10 sous-zones — fonctionnellement correct, mais visible dans l'UI mStudio.

Infomaniak

Prérequis : le domaine est dans ton compte Infomaniak Manager.

1. Ouvre Manager → Profil → Clés API et crée un jeton avec la portée « Domain ».
2. Note le jeton (affiché une seule fois).
3. Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « Infomaniak » et colle le jeton.

Infomaniak supporte nativement les enregistrements TXT — les certificats Let's Encrypt via DNS-01 fonctionnent sans configuration particulière.

Scaleway

Prérequis : le domaine est enregistré chez Scaleway et géré dans ton compte.

1. Dans la console Scaleway, sous IAM → API keys, crée une nouvelle clé API.
2. Note uniquement le « Secret Key » — l'access key n'est pas nécessaire.
3. Dans le tableau de bord, sous Domaines → Ajouter un domaine, choisis le fournisseur « Scaleway » et colle le Secret Key.

Scaleway utilise un modèle de changements basé sur PATCH — les opérations sont atomiques par requête. Let's Encrypt DNS-01 fonctionne nativement.