Alerts erstellen

Ein Alert-Profil legt fest, wann TLSPilot eine Benachrichtigung verschickt, an wen und über welchen Kanal.

1. Klicken Sie auf dem Tab Alerts auf Add… und geben Sie einen Name für das Alert-Profil ein, zum Beispiel «Message to owner».
2. Type und Channel: Wählen Sie den Typ und den konfigurierten Kanal.
3. Recipients (comma-separated): Beim Typ Mail geben Sie die Empfänger ein. Mit aktiviertem RBAC können Sie zusätzlich oder stattdessen Send alert to service owner einschalten, um die in der Dokumentation des Zertifikats oder Deployments festgelegten Service Owner zu benachrichtigen, siehe Kapitel Private CA (PC); ohne RBAC erhalten die Service Owner immer eine Kopie. Ist ein Service Owner eine Gruppe, wird die E-Mail-Adresse der Gruppe benachrichtigt. Werden nur Service Owner benachrichtigt, stehen die Systemereignisse (Lizenz, Dienst, Zyklus und Backup) nicht zur Verfügung. Tenants… erscheint nur, wenn Ihre Lizenz Tenants enthält.
4. Conditions: Klicken Sie auf Tenants…, um den Alert auf bestimmte Tenants zu beschränken. Wählen Sie Cycle, um nur über den täglichen Zyklus benachrichtigt zu werden, oder Cycle and Manual, um auch manuell in der Desktop Admin Console oder der WebUI gestartete Aktionen einzubeziehen, zum Beispiel Check Now in einem Deployment und Health Check… bei einem Zertifikat. Ein Health-Check nach einem Deployment und eine Prüfung nach dem Aktivieren oder Kopieren eines Deployments lösen kein Failed health check aus. Bleibt Drift beim erneuten Test 60 Sekunden nach einem Deployment bestehen, wird der Alert Deploy warnings gesendet.

5. Notify On: Schalten Sie die Ereignisse ein, über die Sie benachrichtigt werden wollen. Die Ereignisse sind gruppiert: Certificate mit Successful issue / renew, Failed issue / renew, Successful revoke / roll back, Failed revoke / roll back und Certificate expiring soon; Health mit Failed health check; Deployment mit Successful deploy, Deploy warnings und Failed deploy; System mit Backup failed, External credential resolve failed, Service failed, Cycle finished with failures, License expiring soon (mit Days before expiry) und License issues. Die System-Ereignisse betreffen den ganzen Host. Unter Failures before notify legen Sie fest, nach wie vielen aufeinanderfolgenden Unreachable-Ergebnissen eines von Ihnen gestarteten Health-Checks Sie benachrichtigt werden, standardmässig 2, damit ein einzelnes Unreachable-Ergebnis keinen Alert auslöst. Die Schalter Successful deploy, Deploy warnings und Failed deploy steuern die Benachrichtigungen zu Deployments.
   • Certificate expiring soon: Nur der tägliche Zyklus und Run deployment & health cycle now werten dieses Ereignis aus. Run deployment & health cycle now gilt als manuell und benachrichtigt deshalb nur Profile mit Cycle and Manual. Eine Einstellung in Tagen gibt es nicht: Der Schwellenwert folgt dem Erneuerungsfenster jedes Zertifikats. Bei ACME-Zertifikaten, deren CA ARI anbietet, ist das das Fenster der CA; bei Enterprise-CA-Zertifikaten mit Follow template renewal period die Erneuerungsperiode der Vorlage; sonst das Erneuerungsfenster des Zertifikats, das TLSPilot auf etwa ein Drittel der Gültigkeit, höchstens 30 Tage, voreinstellt, zum Beispiel bei Private-CA-Zertifikaten. TLSPilot benachrichtigt Sie, wenn ein Zertifikat die Mitte dieses Fensters überschritten hat und nicht erneuert wurde, zum Beispiel 15 Tage vor Ablauf bei einem 90-Tage-ACME-Zertifikat mit 30-Tage-Fenster oder 8 Stunden vor Ablauf bei einem 48-Stunden-Private-CA-Zertifikat mit 16-Stunden-Fenster. Eine normale Erneuerung erfolgt zu Beginn des Fensters; dieser Alert bedeutet also, dass die Erneuerung in der ersten Hälfte nicht gelungen ist. Sie werden einmal pro Zertifikatsversion benachrichtigt. Issue now, Force renew…, Deployments und Health-Checks lösen dieses Ereignis nie aus.
   • Ergebnisse von Health-Checks: Das gilt für Health-Checks, die Sie mit Cycle and Manual starten; automatische Prüfungen senden nie Failed health check. Drift oder Unknown sendet Failed health check. Bei Unreachable sendet TLSPilot Deploy warnings, solange sich das Zertifikat auf dem Ziel vor der Erneuerungsschwelle befindet, und Failed deploy ab der Schwelle oder nach seinem Ablauf, sofern dieser Eintrag eingeschaltet ist. Andernfalls sendet Unreachable Failed health check, wenn die Anzahl aufeinanderfolgender Unreachable-Ergebnisse Failures before notify erreicht. Eine Prüfung sendet eine Benachrichtigung pro Ziel.
   • Eine Benachrichtigung pro Aktion: Jede Aktion an einem Zertifikat, zum Beispiel eine Ausstellung oder Erneuerung, und jede Aktion an einem Deployment löst pro Alert-Profil eine Benachrichtigung aus.

6. Klicken Sie auf OK und dann auf Save.

Sie können jedes Alert-Profil einzeln aktivieren oder deaktivieren.

Wochenbericht

Unter Weekly report unterhalb der Alert-Profile sendet TLSPilot einmal pro Woche den Upcoming week report per Mail: eine PDF-Datei mit den für die kommenden sieben Tage geplanten Erneuerungen und Deployments. Der Abschnitt befindet sich auf dem Tab Alerts in der Desktop Admin Console und in der WebUI, siehe Abbildung Wochenbericht auf dem Tab Alerts in den Einstellungen.

Standardmässig ist der Bericht auf Disabled gesetzt. Stellen Sie den Schalter auf Enabled, füllen Sie die folgenden Felder aus und klicken Sie auf Save:

• Weekday: Montag bis Sonntag, standardmässig Montag.
• Time: eine volle Stunde von 00:00 bis 23:00, standardmässig 08:00. Wochentag und Uhrzeit sind die Ortszeit des Management-Hosts.
• Recipients: eine oder mehrere E-Mail-Adressen, getrennt durch ein Semikolon (;).
• Mail channel: ein Kanal vom Typ Mail, siehe Kapitel Alert-Kanäle konfigurieren.

Der Bericht umfasst die sieben Tage ab dem Zeitpunkt, zu dem er gesendet wird. Verstreicht der Sendezeitpunkt, während der Management Service gestoppt ist, sendet TLSPilot den Bericht einmal beim nächsten Start. Schlägt das Senden fehl, versucht es TLSPilot nach 5 Minuten erneut. Die Mail verwendet das Standardlayout der Alert-Mails mit einem neutralen Band mit dem Titel Upcoming week report und enthält den Bericht als Upcoming-week-report.pdf.

Um den Bericht jederzeit zu erstellen, wählen Sie Tools, Upcoming week report in der Desktop Admin Console, die das PDF öffnet, oder in der WebUI, die es herunterlädt. Der Bericht hat A4-Seiten im Querformat (siehe Abbildung Beispiel eines Wochenberichts (Ausschnitt)):

• Die Kennzahlen Renewals, Deployments, Expiring und Not healthy.
• Needs attention, nur wenn es Einträge gibt, zum Beispiel fehlgeschlagene Erneuerungen und Deployments mit Drift oder Unreachable.
• Schedule: eine Tabelle mit den Spalten Time, Action, Certificate, Issuer, Deployment target und Tenant. Ein hellgraues Band zeigt jeden Tag mit dem Wochentag und dem Datum im kurzen Datumsformat des Hosts; die Zeilen darunter zeigen nur die Uhrzeit. Eine Erneuerung zeigt ihren geplanten Zeitpunkt oder die Zeitspanne, solange TLSPilot den Zeitpunkt noch nicht festgelegt hat; eine Wiederholung zeigt den Zeitpunkt der nächsten Wiederholung. Eine Erneuerung, die im selben Lauf verteilt wird, ist eine Zeile Renew & Deploy, mit ihren Deployment-Zielen untereinander.
• Statistics auf der letzten Seite, mit den Diagrammen Certificates by issuer und Deployments by target type. Bei mehr als acht Ausstellern oder Zieltypen zeigt ein Diagramm die sieben grössten und fasst den Rest als Other zusammen.

Die Fusszeile lautet Scheduled operations only. Times in, gefolgt von der Zeitzone des Hosts als Standardname und UTC-Offset, zum Beispiel UTC (UTC+00:00).