Erneuerung
| Fall | Wann | Was passiert |
|---|
| Zertifikat auf dem Ziel läuft vor dem nächsten Zyklus ab | Sobald das Zertifikat auf einem Ziel vor dem nächsten Zyklus abläuft. | Erneuert und verteilt sofort. Gibt es bereits ein neueres Zertifikat, verteilt TLSPilot nur dieses. Die Spalte zeigt Renew & Deploy: und den Zeitpunkt, in Orange. |
| CA zieht das ARI-Fenster vor | Wenn die CA das Fenster vorzieht. | Renew immediately on CA emergency ON: erneuert und verteilt sofort. OFF: speichert einen neuen zufälligen Zeitpunkt im ersten Zehntel des neuen Fensters, erneuert dann und verteilt im nächsten Zyklus. |
| Force renew, Renew über API / CLI / PowerShell | Wenn Sie es starten. Ein Renew ohne Force stellt nur aus, wenn das Zertifikat fällig ist. | Erneuert und verteilt sofort. |
| Neues Zertifikat | Mit Issue now sofort, mit Next cycle im nächsten Zyklus. | Stellt das Zertifikat aus und verteilt es. |
| Manuelles DNS-01 | Beim Start der Bestellung; prüft den TXT-Eintrag alle 15 Minuten. | Sendet die TXT-Einträge beim Start der Bestellung an den Mail-Kanal, eine Erinnerung bei der unter Reminder (remaining lifetime) eingestellten Restlaufzeit und danach alle 24 Stunden. Die Spalte zeigt Waiting und den Zeitpunkt der nächsten Prüfung. |
| Enterprise CA wartet auf Genehmigung | In jedem Zyklus. | Die Spalte zeigt Waiting for CA approval. Das ist kein Fehler und löst keinen Fehler-Alert aus. Der Zyklus fragt die CA erneut an. Nach der Genehmigung verteilt der nächste Zyklus. |
Deployment
| Fall | Wann | Was passiert |
|---|
| Deployment schlägt fehl | Während eines Deployments. | Sendet Failed deploy. Es gibt keinen erneuten Test. Der nächste Zyklus versucht es erneut. |
| Zertifikat ist belegt | Wenn eine andere Operation auf demselben Zertifikat läuft. | Jedes Zertifikat hat seine eigene Sperre; die anderen bleiben nutzbar. Die Spalte zeigt Renewal in progress, Health check in progress oder Deployment in progress, in Blau. |
| Custom Deployment ohne Health-Check-Skript | In jedem Zyklus. | Verteilt nur, wenn das Ziel nicht das aktuelle Zertifikat hat. Drift lässt sich nicht erkennen. |
Zyklus
| Fall | Wann | Was passiert |
|---|
| Run deployment & health cycle now | Wenn Sie es starten. | Führt denselben Zyklus sofort aus. Für Alerts zählt er als Aktion, die Sie starten, siehe Kapitel Alerts. |
| Run deployment & health cycle now während ein Zyklus läuft | Wenn Sie es starten. | Die Anforderung wird abgelehnt. |
| Zertifikat ist während des Zyklus belegt | Eine andere Operation hält die Sperre des Zertifikats. | Der Zyklus versucht dieses Zertifikat nach 30 Sekunden erneut, bis zu 20 Mal. Der Alert Cycle finished with failures wartet auf diese Wiederholungen. |
| Lizenz abgelaufen | Zur Uhrzeit des Zyklus. | Der Zyklus wird übersprungen (Event 1106). |
Health, Drift und Manual check needed
| Fall | Wann | Was passiert |
|---|
| Drift im Zyklus | Health-Check im Zyklus. | Verteilt das aktuelle Zertifikat und prüft danach die Health nach dem Deployment. |
| Unknown im Zyklus | Das Ziel hat das aktuelle Zertifikat. | Kein Deployment. Sendet Deploy warnings. |
| Unreachable im Zyklus | Health-Check im Zyklus. | Kein Deployment. Vor der Erneuerungsschwelle des Zertifikats auf dem Ziel: Deploy warnings. Ab der Schwelle oder abgelaufen: Failed deploy. |
| Nie verteilt | Im Zyklus. | Verteilt, ausser das Ziel ist nicht erreichbar. |
| Drift bleibt nach dem erneuten Test | 60 Sekunden nach einem Deployment. | Setzt Manual check needed und sendet Deploy warnings. |
| Unreachable beim erneuten Test | 60 Sekunden nach einem Deployment. | Keine Markierung und kein Alert aus dieser Prüfung. Das Ergebnis wird als Health des Deployments gespeichert. |
| Vorheriger Zustand nicht vollständig wiederhergestellt | Ein Deployment meldet, dass es den vorherigen Zustand nicht vollständig wiederherstellen konnte. | Setzt sofort Manual check needed, ohne erneuten Test, und sendet Deploy warnings. |
| Manual check needed im Zyklus | In jedem Zyklus, auch bei Run deployment & health cycle now. | Genau ein Deployment-Versuch, ohne vorherigen Health-Check, danach der Health-Check mit seinem erneuten Test nach 60 Sekunden. Healthy hebt die Markierung auf. Andernfalls bleiben die Markierung und der Alert Deploy warnings bestehen, und der nächste Zyklus versucht es erneut. Der Versuch im Zyklus hebt die Markierung nicht vorher auf. |
| Von Ihnen gestartetes Deployment | Wenn Sie verteilen. | Hebt Manual check needed vor dem Versuch auf. Danach der Health-Check mit seinem erneuten Test nach 60 Sekunden, wie im Zyklus. |
Backstop und Rettung vor dem Ablauf
| Fall | Wann | Was passiert |
|---|
| Backstop | In jedem Zyklus. | Erneuert eine überfällige oder fehlgeschlagene Erneuerung, fragt bei einer Enterprise-CA-Anforderung, die auf Genehmigung wartet, erneut nach und setzt eine manuelle DNS-01-Bestellung fort, die auf ihren TXT-Eintrag wartet. Eine Erneuerung aus dem Backstop wird im selben Zyklus verteilt. |
| Neueres Zertifikat vorhanden, Deployment schlägt fehl | Ein Ziel hat ein Zertifikat, das vor dem nächsten Zyklus abläuft, ein neueres Zertifikat ist vorhanden, und die Versuche sind nicht ausgeschöpft. | Verteilt das neuere Zertifikat sofort. Schlägt das fehl, versucht es TLSPilot nach 15 Minuten erneut. |
| Rettung vor dem Ablauf nach ausgeschöpften Versuchen | Die Versuche sind ausgeschöpft, und ein aktives Ziel hat ein Zertifikat, das abgelaufen ist oder vor dem nächsten Zyklus abläuft. | Genau ein sofortiger Versuch: Renew & Deploy oder nur ein Deployment, wenn bereits ein neueres Zertifikat vorhanden ist. Ein Erfolg setzt den Wiederholungszustand zurück. Schlägt er fehl, gibt es bis zum nächsten Zyklus keinen weiteren Versuch, auch nicht nach einem Neustart des Dienstes; danach übernimmt der Backstop. Manuelle DNS-01-Bestellungen und Enterprise-CA-Anforderungen, die auf Genehmigung warten, lösen ihn nicht aus. |
Neustart des Dienstes
| Fall | Wann | Was passiert |
|---|
| Verpasste Erneuerung | Kurz nach dem Start des Dienstes. | Eine Erneuerung, deren gespeicherter Zeitpunkt verstrichen ist, läuft sofort, ohne neuen Zeitpunkt. Sie verteilt im nächsten Zyklus, ausser ein Fall aus Kapitel Wann Erneuerung und Deployment gemeinsam laufen greift. |
| Verpasster Zyklus | Nach dem Start des Dienstes. | Wird nicht wiederholt. Der nächste Zyklus läuft zur nächsten eingestellten Uhrzeit. |
| Verpasster Wochenbericht | Nach dem Start des Dienstes. | Ist der Zeitpunkt des Wochenberichts verstrichen, während der Dienst gestoppt war, wird der Bericht einmal gesendet, auch nach mehreren verpassten Wochen. Er umfasst die sieben Tage ab dem Sendezeitpunkt. |
| Health | Nach dem Start des Dienstes. | Kein Health-Check beim Start. Der gespeicherte Health-Zustand bleibt erhalten. |
Alerts
Jeder Alert wird nur gesendet, wenn sein Eintrag unter Notify On in einem aktiven Alert-Profil eingeschaltet ist. Trigger: Cycle umfasst den Zyklus und die übrigen automatischen Aufgaben. Mit Cycle and Manual meldet das Profil auch Aktionen, die Sie selbst starten, zum Beispiel Renew, Deploy, einen Health-Check oder Run deployment & health cycle now. Die Spalte Trigger zeigt, welche Einstellung ein Fall braucht.
| Alert (Notify On) | Wann er gesendet wird | Trigger |
|---|
| Failed issue / renew | Der erste Fehlschlag einer Erneuerung sofort. Wiederholungen senden nichts. Sind die Versuche ausgeschöpft, ein Alert. Danach meldet der Backstop höchstens einmal pro Tag (UTC). Eine erfolgreiche Erneuerung setzt das zurück; der Zustand übersteht einen Neustart. | Cycle. Eigene Aktionen: Cycle and Manual. |
| Successful issue / renew | Nach einer erfolgreichen Ausstellung oder Erneuerung. | Cycle. Eigene Aktionen: Cycle and Manual. |
| Successful deploy, Failed deploy | Nach einem Deployment. Höchstens ein Deployment-Alert pro Ziel und Zyklus. | Cycle. Eigene Aktionen: Cycle and Manual. |
| Deploy warnings | Aus dem Zyklus (Unknown, Unreachable vor der Schwelle, vorheriger Zustand nicht vollständig wiederhergestellt, Manual check needed bleibt bestehen) und wenn Drift nach dem erneuten Test bleibt. | Cycle. Eigene Aktionen: Cycle and Manual. |
| Failed health check | Nur nach einem Health-Check, den Sie starten: Drift oder Unknown sofort. Unreachable sendet Deploy warnings, solange sich das Zertifikat auf dem Ziel vor der Erneuerungsschwelle befindet, und Failed deploy ab der Schwelle oder wenn es abgelaufen ist, sofern dieser Eintrag eingeschaltet ist; andernfalls Failed health check, wenn die aufeinanderfolgenden Unreachable-Ergebnisse Failures before notify erreichen (Standard 2). | Nur Cycle and Manual. Automatische Prüfungen senden ihn nie. |
| Certificate expiring soon | Nach einem Zyklus, für das Zertifikat auf den Zielen, ab der Mitte seines Erneuerungsfensters, einmal pro Zertifikatsversion. | Cycle. Run deployment & health cycle now: Cycle and Manual. |
| Cycle finished with failures | Nach einem Zyklus mit fehlgeschlagenen Deployments oder Health-Checks. Eine Erfolgszusammenfassung gibt es nicht. | Cycle und Cycle and Manual, auch für Run deployment & health cycle now. |
Mail-Kanäle senden höchstens 10 Alert-Mails pro Minute. Weitere Mails warten und gehen später hinaus; die Empfänger der aktiven Alert-Profile erhalten den Hinweis Alert emails are throttled. Andere Kanaltypen werden nicht gedrosselt.
