Domaines, DNS et certificats

Les comptes que l’entreprise a chez ses hébergeurs (IONOS…) : libellé, numéro client, numéro de contrat, voyant du dernier contrôle, date du dernier relevé, ce que chaque compte sait faire et combien de domaines, de zones et de certificats Nexus y connaît. Sert à savoir sur quel compte chercher une ressource. La clé d’API n’est jamais rendue — seul son préfixe public l’est, celui qui sert à la révoquer chez l’hébergeur. Réservé aux administrateurs.

Les domaines, zones DNS et certificats que l’entreprise possède chez ses hébergeurs, avec le compte qui les porte et les objets du parc auxquels ils sont rattachés (site, client, projet, machine). LE POINT DE DÉPART de tout travail sur l’infrastructure : ne jamais supposer qu’une zone ou un domaine existe, le chercher ici. Les identifiants de ressource viennent d’ici et de nulle part ailleurs — un identifiant deviné est refusé, et celui d’une autre entreprise est introuvable. « q » filtre sur le nom, « unbound » ne montre que ce qui n’est rattaché à rien, « removed » rappelle ce qui a disparu d’un relevé.

• connectionId texte, facultatif — Se limiter à un compte (nexus_list_provider_connections)
• kind DOMAIN | DNS_ZONE | SSL_CERTIFICATE | APP_PROJECT | VPS, facultatif — DOMAIN (le nom de domaine), DNS_ZONE (sa zone) ou SSL_CERTIFICATE
• siteId texte, facultatif — Rattachées à ce site du parc
• serverId texte, facultatif — Rattachées à cette machine
• clientId texte, facultatif — Rattachées à ce client
• projectId texte, facultatif — Rattachées à ce projet
• unbound booléen, facultatif — Seulement ce qui n’est rattaché à rien — le travail qui reste à faire
• removed booléen, facultatif — Inclure ce qui a disparu d’un relevé abouti
• q texte, facultatif — Filtre sur le nom, ex. « exemple.fr »
• page nombre, facultatif
• size nombre, facultatif — 50 par défaut, 200 au plus

La fiche d’une ressource telle que l’hébergeur la donne : statut, échéance, verrous de transfert, serveurs de noms, DNSSEC, jeton de validation d’un certificat — plus ses rattachements dans le parc et ce que son compte permet de faire. Pour le CONTENU d’une zone DNS, c’est nexus_list_dns_records.

• id texte — Identifiant rendu par nexus_list_provider_resources

Les enregistrements d’une zone DNS : nom complet, type, contenu, TTL, priorité. LECTURE SEULE — rien n’est modifié, rien n’est proposé. À lire AVANT toute proposition de changement : une zone se raisonne sur son état réel, jamais de mémoire ni sur ce qu’un client en a décrit. La réponse dit aussi si la zone est modifiable et, sinon, pourquoi. « refresh » force une relecture chez l’hébergeur au lieu du dernier relevé — inutile juste après un aperçu, qui vient de lire. L’identifiant est celui d’une ressource de type DNS_ZONE (nexus_list_provider_resources) : sur un domaine ou un certificat, l’appel est refusé.

• id texte — Ressource de type DNS_ZONE (nexus_list_provider_resources)
• refresh booléen, facultatif — Relire la zone chez l’hébergeur maintenant

Ce qui a été modifié chez les hébergeurs : qui, quand, sur quelle zone, avec quel niveau de risque, appliqué ou non, et d’où venait la demande (Nexus, un agent, une tâche de fond). C’est la réponse à « qu’est-ce qui a bougé sur ce domaine ? », et c’est à regarder AVANT d’accuser autre chose lors d’une panne de messagerie ou de site. Paginé par curseur (nextCursor).

• connectionId texte, facultatif — Se limiter à un compte
• resourceId texte, facultatif — Se limiter à une ressource
• siteId texte, facultatif — Se limiter à ce qui touche un site du parc
• status PLANNED | APPLIED | PARTIAL | FAILED | REVERTED, facultatif — PLANNED (aperçu non appliqué), APPLIED, PARTIAL, FAILED ou REVERTED
• risk LOW | MEDIUM | HIGH | CRITICAL, facultatif — LOW, MEDIUM, HIGH ou CRITICAL
• limit nombre, facultatif — 30 par défaut
• cursor texte, facultatif

Le détail d’un changement : chaque opération avec son avant et son après, son verdict une fois appliquée, les raisons du risque, le cliché de la zone pris avant l’écriture et s’il est encore défaisable. À montrer quand on rend compte d’une modification — la sienne comprise, aussitôt après l’avoir appliquée.

• id texte — Identifiant du changement, rendu par un aperçu ou par la liste

Où est ce domaine, qui gère ses DNS, sur quel compte, quelle machine : pour un site, une machine, un client ou un projet, en UN appel — les ressources d’hébergeurs rattachées, ce que Nexus sait sans passer par un fournisseur, et le nombre de rattachements proposés en attente. À préférer à une recherche ressource par ressource : le plafond d’appels des hébergeurs est horaire et partagé par toute l’entreprise.

• targetType site | server | client | project — La nature de l’objet du parc
• targetId texte — Son identifiant, donné par nexus_list_sites, _servers, _clients…

Calcule la différence entre la zone telle qu’elle est et la zone telle qu’on la veut, et le niveau de risque qui va avec — SANS RIEN APPLIQUER. À appeler SYSTÉMATIQUEMENT avant nexus_apply_dns_change, et à MONTRER à l’utilisateur : c’est l’aperçu, il porte le « avant → après » opération par opération et les raisons du risque, écrites en français et montrables telles quelles. Citer un couple (nom, type) dans « records » en donne l’état COMPLET : n’envoyer qu’une ligne d’un groupe qui en compte trois supprime les deux autres — relire la zone d’abord (nexus_list_dns_records). Pour vider un groupe entier, le nommer dans « supprimer » plutôt que d’essayer de deviner ses lignes. L’aperçu rend un changeId et un planHash : ce sont eux qu’on applique ensuite, jamais l’intention réécrite.

• id texte — Ressource de type DNS_ZONE (nexus_list_provider_resources)
• records liste de objet { name, type, content, ttl, prio, disabled }, facultatif — Les enregistrements VOULUS, groupe par groupe : l’état complet de chaque couple (nom, type) cité. Le reste de la zone n’est pas touché
• supprimer liste de objet { name, type }, facultatif — Les couples (nom, type) à vider entièrement

Applique un plan DÉJÀ calculé par nexus_plan_dns_change, désigné par son changeId et son planHash — jamais une intention réécrite ici. C’est Nexus qui appelle l’hébergeur : la clé d’API ne passe pas par la session, ne la demande jamais et ne cherche pas à l’obtenir autrement. Un changement à RISQUE ÉLEVÉ (messagerie, délégation du domaine, certificat) sera REFUSÉ : il se confirme depuis Nexus, devant l’aperçu, par une personne. Ne jamais réessayer un changement refusé, ni le découper pour le faire passer, sans nouvelle instruction de l’utilisateur. ANNONCER PRÉCISÉMENT ce qui va changer avant d’appeler : une zone est publique, une erreur se voit chez le client. Si la zone a bougé depuis l’aperçu, l’empreinte ne correspond plus et l’appel est refusé — refaire un aperçu et le remontrer.

• id texte — La même ressource DNS_ZONE que l’aperçu
• changeId texte — Rendu par nexus_plan_dns_change
• planHash texte — Empreinte rendue par le MÊME aperçu
• confirm booléen, facultatif — Reconnaît que l’aperçu a été lu et montré à l’utilisateur. Exigé dès le risque modéré ; il ne déverrouille pas un risque élevé, refusé aux agents quoi qu’il arrive
• idempotencyKey texte, facultatif — Rejouer le même appel avec la même clé ne l’applique pas deux fois

Relève ce qu’un compte d’hébergeur contient — domaines, zones, certificats — et rattache ce qui se reconnaît au parc. Tourne en arrière-plan et rend une campagne à suivre (nexus_list_provider_connections en montre l’issue). Utile quand une ressource vient d’être créée chez l’hébergeur et n’apparaît pas encore dans Nexus ; inutile sinon : un relevé tourne déjà tout seul, et chaque campagne consomme des appels sur un plafond horaire partagé par toute l’entreprise. Ne pas relancer en boucle pour attendre un résultat. Réservé aux administrateurs.

• id texte — Le compte, donné par nexus_list_provider_connections