Intégration DNS Plesk

Plesk reste la source DNS ; le_dns publie l'état voulu de la zone

Pilote avant lancement : ce guide décrit l’extension v2 présente dans le dépôt. Elle n’est pas déployée sur la plateforme historique de production et ne peut pas encore être installée depuis un compte le_dns actif. Utilisez-la uniquement après l’admission explicite de votre panneau au pilote d’octobre 2026 et la fourniture du paquet et du point d’accès v2 par le_dns. Un abonnement Pro ou Enterprise ne suffit pas à activer cette préversion. Tant que l’admission serveur du pilote n’est pas déployée et que votre panneau n’est pas inscrit, l’intégration reste indisponible.

Avant la connexion

L’extension prend en charge Plesk Obsidian 18.0.63 ou version ultérieure sous Linux et nécessite une offre le_dns Pro ou Enterprise ainsi que l’inscription explicite d’un UUID d’installation exact au pilote. Les panneaux Windows et les versions Plesk antérieures à 18.0.63 ne sont pas pris en charge. Un administrateur du pilote préalloue d’abord un UUID aléatoire et inscrit ce couple compte-installation exact. La page Facturation n’affiche ensuite le paquet générique que pour cet UUID actif. L’UUID n’est pas secret : l’autorité repose sur la session interactive, l’inscription auditée puis la clé dédiée. Ne réutilisez ni une clé client complète, ni une clé créée pour une autre installation Plesk. La vérification de connexion renvoie uniquement la portée de la clé, l’UUID de l’installation associée, l’offre actuelle et l’éligibilité Plesk ; elle n’expose au panneau ni l’identité du compte, ni les quotas, ni les fonctions sans rapport avec Plesk.

Plesk 18.0.63 a introduit les événements de cycle de vie transmis au backend DNS personnalisé et nécessaires à la création, la mise à jour et la suppression sûres. Avant l’installation, un administrateur du serveur doit configurer exactement ceci dans /usr/local/psa/admin/conf/panel.ini :

[dns]
newEvents = true

Consignez la sortie de plesk version et inspectez la section active avec sed -n '/^[[:space:]]*\[dns\][[:space:]]*$/,/^[[:space:]]*\[/p' /usr/local/psa/admin/conf/panel.ini. L’extension valide ces deux prérequis avant de contacter le_dns, d’enregistrer une clé ou de déclarer son backend. Elle refuse la connexion si l’un d’eux manque et ne modifie jamais panel.ini à votre place.

Téléchargez depuis la page Facturation le paquet associé à l’UUID préalloué, vérifiez la somme SHA-256 affichée, puis importez-le dans Extensions > Mes extensions dans Plesk. Ouvrez le_dns et collez cet UUID exact. Créez une clé API avec l’autorité Plesk uniquement pour le même UUID, saisissez le point d’accès API et la clé, puis testez la connexion avant d’activer la synchronisation. La première connexion réussie verrouille l’UUID ; un panneau restauré ou cloné doit suivre la rotation ou l’adoption contrôlée au lieu de le modifier localement.

Le bouton d’import est désactivé par défaut dans les versions Plesk récentes. S’il n’est pas visible, l’administrateur du serveur doit autoriser explicitement l’import d’extensions dans panel.ini ou installer le ZIP fourni avec plesk bin extension -i /chemin/absolu/le-dns-0.1.0-1.zip ; n’utilisez pas un paquet homonyme provenant d’un miroir non fiable.

Fonctionnement de la synchronisation

Plesk reste la source de gestion. Son état DNS complet est placé dans une file locale puis envoyé à le_dns via HTTPS. Chaque modification est ordonnée par le numéro de série SOA Plesk et appliquée dans une transaction : un événement ancien ne peut donc pas remplacer des données publiées plus récentes. Le SOA et les NS de sommet de zone restent gérés par le_dns.

L’extension affiche la progression de la file et conserve les travaux en échec pour une nouvelle tentative bornée. Si une synchronisation atteint la limite de tentatives, corrigez le problème de connexion puis confirmez Resynchroniser toutes les zones. Cette action relance les synchronisations en échec des domaines encore présents dans Plesk, sans modification DNS. Les tentatives en cours, les délais de grâce et les retraits de zones conservent leur calendrier. Après un changement d’offre rendant la synchronisation accessible en lecture seule, les données DNS déjà publiées restent servies ; l’état et la déconnexion restent disponibles.

Un échec de paiement pendant le délai de grâce n’est pas une rétrogradation. Plesk conserve chaque état accepté dans sa file locale et le relance au plus une fois par heure, sans épuiser la limite normale de livraison. Le dernier état DNS publié reste en ligne. Après confirmation du paiement, les changements reprennent automatiquement ; si l’offre a réellement été rétrogradée à la fin du délai, rétablissez Pro ou Enterprise puis lancez Resynchroniser toutes les zones.

Suppression d’une zone Plesk

La suppression d’une zone dans Plesk place son retrait sûr dans la file le_dns ; elle n’efface pas immédiatement les données publiées. La demande est liée au dernier numéro de série SOA et à la dernière révision acquittés pour cette installation : une ancienne suppression ne peut donc pas retirer une resynchronisation plus récente. Si DNSSEC est actif, l’extension vous demande de supprimer l’ensemble complet des DS chez le parent et le_dns continue de servir la zone signée pendant la preuve d’absence et l’expiration du TTL DS observé. Le retrait des serveurs DNS faisant autorité et le nettoyage des clés gérées suivent, avant l’état Retirée en toute sécurité.

Conservez la connexion du panneau et sa clé dédiée jusqu’à l’état terminal. Ce retrait d’autorité reste disponible après une rétrogradation d’offre ou pendant un blocage de facturation. En revanche, désactiver ou désinstaller l’extension entière est une déconnexion non destructive qui conserve les zones distantes.

Délégation et vérification

La synchronisation crée une zone en attente ; elle ne prouve pas sa propriété et ne la rend pas autoritative. Publiez le défi TXT _ledns-verify depuis Plesk, attendez qu’il soit répondu par l’autorité publique actuelle, puis connectez-vous au portail le_dns pour vérifier la zone. La clé Plesk ne peut volontairement pas effectuer cette vérification. Réessayez depuis le portail jusqu’à ce qu’il indique serving=true pour chaque réplique autoritative.

Ensuite seulement, déléguez la zone chez le bureau d’enregistrement vers les serveurs indiqués par le_dns. L’état de délégation reste informatif tant qu’une observation DNS publique ne l’a pas confirmé. Ne retirez jamais l’ancien fournisseur avant d’avoir vérifié les réponses autoritatives depuis un réseau externe. L’ensemble v2 publié comprend ns-gra.ledns.eu, ns-lim.ledns.eu et ns-waw.ledns.eu ; déléguez les trois uniquement après confirmation par l’opérateur du pilote que la zone est prête.

Le DS de la zone synchronisée appartient à la délégation publiée par le parent : publiez-le chez le bureau d’enregistrement ou le fournisseur DNS parent, pas dans la zone elle-même. Les DS sous le sommet restent pris en charge lorsque cette zone délègue l’un de ses propres enfants.

Désinstallation et restauration

Désactivez ou désinstallez depuis Plesk afin que l’extension puisse se déconnecter et révoquer sa clé API liée. Si le_dns est indisponible, consultez le journal d’actions et le journal du panneau Plesk, puis révoquez manuellement la clé dans le portail le_dns avant de considérer la désinstallation comme terminée ; les avertissements locaux de l’extension ne survivent pas à une désinstallation achevée. Un panneau restauré ou cloné doit inscrire un nouvel UUID d’installation et créer une nouvelle clé déjà liée à celui-ci. Si l’ancienne installation a conservé des zones distantes, un opérateur doit ensuite terminer le workflow contrôlé d’adoption de l’installation avant une resynchronisation complète depuis le panneau de remplacement. Ne réutilisez jamais l’identité ou la clé de l’ancien panneau.

Pour un retour arrière avant délégation, désactivez la synchronisation et confirmez que le backend personnalisé n’est plus enregistré ; aucune zone le_dns active n’est supprimée. Après délégation, restaurez d’abord la zone complète et les NS du fournisseur précédent chez le bureau d’enregistrement, vérifiez les réponses autoritatives depuis l’extérieur, puis désactivez l’intégration.

Pour obtenir de l’aide, écrivez à support@ledns.eu.