Documentation Automate Certificates

Émettre et renouveler

Automate Certificates demande les certificats à Let's Encrypt via ACME v2. Cette page suit un certificat de la demande au renouvellement.

Demander un certificat

  1. Vérifiez qu'un compte ACME est enregistré dans Paramètres.
  2. Sur la page Certificats, demandez un certificat et saisissez un ou plusieurs noms de domaine.
  3. Choisissez le type de clé : ECDSA-P256 (par défaut), ECDSA-P384, RSA-2048 ou RSA-4096.
  4. Choisissez le type de challenge : dns-01 (par défaut) ou http-01.

Un nom générique tel que *.example.com ne peut être validé qu'avec DNS-01. Pour conserver votre propre clé privée, envoyez une demande de signature de certificat PEM via l'API ; ses domaines doivent correspondre à la demande.

Challenges DNS-01

Avec DNS-01, le certificat reste à l'état d'émission et la page affiche les enregistrements TXT à publier. Publiez-les dans un délai de 24 heures. Les enregistrements sont vérifiés toutes les 5 minutes, et l'émission se termine d'elle-même dès qu'ils sont visibles. L'application n'écrit pas les enregistrements DNS à votre place dans l'application web. La résolution automatique via l'API Cloudflare n'existe que dans l'API et nécessite des identifiants Cloudflare ; sans eux, l'appel renvoie une erreur accompagnée d'une indication.

Challenges HTTP-01

Avec HTTP-01, l'application sert elle-même la réponse au challenge, et un renouvellement HTTP-01 ne demande aucune action de votre part.

Renouvellement

Déployer un certificat renouvelé

Déployez à la main avec Déployer sur la page Certificats. Pour déployer automatiquement chaque renouvellement, créez une règle ou une planification via l'API (POST /v1/automation/rules). Chaque exécution apparaît dans Déploiements.

Importer, révoquer et exporter

Vous pouvez importer un certificat existant, en révoquer un auprès de l'autorité de certification, et exporter un certificat au format PEM ou PFX. L'export d'une clé privée exige un administrateur et est consigné dans le journal d'audit.