Ajouter un domaine
Un domaine géré est un nom de base — home.example.com — sous lequel local-cert a le droit d'émettre. Il s'appuie sur une zone hébergée d'un provider. L'assistant de la page Domaines fait tout en trois écrans.
Avant de commencer
- Un provider enregistré, dont le test est au vert.
- Une zone publique chez cet hébergeur, qui fait autorité pour le nom. Let's Encrypt doit pouvoir lire l'enregistrement de validation depuis Internet : une zone privée ne convient pas, même si vos hôtes, eux, restent privés.
1. Choisir le provider
+ ajouter un domaine, puis sélectionnez le provider. local-cert interroge le compte et affiche le nombre de zones visibles.
2. Choisir la zone
Les zones du compte sont listées avec leur identifiant. Une zone privée est grisée. Si une zone porte déjà un domaine géré, il est indiqué.
- Nom de base : par défaut le nom de la zone. Vous pouvez le restreindre à un sous-domaine (
lab.home.example.comdans la zonehome.example.com) : seuls les noms situés dessous pourront recevoir un certificat. - TTL par défaut : durée de vie des enregistrements que local-cert publie. 60 secondes conviennent.
3. Donner les droits, tester, ajouter
local-cert teste immédiatement ses droits sur la zone. S'ils sont déjà là, il ne reste qu'à confirmer. Sinon l'écran affiche quoi faire :
- Dans la console AWS, ouvrez le rôle (ou l'utilisateur) indiqué → onglet Permissions.
- Cliquez sur la politique déjà existante,
local-cert-route53— celle créée avec le provider — puis Edit → onglet JSON. N'ajoutez pas une seconde politique : c'est celle-ci qu'on fait évoluer. - Remplacez tout le contenu par le document affiché, puis Next → Save changes. Il contient les zones déjà déclarées sur ce provider plus la nouvelle : rien n'est retiré.
- Revenez dans l'assistant et cliquez Retester.
- Quand toutes les lignes requises sont à
OK, Ajouter le domaine.
Ajouter sans attendre : le statut « en attente »
Un hébergeur peut mettre quelques minutes à appliquer un changement de droits. Plutôt que de retester à la main, ajoutez le domaine alors que le test échoue encore (bouton Ajouter en attente) :
- le domaine est en attente : local-cert refait le test chaque minute, cinq fois, et le passe actif dès qu'il réussit ;
- après cinq échecs il passe en erreur, avec le dernier refus affiché. Corrigez les droits, puis cliquez relancer la vérification : un nouveau cycle démarre ;
- tant qu'il n'est pas actif, le domaine ne reçoit ni certificat ni enregistrement : l'API répond
409et le serveur ACMErejectedIdentifier.
Ce que vérifie le test
| Appel | Requis | Sert à |
|---|---|---|
ListResourceRecordSets | oui | lire la zone, et vérifier qu'elle couvre le nom de base |
GetHostedZone | oui | trouver les serveurs de noms à interroger pendant la validation |
GetChange | oui | attendre la propagation d'une écriture |
ChangeResourceRecordSets (TXT) | oui | écrire l'enregistrement de validation |
ChangeResourceRecordSets (A) | non | publier l'adresse d'un hôte, si vous le demandez à l'émission |
Le droit d'écriture est sondé par la suppression d'un enregistrement qui n'existe pas : AWS vérifie l'autorisation avant de constater qu'il n'y a rien à supprimer. La zone n'est jamais modifiée par le test.
Si le test reste rouge
- Attendez quelques secondes et retestez : IAM ne propage pas instantanément.
- Vérifiez que la politique a été collée sur l'identité indiquée, et pas sur l'utilisateur alors que le provider passe par un rôle.
- Si toutes les lignes échouent sur le même message, c'est le provider lui-même : bouton tester dans Providers.
- Si un enregistrement
CAAexiste sur la zone, il doit autoriserletsencrypt.org— le test ne le vérifie pas, mais l'émission échouera.
Ajouter quand même enregistre un domaine dont le test échoue. Utile pour préparer une configuration ; aucune émission n'aboutira tant que les droits manquent.
Ensuite
- Donnez accès au domaine dans Clés & droits : une clé d'API avec ses droits, ou un identifiant EAB pour un client ACME.
- Émettez un premier certificat : Démarrage rapide.
Retirer un domaine
retirer est refusé tant que des certificats existent. forcer les révoque, nettoie la zone autant que possible, puis supprime le tout. Pensez ensuite à régénérer la politique du provider (bouton politique) et à la recoller dans AWS : la zone retirée n'y figure plus.