Nomadns

Documentation

Certificats par DNS-01

L’autorité de certification (Let’s Encrypt, par exemple) vérifie que vous contrôlez un nom en lisant un enregistrement TXT. Nomadns publie cet enregistrement pour votre client ACME : aucun port n’a besoin d’être ouvert.

Pour un sous-domaine Nomadns

  • Sur la fiche du sous-domaine, créez un jeton « Certificats (ACME, DNS-01) » et copiez identifiant et secret.
  • Exportez les variables, puis demandez le certificat :
export ACMEDNS_BASE_URL=https://api.nomadns.net
export ACMEDNS_USERNAME=identifiant-acme
export ACMEDNS_PASSWORD='secret'
export ACMEDNS_SUBDOMAIN=maison
acme.sh --issue --dns dns_acmedns -d maison.nomadns.net -d '*.maison.nomadns.net'

ACMEDNS_BASE_URL est indispensable : sans elle, acme.sh envoie l’identifiant et le secret au service public auth.acme-dns.io.

Ce que fait Nomadns

  • La valeur est publiée en _acme-challenge.maison.nomadns.net.
  • La réponse attend que les trois serveurs de noms servent la valeur, 20 secondes au plus.
  • Les deux dernières valeurs sont gardées (nom et *.nom), chacune retirée au bout d’une heure.

Pour votre propre domaine

Déléguez le défi à Nomadns par un CNAME dans la zone de votre domaine, puis lancez acme.sh avec votre domaine :

_acme-challenge.exemple.org. CNAME _acme-challenge.maison.nomadns.net.

Le jeton ACME de maison sert alors pour exemple.org. Les autres clients compatibles avec acme-dns (lego, Traefik, cert-manager…) n’ont pas été testés ; seul acme.sh l’a été.