Aide du Hub TheSocle · james.domains.ajouter.valider

Ajouter

Déclare le domaine à James, l'inscrit en base, puis prépare son DNS, sa clé DKIM et son certificat si la zone est pilotée par le Hub.

Voir l'élément dans l'écran : james/domains

Explication

Le Hub enchaîne trois temps.

  1. James apprend le domaine. S'il refuse, rien d'autre n'est fait.
  2. La base enregistre le domaine, avec le mode SMTP et la taille maximale des messages de la configuration.
  3. Le DNS, si la zone du domaine figure au registre des domaines du Hub et que l'adresse du serveur est configurée :
  4. un enregistrement A mail.<domaine> vers l'adresse du serveur (par exemple 203.0.113.10) ;
  5. deux CNAME, smtp. et imap., vers mail.<domaine> ;
  6. un MX de priorité 10 vers mail.<domaine> ;
  7. l'adresse du serveur ajoutée au SPF existant, ou un SPF créé ;
  8. postmaster@<domaine> ajouté aux rapports DMARC, ou un DMARC p=none créé ;
  9. une clé DKIM générée (sélecteur soclehub), sa partie privée au Vault, sa partie publique dans le DNS ;
  10. une demande de certificat pour mail.<domaine>, lancée en arrière-plan.

Le Hub revient sur la liste avec « Domaine domaine ajoute. ». Ce message s'affiche dès que James a accepté le domaine : les étapes DNS ont pu échouer sans que l'écran le dise. Ouvrez la fiche du domaine pour vérifier.

Dans ce démonstrateur, essayez : saisissez un domaine et cliquez sur Ajouter. La page d'arrivée montre l'appel que le vrai Hub aurait fait.

Fiche complète

Requête

POST /hub/james/domains → james_worker.add_domain

Paramètre Obligatoire Vient du champ
domain oui Nom de domaine

Retour de l'action

domain, status: added, et steps : la liste de ce qui a été fait. Les étapes à connaître :

Étape Sens
dns_skipped_zone_inconnue la zone n'est pas au registre : aucun enregistrement créé
dns_skipped_no_config l'adresse du serveur n'est pas configurée : DNS ignoré
dns_mx_created / dns_mx_exists MX posé, ou déjà là
dns_mx_refuse_concurrent:<mx> un autre MX de priorité 10 ou mieux existe : le MX de James n'est pas créé
dns_spf_updated / dns_spf_created SPF complété ou créé
dns_dmarc_updated / dns_dmarc_created DMARC complété ou créé
dkim_generated_and_published / dkim_already_exists clé DKIM posée, ou déjà là
tls_cert_requested_async certificat demandé, en arrière-plan
dns_error:… la préparation DNS s'est arrêtée là

Réponses à l'écran

Cas Message
succès « Domaine domaine ajoute. »
refus de James « Echec ajout domaine : James API refused to add domain: … »

Même chose par MCP

{ "name": "james_worker__add_domain",
  "arguments": { "domain": "atelier-durand.example" } }

Pièges

Sommaire du démonstrateur