Open Badge baking forklaret: Sådan bor JSON inde i PNG-filen
Et »baked« Open Badge er en PNG med assertion-JSON indlejret som billedmetadata. Badge-filen ER legitimationen. Sådan fungerer baking, og sådan verificerer du et baked badge.
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 et Open Badge fra næsten en hvilken som helst udsteder, og du får en helt almindelig PNG. Smid den i en chat, vedhæft den i en e-mail, print den. Den ligner ethvert andet billede. Men filen har et ekstra, usynligt lag: selve legitimationen, skrevet ind i billedet som metadata. Det er det, Open Badges-fællesskabet kalder et baked badge, og det er grunden til, at et badge kan rejse som én enkelt fil og stadig bevise, hvem der udstedte det, til hvem og for hvad.
Denne guide forklarer, hvad baking er, hvor dataene ligger i filen, hvordan en verificerer læser dem igen, og hvad du skal tage stilling til som udsteder af legitimationer. Du behøver ikke skrive kode for at bruge baked badges. Hvis du udsteder via https://badges.ninja, sker baking automatisk. Men det hjælper at forstå mekanikken, når du skal besvare de spørgsmål, modtagere og arbejdsgivere faktisk stiller: “Er dette billede ægte?” og “Kan hvem som helst bare kopiere det?”
Hvad “baking” betyder
Et Open Badge har to dele, som er lette at blande sammen:
- Billedet. PNG- eller SVG-filen, som folk ser på en profil, et slide eller et certifikat.
- Assertion. Et lille JSON-dokument, der fastslår fakta: hvem modtageren er (som en hashet identifikator), hvilken badge-klasse der er opnået, hvem der har udstedt den, hvornår, og hvor den kan verificeres.
Baking er det at skrive assertion ind i billedet, så de to ikke kan skilles ad. Resultatet er én fil. Giver du nogen PNG-filen, har du givet dem både billedet og påstanden bag det.
Idéen stammer fra Open Badges-specifikationen, som oprindeligt blev udviklet af Mozilla og nu vedligeholdes af 1EdTech. Pointen med designet er portabilitet. I starten levede badges inde i én enkelt platform, og at flytte et badge betød at uploade det igen og håbe, at metadataene overlevede. En baked fil har sine egne metadata med sig, uanset hvor den havner.
Hvor JSON’en ligger inde i en PNG
En PNG-fil består af en kort signatur efterfulgt af en række chunks. Hver chunk har en længde, en type på fire bogstaver, nogle data og en kontrolsum. Viewere tegner pixlerne ud fra IDAT-chunks og ignorerer chunktyper, de ikke forstår. Den tolerance er det, der gør baking muligt: du kan tilføje en chunk fyldt med tekst, og alle billedviewere i verden vil stadig vise billedet helt normalt.
I Open Badges 2.0 placeres assertion i en tekstchunk med nøgleordet openbadges. De tekstchunktyper, der kan rumme den, er:
| Chunk | Kodning | Noter |
|---|---|---|
tEXt | Latin-1 | Enkel, men begrænset til Latin-1-tegn. |
iTXt | UTF-8 | Foretrukken, fordi navne og beskrivelser ofte ikke er ASCII. |
Uanset hvilken chunk der bruges, er opbygningen den samme: nøgleordet openbadges, en separator og så nyttelasten. Nyttelasten er en af to ting, afhængigt af hvordan udstederen har valgt at bake:
- Selve assertion-JSON’en. Filen er selvbeskrivende. En verificerer kan læse påstanden uden noget netværkskald.
- En URL, der peger på den hostede assertion. Filen er mindre, og udstederen kan beholde den levende post som autoritativ, for eksempel for at vise, at et badge senere er tilbagekaldt eller udløbet.
Der findes en tredje variant til signerede badges, hvor nyttelasten er et signeret token i stedet for almindelig JSON. Hvis signaturer er vigtige for dig, så læs sådan verificerer du en Open Badge-signatur.
Hvad med SVG?
SVG-badges kan også bakes, da SVG er XML. Assertion placeres inde i filen i et element i navnerummet openbadges, og verify-attributten indeholder URL’en til den hostede assertion. Princippet er det samme som med PNG: metadataene rejser inde i billedfilen. I praksis bruger de fleste platforme PNG, fordi PNG accepteres næsten overalt, hvor folk vil uploade et badge.
Sådan ser den indlejrede assertion ud
I 2.0-formatet er en hostet assertion JSON-LD, der forbinder modtageren, badge-klassen og verificeringsmetoden. Et forkortet eksempel:
{
"@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" }
}
Læg mærke til modtageren. E-mailen er ikke gemt i klartekst; den er en saltet SHA-256-hash. Det er vigtigt for en fil, der er designet til at blive givet videre. Enhver, der har PNG-filen, kan læse assertion, så assertion må ikke lække modtagerens adresse. En verificerer, der allerede kender e-mailen, kan hashe den med samme salt og tjekke, at den passer. For en gennemgang af dokumentet felt for felt, se gennemgangen af Open Badge JSON-LD.
Sådan læser en verificerer et baked badge
Verificering af et baked badge er en kort, mekanisk proces:
- Åbn PNG-filen og gå gennem dens chunks.
- Find tekstchunken med nøgleordet
openbadges. - Læs nyttelasten. Er det JSON, så parse den. Er det en URL, så hent den.
- Tjek, at assertion henviser til den badge-klasse og udsteder, du forventer, og at modtagerens identitet matcher den person, der fremviser det.
- Hvis verificeringstypen er
hosted, så bekræft, at den hostede assertion stadig findes på sinid-URL og ikke er tilbagekaldt eller udløbet.
Trin 5 er det, folk springer over, og det er det, der gør en legitimation troværdig. En indlejret kopi er et øjebliksbillede. Den hostede post er sandhedskilden.
Læs den selv i Node
Du kan inspicere enhver PNG med et kort script. Dette gennemgår chunks og udskriver openbadges-nyttelasten og håndterer både tEXt og 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);
Kør det med node extract-badge.mjs my-badge.png. Hvis filen er baked, ser du JSON eller en URL. Hvis ikke, får du en enkel besked om, at den ikke er baked. Det er et undervisningsværktøj, ikke en fuld validator: det tjekker ikke chunk-kontrolsummer, parser ikke signerede nyttelaster og henter ikke den hostede post.
Hvis du hellere vil undgå at skrive kode, viser en online badge-validator eller en PNG-metadataviewer den samme chunk. Formatet er standarden, så ethvert kompatibelt værktøj læser ethvert kompatibelt badge.
Hvorfor baking har betydning
Portabilitet. En legitimation, der blot er en PNG, kan sendes på e-mail, uploades til en læringsplatform eller gemmes i et personligt arkiv. Der kræves ingen konto for at bære den med sig.
En verificeringsvej, der overlever udstederens marketingsite. Den indlejrede assertion nævner udstederen og peger på den hostede post, så en verificerer kan starte ud fra filen alene.
Offline og lavteknologiske arbejdsgange. Når nyttelasten er hele JSON’en, kan en læser tjekke påstanden på en maskine uden netværk og verificere den hostede post senere.
Dokumentation, der er svær at forfalske i det små. Alle kan tage et skærmbillede af et badge. Et skærmbillede har ingen metadata, så det kan ikke verificeres som en badge-fil. Alene det adskiller en ægte legitimation fra et kopieret billede. Det forhindrer ikke nogen i at bake en forfalsket assertion ind i et stjålet billede, og derfor findes verificeringstrinnet mod den hostede post.
Baking har sine grænser
Vær ærlig over for dine modtagere om disse, for de påvirker, hvordan du beskriver dine legitimationer.
- Metadata bliver fjernet. Mange sociale netværk, billedoptimeringsværktøjer og beskedapps genkoder uploads og dropper chunks, der ikke er pixeldata. Et baked badge, der postes i et socialt feed, er som regel ikke længere baked. Det er forventeligt, og det er derfor, et offentligt verificeringslink er vigtigt ved siden af filen.
- Baking er ikke bevis i sig selv. Indlejret JSON kan skrives af hvem som helst. Tilliden kommer fra den hostede assertion på udstederens domæne eller fra en gyldig signatur.
- Billedredigering bryder forbindelsen. Ændring af størrelse eller gem på ny i et redigeringsprogram kan miste chunken.
- Kun PNG og SVG. JPEG har ingen tilsvarende chunk-konvention i specifikationen, så et badge i fotostil eksporteret som JPEG kan ikke bakes på standardmåden.
Den praktiske konklusion: behandl den bakede fil som en praktisk bærer, og behandl verificeringssiden som autoriteten. Hvis du overvejer formater til dit program, forklarer Open Badges vs. PDF-certifikater, hvorfor en maskinlæsbar legitimation slår et statisk dokument.
Sådan fungerer baking på https://badges.ninja
Når du tildeler et badge på https://badges.ninja, bygger platformen Open Badge-assertion for den pågældende modtager og baker den ind i badge-billedet som en del af udstedelsen. Du konfigurerer intet værktøj og kører ingen kommando. Forløbet:
- Du designer badget i den visuelle designer, eller du uploader dit eget billede.
- Du udsteder en tildeling fra dashboardet, via CSV-upload til masseudstedelse eller via API’et.
- Platformen opretter assertion, baker den ind i PNG-filen og gemmer resultatet sammen med tildelingen.
- Modtageren får en offentlig verificeringsside på
https://badges.ninja/awards/<awardId>, et PDF-certifikat, en QR-kode og en Add to LinkedIn-mulighed.
Hvis badge-designet bruger flettefelter som modtagerens navn, får hver tildeling et personligt billede, og det er det personlige billede, der bliver bakt.
Baking er en forbedring af udstedelsen, ikke en forudsætning: hvis et bestemt billede ikke kan bakes (for eksempel et degenereret pladsholderbillede), udstedes tildelingen stadig med det oprindelige billede, og den offentlige verificeringsside og Open Badge JSON-LD påvirkes ikke. Billedet, du uploader, skal også opfylde en minimumsstørrelse, så et lille tomt lærred afvises, før det når frem til bageriet.
Fordi den offentlige side er autoriteten, kan alle tjekke en tildeling uden at oprette sig. Den maskinlæsbare Open Badge v2.0 JSON-LD for en tildeling findes på https://api.badges.ninja/certify-badge/award/<awardId>.
Udsted én tildeling via API
De fleste vil bruge dashboardet, men hvis du automatiserer udstedelsen, opretter ét kald tildelingen (og det bakede billede følger med). Erstat nøgle og badge-id med dine egne:
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}`;
Kaldet returnerer HTTP 200 med { "awardId": "<guid>" }. Byg verificerings-URL’en ud fra det id. For opsætning af nøgler og den fulde anmodningsreference, se Awards API-dokumentationen og godkendelsesguiden.

Praktiske råd til udstedere
Udgiv altid et verificeringslink ved siden af filen. Sæt linket i tildelings-e-mailen, på certifikatet og på alle sider, hvor badget vises. Da sociale platforme fjerner metadata, er det linket, der holder legitimationen verificerbar efter deling.
Brug et rent kildebillede i fornuftig størrelse. Start med en PNG med reelle dimensioner. Et designer-lavet badge i normal opløsning bakes pålideligt; en pladsholder på 1 pixel gør ikke.
Rediger ikke den leverede fil. Bed modtagerne dele den originale download eller verificeringslinket, ikke et beskåret skærmbillede.
Beslut, hvad du vil sige om tilbagekaldelse og udløb. Fordi den hostede post er autoritativ, kan en baked fil overleve legitimationens status. Skriv det tydeligt i dit programs dokumentation, så arbejdsgivere ved, at de skal tjekke verificeringssiden i stedet for kun at stole på filen.
Test ét badge fra ende til anden. Udsted en tildeling til dig selv, download PNG-filen, kør den gennem scriptet ovenfor eller en offentlig validator, og åbn verificeringslinket. Fem minutters test viser dig, hvad dine modtagere kommer til at opleve.

Ofte stillede spørgsmål
Er et baked badge det samme som et digitalt certifikat? Nej. Et certifikat er som regel en PDF til læsning og udskrivning. Et baked badge er et billede, der også bærer maskinlæsbare legitimationsdata. https://badges.ninja producerer begge dele ud fra den samme tildeling.
Kan jeg bake et badge uden en platform? Ja. Specifikationen er åben, og der findes biblioteker til flere sprog. Den sværere del er at hoste assertion på en stabil URL, og det er det, der gør verificering meningsfuld. Det er den del, en platform tager sig af for dig.
Afslører baking modtagerens e-mail? Ikke når identiteten er hashet. Assertion gemmer en saltet hash, så filen afslører ikke adressen.
Vil LinkedIn læse de bakede data? LinkedIns Add to Profile-flow bygger på et legitimationsnavn, en udsteder, en dato og en URL frem for på filens metadata. Se tilføjelse af en Add to LinkedIn-knap.
Opsummering
Et baked Open Badge er en PNG (eller SVG) med legitimationen skrevet ind i en tekstchunk ved navn openbadges. Det gør et badge portabelt og selvbeskrivende, men den reelle tillid kommer fra den hostede assertion på udstederens domæne. Bak for portabilitetens skyld, udgiv et verificeringslink for tillidens skyld, og forvent, at sociale netværk fjerner metadataene.
Klar til at udstede din første verificerbare legitimation? Kom i gang gratis på badges.ninja — visuel designer, offentlig verificeringsside, PDF-certifikat, Open Badge v2.0-output. Intet kreditkort påkrævet.
Sådan blev denne artikel til
Nogle indlæg på denne blog udarbejdes med hjælp fra en AI-assistent og gennemgås, faktatjekkes og redigeres af Badges Ninja-teamet inden udgivelse. Alle kodeeksempler og priser verificeres mod det live produkt. Læs mere om vores redaktionelle proces og AI-proces på vores side om vores redaktionelle proces .

Om forfatteren
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.
Mere fra Nacho Coll
- Open Badges til coding bootcamps: Udsted verificerbare beviser i kohorte-skala19. nov. 2026 · 10min. læsning
- Opsætning af webhooks til badge-hændelser: realtidsintegration med din backend16. nov. 2026 · 9min. læsning
- Udløb og fornyelse af Open Badges: livscyklusstyring af tidsbegrænsede legitimationer12. nov. 2026 · 11min. læsning


