Open Badge Baking uitgelegd: zo zit JSON in de PNG
Een “baked” Open Badge is een PNG met de assertion-JSON als beeldmetadata ingebed. Het badgebestand IS de credential. Hoe baking werkt en hoe je een baked badge verifieert.
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.
Download een Open Badge van vrijwel elke uitgever en je krijgt een gewone PNG. Plak hem in een chat, voeg hem toe aan een e-mail, print hem uit. Het ziet eruit als elke andere afbeelding. Maar het bestand draagt een tweede, onzichtbare laag: de credential zelf, als metadata in de afbeelding geschreven. Dat noemt de Open Badges-community een baked badge, en daarom kan een badge als één bestand reizen en toch bewijzen wie hem heeft uitgegeven, aan wie en waarvoor.
Deze gids legt uit wat baking is, waar de data in het bestand zit, hoe een verificateur de data terugleest en wat je als uitgever van credentials moet beslissen. Je hoeft geen code te schrijven om baked badges te gebruiken. Geef je uit via https://badges.ninja, dan gebeurt het baking voor je. Maar als je de mechaniek begrijpt, kun je de vragen beantwoorden die ontvangers en werkgevers echt stellen: “Is deze afbeelding echt?” en “Kan iedereen hem gewoon kopiëren?”
Wat “baking” betekent
Een Open Badge heeft twee onderdelen die makkelijk door elkaar worden gehaald:
- De afbeelding. De PNG of SVG die mensen zien op een profiel, een dia of een certificaat.
- De assertion. Een klein JSON-document met de feiten: wie de ontvanger is (als gehashte identifier), welke badge class is behaald, wie hem heeft uitgegeven, wanneer en waar je hem kunt verifiëren.
Baking is het schrijven van de assertion in de afbeelding zodat de twee niet te scheiden zijn. Het resultaat is één bestand. Geef je iemand de PNG, dan geef je zowel de afbeelding als de claim erachter.
Het idee komt uit de Open Badges-specificatie, oorspronkelijk ontwikkeld door Mozilla en nu onderhouden door 1EdTech. Het ontwerp draait om overdraagbaarheid. In het begin leefden badges binnen één platform, en een badge naar een andere plek verplaatsen betekende opnieuw uploaden en hopen dat de metadata het overleefde. Een baked bestand draagt zijn eigen metadata overal mee naartoe.
Waar de JSON in een PNG zit
Een PNG-bestand is een korte signature gevolgd door een reeks chunks. Elke chunk heeft een lengte, een type van vier letters, wat data en een checksum. Viewers tekenen de pixels uit de IDAT-chunks en negeren chunktypes die ze niet kennen. Die tolerantie maakt baking mogelijk: je kunt een chunk vol tekst toevoegen en elke afbeeldingsviewer ter wereld toont de afbeelding nog steeds normaal.
Bij Open Badges 2.0 komt de assertion in een tekstchunk met het trefwoord openbadges. De tekstchunktypes die hem kunnen bevatten zijn:
| Chunk | Codering | Opmerkingen |
|---|---|---|
tEXt | Latin-1 | Eenvoudig, maar beperkt tot Latin-1-tekens. |
iTXt | UTF-8 | Voorkeur, omdat namen en beschrijvingen vaak geen ASCII zijn. |
Welke chunk je ook gebruikt, de opbouw is hetzelfde: het trefwoord openbadges, een scheidingsteken, dan de payload. De payload is een van twee dingen, afhankelijk van hoe de uitgever heeft gekozen te baken:
- De assertion-JSON zelf. Het bestand beschrijft zichzelf. Een verificateur kan de claim lezen zonder netwerkaanroep.
- Een URL die naar de gehoste assertion wijst. Het bestand is kleiner en de uitgever kan het live record leidend houden, bijvoorbeeld om te tonen dat een badge later is ingetrokken of verlopen.
Er bestaat een derde variant voor ondertekende badges, waarbij de payload een ondertekend token is in plaats van gewone JSON. Als handtekeningen voor jouw situatie belangrijk zijn, lees dan how to verify an Open Badge signature.
En SVG?
SVG-badges kunnen ook gebaked worden, want SVG is XML. De assertion komt in het bestand in een element met de XML-namespace openbadges, en het attribuut verify bevat de URL van de gehoste assertion. Het principe is hetzelfde als bij PNG: de metadata reist mee in het afbeeldingsbestand. In de praktijk bakken de meeste platforms PNG, omdat PNG bijna overal wordt geaccepteerd waar mensen een badge willen uploaden.
Hoe de ingebedde assertion eruitziet
Voor het 2.0-formaat is een gehoste assertion JSON-LD die de ontvanger, de badge class en de verificatiemethode koppelt. Een ingekort voorbeeld:
{
"@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" }
}
Let op de ontvanger. Het e-mailadres staat niet leesbaar opgeslagen; het is een SHA-256-hash met salt. Dat is belangrijk voor een bestand dat bedoeld is om rond te gaan. Iedereen met de PNG kan de assertion lezen, dus de assertion mag het adres van de ontvanger niet lekken. Een verificateur die het e-mailadres al kent, kan het met dezelfde salt hashen en controleren of het overeenkomt. Voor een veld-voor-veld rondleiding door dit document, zie de Open Badge JSON-LD walkthrough.
Hoe een verificateur een baked badge leest
Het verifiëren van een baked badge is een kort, mechanisch proces:
- Open de PNG en loop door de chunks.
- Zoek de tekstchunk met het trefwoord
openbadges. - Lees de payload. Is het JSON, parseer hem dan. Is het een URL, haal hem dan op.
- Controleer dat de assertion verwijst naar de badge class en uitgever die je verwacht, en dat de identiteit van de ontvanger overeenkomt met de persoon die hem toont.
- Is het verificatietype
hosted, bevestig dan dat de gehoste assertion nog bestaat op zijnid-URL en niet is ingetrokken of verlopen.
Stap 5 is de stap die mensen overslaan, en het is degene die een credential betrouwbaar maakt. Een ingebedde kopie is een momentopname. Het gehoste record is de bron van waarheid.
Zelf lezen in Node
Je kunt elke PNG inspecteren met een kort script. Dit script loopt door de chunks en print de openbadges-payload, voor zowel tEXt als 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);
Draai het met node extract-badge.mjs my-badge.png. Is het bestand baked, dan zie je JSON of een URL. Zo niet, dan krijg je een simpele melding “not baked”. Dit is een leermiddel, geen volledige validator: het controleert geen chunk-checksums, parseert geen ondertekende payloads en haalt het gehoste record niet op.
Wil je liever geen code schrijven, dan toont een online badgevalidator of een PNG-metadataviewer dezelfde chunk. Het formaat is de standaard, dus elke conforme tool leest elke conforme badge.
Waarom baking ertoe doet
Overdraagbaarheid. Een credential die slechts een PNG is, kun je mailen, uploaden naar een leerplatform of in een persoonlijk archief bewaren. Je hebt geen account nodig om hem mee te nemen.
Een verificatiepad dat de marketingsite van de uitgever overleeft. De ingebedde assertion noemt de uitgever en wijst naar het gehoste record, dus een verificateur kan beginnen met alleen het bestand.
Offline en low-tech workflows. Is de payload de volledige JSON, dan kan een lezer de claim controleren op een machine zonder netwerk en later het gehoste record verifiëren.
Bewijs dat niet zomaar te vervalsen is. Iedereen kan een screenshot van een badge maken. Een screenshot heeft geen metadata en kan dus niet als badgebestand worden geverifieerd. Alleen dat al scheidt een echte credential van een gekopieerde afbeelding. Het houdt niemand tegen om een vervalste assertion in een gestolen afbeelding te baken, en daarom bestaat de gehoste verificatiestap.
De grenzen van baking
Wees eerlijk tegen je ontvangers over deze punten, want ze beïnvloeden hoe je je credentials beschrijft.
- Metadata wordt verwijderd. Veel sociale netwerken, afbeeldingsoptimalisatoren en berichtenapps coderen uploads opnieuw en laten chunks zonder pixels vallen. Een baked badge die op een socialmediafeed wordt geplaatst, is meestal niet meer baked. Dat is te verwachten, en daarom is een openbare verificatielink naast het bestand belangrijk.
- Baking is op zichzelf geen bewijs. Ingebedde JSON kan door iedereen worden geschreven. Vertrouwen komt van de gehoste assertion op het domein van de uitgever, of van een geldige handtekening.
- Afbeeldingsbewerkingen verbreken de koppeling. Formaat wijzigen of opnieuw opslaan in een editor kan de chunk laten verdwijnen.
- Alleen PNG en SVG. JPEG heeft in de specificatie geen vergelijkbare chunkconventie, dus een badge in fotostijl die als JPEG is geëxporteerd, kan niet op de standaardmanier gebaked worden.
De praktische conclusie: zie het baked bestand als een handige drager en de verificatiepagina als de autoriteit. Weeg je formaten voor je programma, dan legt Open Badges vs PDF certificates uit waarom een machineleesbare credential beter is dan een statisch document.
Hoe baking werkt op https://badges.ninja
Wanneer je een badge toekent op https://badges.ninja, bouwt het platform de Open Badge-assertion voor die ontvanger en bakt die als onderdeel van het uitgeven in de badgeafbeelding. Je hoeft geen tool te configureren of opdracht uit te voeren. De flow:
- Je ontwerpt de badge in de visuele designer, of uploadt je eigen afbeelding.
- Je geeft een award uit, vanuit het dashboard, via een CSV-upload voor bulkawards of via de API.
- Het platform maakt de assertion, bakt die in de PNG en bewaart het resultaat bij de award.
- De ontvanger krijgt een openbare verificatiepagina op
https://badges.ninja/awards/<awardId>, een pdf-certificaat, een QR-code en een Add to LinkedIn-optie.
Gebruikt het badgeontwerp samenvoegvelden zoals de naam van de ontvanger, dan krijgt elke award een gepersonaliseerde afbeelding, en die gepersonaliseerde afbeelding is degene die wordt gebaked.
Baking wordt gezien als een verbetering van het uitgeven, niet als een drempel: als een bepaalde afbeelding niet gebaked kan worden (bijvoorbeeld een ontaarde placeholderafbeelding), wordt de award toch uitgegeven met de originele afbeelding, en de openbare verificatiepagina en de Open Badge JSON-LD blijven ongewijzigd. De afbeelding die je uploadt moet ook een minimale grootte halen, dus een piepklein leeg canvas wordt geweigerd voordat het de bakkerij bereikt.
Omdat de openbare pagina de autoriteit is, kan iedereen een award controleren zonder zich aan te melden. De machineleesbare Open Badge v2.0 JSON-LD van een award is beschikbaar op https://api.badges.ninja/certify-badge/award/<awardId>.
Eén award uitgeven via de API
De meeste lezers gebruiken het dashboard, maar automatiseer je het uitgeven, dan maakt één verzoek de award aan (en de baked afbeelding komt erbij). Vervang de sleutel en de badge-id door je eigen waarden:
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}`;
De aanroep geeft HTTP 200 terug met { "awardId": "<guid>" }. Bouw de verificatie-URL op basis van die id. Voor het instellen van sleutels en de volledige verzoekreferentie, zie de Awards API docs en de authentication guide.

Praktisch advies voor uitgevers
Publiceer altijd een verificatielink naast het bestand. Zet de link in de award-e-mail, op het certificaat en op elke pagina waar de badge wordt getoond. Omdat socialemediaplatforms metadata verwijderen, houdt de link de credential verifieerbaar na het delen.
Gebruik een schone bronafbeelding van fatsoenlijke grootte. Begin met een PNG met echte afmetingen. Een door een ontwerper gemaakte badge op normale resolutie bakt betrouwbaar; een placeholder van 1 pixel niet.
Bewerk het geleverde bestand niet. Vertel ontvangers de originele download of de verificatielink te delen, niet een bijgesneden screenshot.
Bepaal wat je wilt zeggen over intrekking en verlopen. Omdat het gehoste record leidend is, kan een baked bestand de status van de credential overleven. Zeg dat duidelijk in de documentatie van je programma, zodat werkgevers weten dat ze de verificatiepagina moeten controleren in plaats van alleen op het bestand te vertrouwen.
Test één badge van begin tot eind. Geef jezelf een award, download de PNG, haal hem door het script hierboven of een openbare validator en open de verificatielink. Vijf minuten testen laten zien wat je ontvangers zullen ervaren.

Veelgestelde vragen
Is een baked badge hetzelfde als een digitaal certificaat? Nee. Een certificaat is meestal een pdf om te lezen en te printen. Een baked badge is een afbeelding die ook machineleesbare credentialdata bevat. https://badges.ninja maakt beide van dezelfde award.
Kan ik een badge bakken zonder platform? Ja. De specificatie is open en er bestaan bibliotheken voor meerdere talen. Het lastigere deel is het hosten van de assertion op een stabiele URL, want dat maakt verificatie zinvol. Dat deel neemt een platform voor je uit handen.
Maakt baking het e-mailadres van de ontvanger zichtbaar? Niet wanneer de identiteit gehasht is. De assertion bevat een hash met salt, dus het bestand onthult het adres niet.
Leest LinkedIn de baked data? De Add to Profile-flow van LinkedIn werkt vanuit credentialnaam, uitgever, datum en URL in plaats van vanuit bestandsmetadata. Zie adding an Add to LinkedIn button.
Samenvatting
Een baked Open Badge is een PNG (of SVG) met de credential geschreven in een tekstchunk met de naam openbadges. Dat maakt een badge overdraagbaar en zelfbeschrijvend, maar het echte vertrouwen komt van de gehoste assertion op het domein van de uitgever. Bak voor overdraagbaarheid, publiceer een verificatielink voor vertrouwen en reken erop dat sociale netwerken de metadata verwijderen.
Klaar om je eerste verifieerbare credential uit te geven? Begin gratis op badges.ninja — visuele designer, openbare verificatiepagina, pdf-certificaat, Open Badge v2.0-output. Geen creditcard nodig.
Hoe dit artikel is gemaakt
Sommige berichten op deze blog worden met behulp van een AI-assistent opgesteld en vervolgens door het Badges Ninja-team gecontroleerd, geverifieerd en bewerkt voordat ze worden gepubliceerd. Elk codevoorbeeld en elke prijs wordt geverifieerd aan de hand van het live product. Lees meer over ons redactionele en AI-proces op onze pagina over ons redactieproces .

Over de 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.
Meer van Nacho Coll
- Open Badges voor codeerbootcamps: verifieerbare credentials uitgeven op cohortschaal19 nov 2026 · 11min leestijd
- Webhooks instellen voor badge-events: realtime integratie met je backend16 nov 2026 · 9min leestijd
- Verval en verlenging van Open Badges: levenscyclusbeheer voor tijdelijke credentials12 nov 2026 · 11min leestijd


