Wie überwache ich ablaufende Zertifikate?

Ab Tarif Pro

Kurzantwort

Notory sortiert die Zertifikatsliste automatisch nach Gültig bis. Das am ehesten ablaufende Zertifikat steht oben. Zusätzlich trägt jedes Zertifikat einen Status (Aktiv, Läuft bald ab, Abgelaufen, Widerrufen), der als Kennzeichen sichtbar ist. So erkennst du anstehende Abläufe auf einen Blick.

Voraussetzungen

Teil des Zertifikate-Moduls und damit ab Tarif Pro verfügbar (Feature certificates).

Modul „Zertifikate” öffnen. Die Liste ist nach Gültig bis aufsteigend sortiert. Ganz oben stehen die Zertifikate mit dem nächsten Ablaufdatum.
Status-Kennzeichen lesen. Die Spalte Status zeigt je Zertifikat Aktiv, Läuft bald ab, Abgelaufen oder Widerrufen. Setze den Status beim Bearbeiten auf Läuft bald ab, um ein Zertifikat aktiv zu markieren.

Screenshot ausstehend zertifikate-ablauf-01 Zertifikate-Liste nach 'Gültig bis' sortiert, mit Status-Kennzeichen 'Läuft bald ab' und 'Abgelaufen'

Die nach Ablauf sortierte Liste mit Status-Kennzeichen je Zertifikat.

Die Liste liefert GET /api/v1/certificates, bereits nach valid_to aufsteigend sortiert. Ideal, um im eigenen System eine Erinnerung zu bauen: valid_to mit dem heutigen Datum vergleichen.

curl -H "Authorization: Bearer inv_dein_token" \
  https://demo.notory.io/api/v1/certificates

Antwort HTTP 200 OK (Auszug, das am ehesten ablaufende Zertifikat zuerst):

[
  {
    "id": "c4e8b2a1-6f37-4d90-8b52-1a7c3e9d0f68",
    "common_name": "www.example.com",
    "issuer": "Let's Encrypt R3",
    "valid_to": "2026-07-30T00:00:00Z",
    "status": "expiring_soon",
    "auto_renew": true
  },
  {
    "common_name": "vpn.example.com",
    "valid_to": "2026-11-15T00:00:00Z",
    "status": "active",
    "auto_renew": false
  }
]

Um den Status zu setzen, sendest du ein PUT mit dem Feld status:

curl -X PUT https://demo.notory.io/api/v1/certificates/c4e8b2a1-6f37-4d90-8b52-1a7c3e9d0f68 \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{ "status": "expiring_soon" }'

Status-Werte: active (Aktiv), expiring_soon (Läuft bald ab), expired (Abgelaufen), revoked (Widerrufen).

Was passiert dabei?

Serverseitige Sortierung: GET /certificates liefert immer nach valid_to aufsteigend, anstehende Abläufe zuerst, ohne dass du selbst sortieren musst.
Status ist gespeichert, nicht berechnet: active/expiring_soon/expired/ revoked sind Werte, die du setzt. Es gibt keinen Hintergrundjob, der den Status automatisch anhand von valid_to umstellt.
Keine E-Mail, kein Webhook: Für ablaufende Zertifikate versendet Notory keine Benachrichtigung. Baue Erinnerungen bei Bedarf über einen periodischen Abruf von GET /certificates (Vergleich valid_to gegen das aktuelle Datum).
Audit-Trail: Eine Statusänderung wird als updated_by/updated_at protokolliert.
Mandanten-Isolation: Es werden nur Zertifikate deines Mandanten gelistet.