Badges de certificat TLS pour votre README

Cinq badges SVG dynamiques pour n’importe quel domaine : la note globale de santé des signatures, le compte à rebours avant l’expiration du certificat, la version de TLS négociée, la clé du certificat et la préparation post-quantique. Choisissez-en un, appliquez-lui un style, copiez l’extrait de code (Markdown, HTML ou reStructuredText). Ni compte, ni jeton, ni étape de build.

DomaineLibellé personnalisé – facultatif, 32 caractères au maximum

Style

Essayez :

Choisissez un badge

Chaque aperçu ci-dessous est le rendu actuel de votre domaine par le point de terminaison réel.

Note de santé des signaturessignature health | ALa note globale de A+ à F issue du rapport complet : chaîne, clé, protocole et durée de vie réunis./api/badge/yourdomain.comExpiration du certificatcert expires | dans 34 joursLes jours restants sur le certificat feuille, en orange à moins de 30 jours et en rouge à moins d’une semaine./api/badge/yourdomain.com/expiryVersion de TLStls | 1.3La version du protocole qu’un client moderne négocie réellement avec votre serveur./api/badge/yourdomain.com/tlsClé du certificatcert key | ECDSA P-256La clé publique que certifie votre certificat : courbe ECDSA, taille de la clé RSA, Ed25519 ou ML-DSA./api/badge/yourdomain.com/keyPréparation post-quantiquepost-quantum | pas encoreIndique si le certificat signe déjà avec un algorithme post-quantique. Pour un certificat classique, le badge affiche « pas encore »./api/badge/yourdomain.com/pqc

Copiez-le dans votre README

Saisissez un domaine ci-dessus pour afficher les extraits de code ici.

Les cinq badges

« Tout copier en Markdown » utilise le libellé par défaut de chaque badge et le style sélectionné ci-dessus : cinq lignes, prêtes à coller sur une rangée.

L’intérêt d’un badge dans un README

Il reste à jour tout seul

Le badge est un SVG généré à partir d’une analyse récente et mis en cache pendant une heure, pas un instantané que vous avez collé une fois pour toutes. Renouvelez un certificat, passez à ECDSA, activez TLS 1.3 : le badge suit dans l’heure, sans job de CI ni jeton.

C’est une vérification que d’autres peuvent refaire

Chaque badge renvoie au rapport complet sur ecdsa.com/health/<votre domaine> : un lecteur peut ainsi voir exactement ce qui a été mesuré (chaîne, algorithmes, versions du protocole, durées de vie) au lieu de croire la couleur sur parole.

Il repère tôt la panne la plus banale

Un badge d’expiration qui vire à l’orange dans votre propre README est un rappel permanent et peu coûteux : le certificat doit être renouvelé avant qu’il ne mette le site hors service un week-end.

Fonctionnement des points de terminaison

Chaque badge est un simple GET sur https://ecdsa.com/api/badge/<domain> suivi d’un suffixe de type (/expiry, /tls, /key, /pqc), et la réponse est un SVG. Deux paramètres de requête facultatifs : ?style=for-the-badge pour la variante haute en majuscules et ?label=Your%20text pour remplacer la légende de gauche.

Les résultats sont mis en cache pendant une heure : un README très consulté ne coûte donc à votre serveur qu’un handshake par heure, et non un par visiteur. Un domaine injoignable produit un badge gris unreachable plutôt qu’une image cassée : le badge ne transforme jamais votre README en page d’images manquantes.

Vous voulez d’abord comprendre la logique de la note ? Lancez la vérification complète sur Signature Health des domaines, ou lisez ECDSA face à RSA pour savoir pourquoi un badge de clé affiche ce qu’il affiche.