Automate Certificates Dokumentation
Ausstellen und erneuern
Automate Certificates fordert Zertifikate über ACME v2 von Let's Encrypt an. Diese Seite begleitet ein Zertifikat von der Anforderung bis zur Erneuerung.
Zertifikat anfordern
- Stellen Sie sicher, dass unter Einstellungen ein ACME-Konto registriert ist.
- Fordern Sie auf der Seite Zertifikate ein Zertifikat an und geben Sie einen oder mehrere Domainnamen ein.
- Wählen Sie den Schlüsseltyp:
ECDSA-P256(Standard),ECDSA-P384,RSA-2048oderRSA-4096. - Wählen Sie den Challenge-Typ:
dns-01(Standard) oderhttp-01.
Ein Wildcard-Name wie *.example.com kann nur mit DNS-01 validiert werden. Um Ihren eigenen privaten Schlüssel zu behalten, senden Sie über die API eine PEM-Zertifikatsanforderung (CSR); deren Domains müssen zur Anforderung passen.
DNS-01-Challenges
Bei DNS-01 bleibt das Zertifikat im Status „Ausstellung“, und die Seite zeigt die zu veröffentlichenden TXT-Einträge. Veröffentlichen Sie sie innerhalb von 24 Stunden. Die Einträge werden alle 5 Minuten geprüft, und die Ausstellung schließt von selbst ab, sobald sie sichtbar sind. Die Web-App schreibt keine DNS-Einträge für Sie. Das automatische Lösen über die Cloudflare API gibt es nur in der API und es erfordert Cloudflare-Zugangsdaten; ohne sie liefert der Aufruf einen Fehler mit einem Hinweis.
HTTP-01-Challenges
Bei HTTP-01 liefert die App die Challenge-Antwort selbst aus, und eine HTTP-01-Erneuerung erfordert keine Aktion von Ihnen.
Erneuerung
- Ein geplanter Job startet jede Erneuerung 30 Tage vor dem Ablauf.
- Eine HTTP-01-Erneuerung läuft von selbst durch.
- Eine DNS-01-Erneuerung braucht jedes Mal neue TXT-Einträge. Die Workspace-Admins erhalten sie per E-Mail und auf der Seite Alerts, und ein Webhook-Ereignis wird gesendet.
- Eine fehlgeschlagene Erneuerung wird einmal täglich wiederholt. Jeder Fehler löst eine Warnung und ein Webhook-Ereignis mit der Ursache aus und wird im Audit-Log festgehalten.
Erneuertes Zertifikat bereitstellen
Stellen Sie von Hand mit Bereitstellen auf der Seite Zertifikate bereit. Um jede Erneuerung automatisch bereitzustellen, legen Sie über die API eine Regel oder einen Zeitplan an (POST /v1/automation/rules). Jeder Lauf erscheint unter Bereitstellungen.
Importieren, widerrufen, exportieren
Sie können ein vorhandenes Zertifikat importieren, eines bei der CA widerrufen und ein Zertifikat als PEM oder PFX exportieren. Der Export eines privaten Schlüssels erfordert einen Admin und wird im Audit-Log festgehalten.