Le baking des Open Badges expliqué : comment le JSON vit dans le PNG
Un Open Badge « baked » est un PNG dont le JSON de l’assertion est intégré comme métadonnée d’image. Le fichier du badge EST l’identifiant numérique. Comment fonctionne le baking et comment vérifier un badge baked.
Nacho founded Badges Ninja to make issuing verifiable digital credentials as simple as a single API call — Open Badge v2.0 badges and certificates, minted, hosted, and verifiable without standing up your own issuer infrastructure.
Téléchargez un Open Badge chez presque n’importe quel émetteur et vous obtenez un PNG d’apparence ordinaire. Déposez-le dans un chat, joignez-le à un e-mail, imprimez-le : il ressemble à n’importe quelle autre image. Pourtant, le fichier porte une seconde couche, invisible : l’identifiant numérique lui-même, écrit dans l’image sous forme de métadonnées. C’est ce que la communauté Open Badges appelle un badge baked (« cuit »), et c’est la raison pour laquelle un badge peut voyager sous la forme d’un seul fichier tout en prouvant qui l’a émis, à qui, et pour quoi.
Ce guide explique ce qu’est le baking, où les données se trouvent dans le fichier, comment un vérificateur les relit, et ce que vous devez décider en tant qu’émetteur d’identifiants. Vous n’avez pas besoin d’écrire du code pour utiliser des badges baked. Si vous émettez via https://badges.ninja, le baking se fait tout seul. Mais comprendre la mécanique vous aide à répondre aux questions que posent réellement les destinataires et les employeurs : « Cette image est-elle authentique ? » et « N’importe qui peut-il la copier ? »
Ce que signifie « baking »
Un Open Badge comporte deux éléments faciles à confondre :
- L’image. Le PNG ou le SVG que l’on voit sur un profil, une diapositive ou un certificat.
- L’assertion. Un petit document JSON qui énonce les faits : qui est le destinataire (sous forme d’identifiant haché), quelle classe de badge a été obtenue, qui l’a émise, quand, et où la vérifier.
Le baking consiste à écrire l’assertion dans l’image pour que les deux soient inséparables. Le résultat est un seul fichier. Remettez le PNG à quelqu’un et vous lui avez remis à la fois l’image et l’affirmation qui la sous-tend.
L’idée vient de la spécification Open Badges, développée à l’origine par Mozilla et désormais maintenue par 1EdTech. Le but de cette conception est la portabilité. Au début, les badges vivaient dans une seule plateforme, et les déplacer ailleurs impliquait de les téléverser à nouveau en espérant que les métadonnées survivent. Un fichier baked emporte ses propres métadonnées partout où il va.
Où se trouve le JSON dans un PNG
Un fichier PNG est une courte signature suivie d’une séquence de chunks (blocs). Chaque chunk comporte une longueur, un type de quatre lettres, des données et une somme de contrôle. Les visionneuses dessinent les pixels à partir des chunks IDAT et ignorent les types de chunks qu’elles ne comprennent pas. Cette tolérance rend le baking possible : vous pouvez ajouter un chunk rempli de texte, et chaque visionneuse d’images du monde affichera quand même l’image normalement.
Pour Open Badges 2.0, l’assertion est placée dans un chunk de texte portant le mot-clé openbadges. Les types de chunks de texte qui peuvent la contenir sont :
| Chunk | Encodage | Remarques |
|---|---|---|
tEXt | Latin-1 | Simple, mais limité aux caractères Latin-1. |
iTXt | UTF-8 | À privilégier, car les noms et descriptions ne sont souvent pas en ASCII. |
Quel que soit le chunk utilisé, la disposition suit la même idée : le mot-clé openbadges, un séparateur, puis la charge utile. Celle-ci est de l’un de deux types, selon le choix de l’émetteur :
- Le JSON de l’assertion lui-même. Le fichier est autodescriptif. Un vérificateur peut lire l’affirmation sans aucun appel réseau.
- Une URL qui pointe vers l’assertion hébergée. Le fichier est plus léger et l’émetteur peut garder l’enregistrement en ligne comme référence faisant autorité, par exemple pour montrer qu’un badge a été révoqué par la suite ou a expiré.
Il existe une troisième variante pour les badges signés, où la charge utile est un jeton signé plutôt que du JSON brut. Si les signatures comptent pour votre cas d’usage, lisez comment vérifier la signature d’un Open Badge.
Et le SVG ?
Les badges SVG peuvent aussi être baked, puisque le SVG est du XML. L’assertion est placée dans le fichier au sein d’un élément de l’espace de noms XML openbadges, et l’attribut verify contient l’URL de l’assertion hébergée. Le principe est le même qu’avec le PNG : les métadonnées voyagent à l’intérieur du fichier image. En pratique, la plupart des plateformes font du baking en PNG, car le PNG est accepté presque partout où l’on veut téléverser un badge.
À quoi ressemble l’assertion intégrée
Pour le format 2.0, une assertion hébergée est un JSON-LD qui relie le destinataire, la classe de badge et la méthode de vérification. Un exemple abrégé :
{
"@context": "https://w3id.org/openbadges/v2",
"type": "Assertion",
"id": "https://example.org/assertions/abc123",
"recipient": {
"type": "email",
"hashed": true,
"salt": "deadsea",
"identity": "sha256$c7ef86405ba71b85acd8e2e95166c4b111448089f2e1599f42fe1bba46e865c5"
},
"badge": "https://example.org/badges/data-analysis-101",
"issuedOn": "2026-05-14T00:00:00Z",
"verification": { "type": "hosted" }
}
Remarquez le destinataire. L’e-mail n’est pas stocké en clair : c’est un hachage SHA-256 salé. C’est important pour un fichier conçu pour circuler. Toute personne qui détient le PNG peut lire l’assertion, qui ne doit donc pas divulguer l’adresse du destinataire. Un vérificateur qui connaît déjà l’e-mail peut le hacher avec le même sel et vérifier la correspondance. Pour un tour de ce document champ par champ, consultez la présentation détaillée du JSON-LD d’un Open Badge.
Comment un vérificateur lit un badge baked
La vérification d’un badge baked est un processus court et mécanique :
- Ouvrez le PNG et parcourez ses chunks.
- Trouvez le chunk de texte portant le mot-clé
openbadges. - Lisez la charge utile. Si c’est du JSON, analysez-le. Si c’est une URL, récupérez-la.
- Vérifiez que l’assertion renvoie à la classe de badge et à l’émetteur attendus, et que l’identité du destinataire correspond à la personne qui le présente.
- Si le type de vérification est
hosted, confirmez que l’assertion hébergée existe toujours à l’URL de sonidet qu’elle n’a été ni révoquée ni expirée.
L’étape 5 est celle que l’on saute, et c’est elle qui rend un identifiant digne de confiance. Une copie intégrée n’est qu’un instantané. L’enregistrement hébergé est la source de vérité.
Le lire vous-même avec Node
Vous pouvez inspecter n’importe quel PNG avec un court script. Celui-ci parcourt les chunks et affiche la charge utile openbadges, en gérant tEXt comme iTXt :
import { readFileSync } from "node:fs";
import { inflateSync } from "node:zlib";
const png = readFileSync(process.argv[2]);
let pos = 8; // skip the 8-byte PNG signature
while (pos < png.length) {
const length = png.readUInt32BE(pos);
const type = png.toString("ascii", pos + 4, pos + 8);
const data = png.subarray(pos + 8, pos + 8 + length);
if (type === "iTXt" || type === "tEXt") {
const nul = data.indexOf(0);
const keyword = data.toString("latin1", 0, nul);
if (keyword === "openbadges") {
let text;
if (type === "tEXt") text = data.toString("latin1", nul + 1);
else {
const compressed = data[nul + 1] === 1;
let p = nul + 3; // skip compression flag + method
p = data.indexOf(0, p) + 1; // language tag
p = data.indexOf(0, p) + 1; // translated keyword
const body = data.subarray(p);
text = (compressed ? inflateSync(body) : body).toString("utf8");
}
console.log(text);
process.exit(0);
}
}
pos += 12 + length; // length + type + data + CRC
}
console.error("No openbadges chunk found: this PNG is not baked.");
process.exit(1);
Lancez-le avec node extract-badge.mjs my-badge.png. Si le fichier est baked, vous verrez du JSON ou une URL. Sinon, vous obtenez un simple message « not baked ». C’est un outil pédagogique, pas un validateur complet : il ne vérifie pas les sommes de contrôle des chunks, n’analyse pas les charges utiles signées et ne récupère pas l’enregistrement hébergé.
Si vous préférez ne pas écrire de code, un validateur de badges en ligne ou une visionneuse de métadonnées PNG affichera le même chunk. Le format est le standard : tout outil conforme lit tout badge conforme.
Pourquoi le baking compte
Portabilité. Un identifiant qui n’est qu’un PNG peut être envoyé par e-mail, téléversé sur une plateforme d’apprentissage ou conservé dans une archive personnelle. Aucun compte n’est nécessaire pour le transporter.
Un chemin de vérification qui survit au site marketing de l’émetteur. L’assertion intégrée nomme l’émetteur et pointe vers l’enregistrement hébergé : un vérificateur peut donc partir du seul fichier.
Des flux hors ligne et peu technologiques. Quand la charge utile est le JSON complet, un lecteur peut contrôler l’affirmation sur une machine sans réseau, puis vérifier l’enregistrement hébergé plus tard.
Une preuve difficile à falsifier à la légère. N’importe qui peut faire une capture d’écran d’un badge. Une capture n’a aucune métadonnée : elle ne peut donc pas être vérifiée comme fichier de badge. Cela suffit à distinguer un véritable identifiant d’une image copiée. Cela n’empêche pas quelqu’un de faire du baking d’une assertion falsifiée dans une image volée, et c’est pourquoi l’étape de vérification hébergée existe.
Les limites du baking
Soyez honnête avec vos destinataires sur ces points, car ils influencent la façon dont vous décrivez vos identifiants.
- Les métadonnées sont supprimées. De nombreux réseaux sociaux, optimiseurs d’images et applications de messagerie ré-encodent les fichiers téléversés et suppriment les chunks qui ne sont pas des pixels. Un badge baked publié sur un fil social n’est généralement plus baked. C’est normal, et c’est pourquoi un lien de vérification public compte à côté du fichier.
- Le baking ne prouve rien à lui seul. N’importe qui peut écrire du JSON intégré. La confiance vient de l’assertion hébergée sur le domaine de l’émetteur, ou d’une signature valide.
- Les modifications de l’image rompent le lien. Redimensionner ou réenregistrer dans un éditeur peut faire perdre le chunk.
- PNG et SVG uniquement. Le JPEG n’a pas de convention de chunk équivalente dans la spécification : un badge de type photo exporté en JPEG ne peut donc pas être baked de la manière standard.
La conclusion pratique : considérez le fichier baked comme un support pratique, et la page de vérification comme l’autorité. Si vous hésitez entre plusieurs formats pour votre programme, Open Badges vs certificats PDF explique pourquoi un identifiant lisible par machine l’emporte sur un document statique.
Comment fonctionne le baking sur https://badges.ninja
Quand vous attribuez un badge sur https://badges.ninja, la plateforme construit l’assertion Open Badge de ce destinataire et la fait « cuire » dans l’image du badge dans le cadre de l’émission. Vous n’avez aucun outil à configurer ni aucune commande à lancer. Le déroulement :
- Vous concevez le badge dans le concepteur visuel, ou vous téléversez votre propre image.
- Vous émettez une attribution, depuis le tableau de bord, depuis un import CSV pour les attributions en masse, ou via l’API.
- La plateforme crée l’assertion, la fait cuire dans le PNG et stocke le résultat avec l’attribution.
- Le destinataire reçoit une page de vérification publique à l’adresse
https://badges.ninja/awards/<awardId>, un certificat PDF, un code QR et une option Add to LinkedIn.
Si la conception du badge utilise des champs de fusion, comme le nom du destinataire, chaque attribution reçoit une image personnalisée, et c’est cette image personnalisée qui est baked.
Le baking est traité comme un complément de l’émission, pas comme une condition : si une image donnée ne peut pas être baked (par exemple une image de substitution dégénérée), l’attribution est tout de même émise avec l’image d’origine, et la page de vérification publique ainsi que le JSON-LD Open Badge ne sont pas affectés. L’image que vous téléversez doit aussi respecter une taille minimale : un minuscule canevas vide est donc rejeté avant d’atteindre la boulangerie.
Comme la page publique fait autorité, n’importe qui peut vérifier une attribution sans s’inscrire. Le JSON-LD Open Badge v2.0 lisible par machine d’une attribution est disponible à l’adresse https://api.badges.ninja/certify-badge/award/<awardId>.
Émettre une attribution par API
La plupart des lecteurs utiliseront le tableau de bord, mais si vous automatisez l’émission, une seule requête crée l’attribution (et l’image baked l’accompagne). Remplacez la clé et l’identifiant du badge par les vôtres :
const res = await fetch("https://api.badges.ninja/awards", {
method: "POST",
headers: { "X-Api-Key": "bws_YOUR_KEY_HERE", "Content-Type": "application/json" },
body: JSON.stringify({
badgeId: "your-badge-id",
recipient: { name: "Jane Smith", email: "jane@example.com" },
issuedOn: Date.now(),
}),
});
const { awardId } = await res.json();
const verifyUrl = `https://badges.ninja/awards/${awardId}`;
L’appel renvoie HTTP 200 avec { "awardId": "<guid>" }. Construisez l’URL de vérification à partir de cet identifiant. Pour la configuration des clés et la référence complète des requêtes, consultez la documentation de l’API Awards et le guide d’authentification.

Conseils pratiques pour les émetteurs
Publiez toujours un lien de vérification à côté du fichier. Placez le lien dans l’e-mail d’attribution, sur le certificat et sur toute page où le badge est affiché. Comme les plateformes sociales suppriment les métadonnées, c’est le lien qui garde l’identifiant vérifiable après le partage.
Utilisez une image source propre et de taille suffisante. Partez d’un PNG de dimensions réelles. Un badge conçu par un designer à une résolution normale est baked sans problème ; un espace réservé d’un pixel, non.
Ne modifiez pas le fichier livré. Dites aux destinataires de partager le téléchargement d’origine ou le lien de vérification, pas une capture d’écran recadrée.
Décidez de ce que vous voulez dire sur la révocation et l’expiration. Comme l’enregistrement hébergé fait autorité, un fichier baked peut survivre au statut de l’identifiant. Dites-le clairement dans la documentation de votre programme afin que les employeurs sachent consulter la page de vérification plutôt que de se fier au seul fichier.
Testez un badge de bout en bout. Émettez une attribution pour vous-même, téléchargez le PNG, passez-le dans le script ci-dessus ou dans un validateur public, puis ouvrez le lien de vérification. Cinq minutes de test vous montrent ce que vivront vos destinataires.

Questions fréquentes
Un badge baked est-il la même chose qu’un certificat numérique ? Non. Un certificat est généralement un PDF destiné à être lu et imprimé. Un badge baked est une image qui porte aussi des données d’identifiant lisibles par machine. https://badges.ninja produit les deux à partir de la même attribution.
Puis-je faire du baking sans plateforme ? Oui. La spécification est ouverte et des bibliothèques existent pour plusieurs langages. Le plus difficile est d’héberger l’assertion à une URL stable, ce qui donne tout son sens à la vérification. C’est la partie qu’une plateforme gère pour vous.
Le baking expose-t-il l’e-mail du destinataire ? Pas quand l’identité est hachée. L’assertion stocke un hachage salé : le fichier ne révèle donc pas l’adresse.
LinkedIn lira-t-il les données baked ? Le flux Add to Profile de LinkedIn repose sur le nom de l’identifiant, l’émetteur, la date et l’URL plutôt que sur les métadonnées du fichier. Consultez l’ajout d’un bouton Add to LinkedIn.
Résumé
Un Open Badge baked est un PNG (ou un SVG) dont l’identifiant est écrit dans un chunk de texte nommé openbadges. Il rend un badge portable et autodescriptif, mais la vraie confiance vient de l’assertion hébergée sur le domaine de l’émetteur. Faites du baking pour la portabilité, publiez un lien de vérification pour la confiance, et attendez-vous à ce que les réseaux sociaux suppriment les métadonnées.
Prêt à émettre votre premier identifiant vérifiable ? Commencez gratuitement sur badges.ninja — concepteur visuel, page de vérification publique, certificat PDF, sortie Open Badge v2.0. Aucune carte bancaire requise.
Comment cet article a été créé
Certains articles de ce blog sont rédigés avec l'aide d'un assistant IA, puis relus, vérifiés et édités par l'équipe Badges Ninja avant publication. Chaque exemple de code et chaque prix est vérifié sur le produit réel. Pour en savoir plus sur notre processus éditorial et d'IA, consultez notre page sur le processus éditorial .

À propos de l'auteur
Nacho Coll
Founder & Engineer at Badges Ninja
Nacho founded Badges Ninja to make issuing verifiable digital credentials as simple as a single API call — Open Badge v2.0 badges and certificates, minted, hosted, and verifiable without standing up your own issuer infrastructure. Writes about the Open Badges spec, credential verification, and running a credentialing platform serverless on AWS, from the operator side of the wire.
Plus de Nacho Coll
- Open Badges pour bootcamps de code : émettre des certifications vérifiables à l'échelle d'une promo19 nov. 2026 · 13min de lecture
- Configurer des webhooks pour les événements de badge : une intégration en temps réel avec votre backend16 nov. 2026 · 10min de lecture
- Expiration et renouvellement des Open Badges : gérer le cycle de vie des certifications à durée limitée12 nov. 2026 · 12min de lecture


