Zum Inhalt springen
ecdsa.com

TLS-Zertifikats-Badges für dein README

Fünf Live-SVG-Badges für jede Domain: die Gesamtbewertung der Signature Health, der Countdown bis zum Zertifikatsablauf, die ausgehandelte TLS-Version, der Zertifikatsschlüssel und die Post-Quanten-Bereitschaft. Wähle eines aus, passe den Stil an, kopiere das Snippet – Markdown, HTML oder reStructuredText. Kein Konto, kein Token, kein Build-Schritt.

Stil
Zum Ausprobieren:

Badge auswählen

Jede Vorschau unten zeigt, was der Live-Endpunkt gerade für deine Domain rendert.

Kopiere es in dein README

Gib oben eine Domain ein, dann erscheinen die Snippets hier.

Alle fünf Badges

signature health | Acert expires | in 34 daystls | 1.3cert key | ECDSA P-256post-quantum | not yet

„Alle als Markdown kopieren“ verwendet die Standardbeschriftung jedes Badges und den oben gewählten Stil – fünf Zeilen, bereit zum Einfügen als Reihe.

Wozu überhaupt ein Badge im README

Es bleibt von selbst aktuell

Das Badge ist ein SVG, das aus einem frischen Scan erzeugt und eine Stunde lang zwischengespeichert wird – kein Schnappschuss, den du einmal eingefügt hast. Erneuere ein Zertifikat, steig auf ECDSA um, schalte TLS 1.3 ein – das Badge zieht innerhalb einer Stunde nach, ohne CI-Job und ohne Token.

Es ist eine Prüfung, die andere wiederholen können

Jedes Badge verlinkt auf den vollständigen Bericht unter ecdsa.com/health/<deine Domain>. So sieht, wer das README liest, genau, was gemessen wurde – Kette, Algorithmen, Protokollversionen, Laufzeiten –, statt sich blind auf die Farbe zu verlassen.

Es fängt den langweiligen Fehler früh ab

Ein Ablauf-Badge, das in deinem eigenen README auf Gelb umspringt, ist eine einfache, dauerhafte Erinnerung daran, dass das Zertifikat erneuert werden muss, bevor es am Wochenende die Website lahmlegt.

So funktionieren die Endpunkte

Jedes Badge ist eine einfache GET-Anfrage an https://ecdsa.com/api/badge/<domain> mit einem Typ-Suffix dahinter – /expiry, /tls, /key, /pqc – und liefert ein SVG zurück. Zwei optionale Query-Parameter: ?style=for-the-badge für die hohe Variante in Großbuchstaben und ?label=Your%20text, um die linke Beschriftung zu ersetzen.

Ergebnisse werden eine Stunde lang zwischengespeichert, daher kostet ein viel besuchtes README deinen Server einen Handshake pro Stunde, nicht einen pro Besuch. Für eine nicht erreichbare Domain erscheint ein graues Badge unreachable statt eines kaputten Bildes – das Badge macht dein README nie zu einer Seite voller fehlender Bilder.

Willst du zuerst die Begründung hinter der Bewertung sehen? Führe die vollständige Prüfung bei Signature Health für Domains aus, oder lies ECDSA vs. RSA, um zu verstehen, warum ein Schlüssel-Badge so aussieht, wie es aussieht.