Open Badge Baking explicat: com viu el JSON dins del PNG
Una insígnia Open Badge «baked» és un PNG amb el JSON de l'asserció incrustat com a metadades de la imatge. El fitxer de la insígnia ÉS la credencial. Com funciona el baking i com verificar una insígnia 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.
Descarrega un Open Badge de gairebé qualsevol emissor i obtindràs un PNG d’aspecte normal. Deixa’l en un xat, adjunta’l a un correu, imprimeix-lo. Sembla qualsevol altra imatge. Però el fitxer porta una segona capa, invisible: la credencial mateixa, escrita a la imatge com a metadades. És el que la comunitat d’Open Badges anomena una insígnia baked, i és el motiu pel qual una insígnia pot viatjar com un sol fitxer i, tot i així, demostrar qui l’ha emesa, a qui i per què.
Aquesta guia explica què és el baking, on viuen les dades dins del fitxer, com les llegeix un verificador i què has de decidir tu com a emissor de credencials. No cal que escriguis codi per fer servir insígnies baked. Si emets amb https://badges.ninja, el baking es fa per tu. Però entendre la mecànica t’ajuda a respondre les preguntes que els destinataris i les empreses fan de debò: «Aquesta imatge és real?» i «Qualsevol persona pot copiar-la?»
Què vol dir «baking»
Un Open Badge té dues parts que és fàcil confondre:
- La imatge. El PNG o SVG que la gent veu en un perfil, una diapositiva o un certificat.
- L’asserció. Un petit document JSON que estableix els fets: qui és el destinatari (com a identificador amb hash), quina classe d’insígnia s’ha obtingut, qui l’ha emesa, quan i on es pot verificar.
El baking és l’acció d’escriure l’asserció dins de la imatge perquè les dues no es puguin separar. El resultat és un sol fitxer. Si passes el PNG a algú, li has donat alhora la imatge i l’afirmació que hi ha al darrere.
La idea ve de l’especificació Open Badges, desenvolupada originalment per Mozilla i mantinguda ara per 1EdTech. El sentit del disseny és la portabilitat. Al principi, les insígnies vivien dins d’una única plataforma, i moure’n una a un altre lloc volia dir tornar-la a pujar i esperar que les metadades sobrevisquessin. Un fitxer baked porta les seves pròpies metadades allà on vagi.
On viu el JSON dins d’un PNG
Un fitxer PNG és una signatura breu seguida d’una seqüència de chunks. Cada chunk té una longitud, un tipus de quatre lletres, unes dades i una suma de verificació. Els visors dibuixen els píxels a partir dels chunks IDAT i ignoren els tipus de chunk que no entenen. Aquesta tolerància és el que fa possible el baking: pots afegir un chunk ple de text i qualsevol visor d’imatges del món continuarà mostrant la imatge amb normalitat.
Per a Open Badges 2.0, l’asserció va en un chunk de text amb la paraula clau openbadges. Els tipus de chunk de text que la poden contenir són:
| Chunk | Codificació | Notes |
|---|---|---|
tEXt | Latin-1 | Simple, però limitat als caràcters Latin-1. |
iTXt | UTF-8 | Preferit, perquè els noms i les descripcions sovint no són ASCII. |
Sigui quin sigui el chunk utilitzat, l’estructura és la mateixa: la paraula clau openbadges, un separador i després la càrrega útil. La càrrega útil és una de dues coses, segons com hagi decidit fer el baking l’emissor:
- El JSON de l’asserció mateix. El fitxer és autodescriptiu. Un verificador pot llegir l’afirmació sense cap crida de xarxa.
- Una URL que apunta a l’asserció allotjada. El fitxer és més petit i l’emissor pot mantenir el registre en viu com a autoritat, per exemple per mostrar que una insígnia s’ha revocat més endavant o que ha caducat.
Hi ha una tercera variant per a les insígnies signades, en què la càrrega útil és un token signat en lloc de JSON pla. Si les signatures són importants en el teu cas, llegeix com verificar la signatura d’un Open Badge.
I l’SVG?
Les insígnies SVG també es poden fer baked, ja que l’SVG és XML. L’asserció es col·loca dins del fitxer en un element de l’espai de noms XML openbadges, i l’atribut verify porta la URL de l’asserció allotjada. El principi és el mateix que amb el PNG: les metadades viatgen dins del fitxer d’imatge. A la pràctica, la majoria de plataformes fan baking de PNG, perquè el PNG s’accepta gairebé a tot arreu on la gent vol pujar una insígnia.
Com és l’asserció incrustada
Per al format 2.0, una asserció allotjada és un JSON-LD que enllaça el destinatari, la classe d’insígnia i el mètode de verificació. Un exemple resumit:
{
"@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" }
}
Fixa’t en el destinatari. El correu no s’emmagatzema en clar; és un hash SHA-256 amb salt. Això importa en un fitxer pensat per circular. Qualsevol persona que tingui el PNG pot llegir l’asserció, de manera que l’asserció no ha de filtrar l’adreça del destinatari. Un verificador que ja coneix el correu pot fer-ne el hash amb el mateix salt i comprovar que coincideix. Per a un recorregut camp per camp d’aquest document, consulta el recorregut pel JSON-LD d’un Open Badge.
Com llegeix un verificador una insígnia baked
La verificació d’una insígnia baked és un procés breu i mecànic:
- Obre el PNG i recorre’n els chunks.
- Troba el chunk de text amb la paraula clau
openbadges. - Llegeix la càrrega útil. Si és JSON, analitza’l. Si és una URL, obtén-la.
- Comprova que l’asserció es refereix a la classe d’insígnia i a l’emissor que esperes, i que la identitat del destinatari coincideix amb la persona que la presenta.
- Si el tipus de verificació és
hosted, confirma que l’asserció allotjada encara existeix a la seva URLidi que no s’ha revocat ni ha caducat.
El pas 5 és el que la gent es salta, i és el que fa que una credencial sigui de fiar. Una còpia incrustada és una instantània. El registre allotjat és la font de la veritat.
Llegir-la tu mateix amb Node
Pots inspeccionar qualsevol PNG amb un script curt. Aquest recorre els chunks i imprimeix la càrrega útil openbadges, tant per a tEXt com per a 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);
Executa’l amb node extract-badge.mjs my-badge.png. Si el fitxer és baked, veuràs JSON o una URL. Si no, rebràs un senzill missatge «not baked». Això és una eina per aprendre, no un validador complet: no comprova les sumes de verificació dels chunks, no analitza càrregues útils signades ni obté el registre allotjat.
Si prefereixes no escriure codi, un validador d’insígnies en línia o un visor de metadades PNG et mostrarà el mateix chunk. El format és l’estàndard, així que qualsevol eina compatible llegeix qualsevol insígnia compatible.
Per què importa el baking
Portabilitat. Una credencial que és només un PNG es pot enviar per correu, pujar a una plataforma d’aprenentatge o guardar en un arxiu personal. No cal cap compte per portar-la.
Un camí de verificació que sobreviu al web de màrqueting de l’emissor. L’asserció incrustada nomena l’emissor i apunta al registre allotjat, de manera que un verificador pot començar només amb el fitxer.
Fluxos de treball offline i de baixa tecnologia. Quan la càrrega útil és el JSON complet, es pot comprovar l’afirmació en una màquina sense xarxa i verificar el registre allotjat més tard.
Una prova difícil de falsificar casualment. Qualsevol pot fer una captura d’una insígnia. Una captura no té metadades, així que no es pot verificar com a fitxer d’insígnia. Només això ja separa una credencial real d’una imatge copiada. No impedeix que algú faci baking d’una asserció falsificada dins d’una imatge robada, i per això existeix el pas de verificació allotjada.
Els límits del baking
Sigues honest amb els destinataris sobre això, perquè afecta com descrius les teves credencials.
- Les metadades s’eliminen. Moltes xarxes socials, optimitzadors d’imatges i aplicacions de missatgeria tornen a codificar les pujades i descarten els chunks que no són de píxels. Una insígnia baked publicada en un feed social normalment ja no és baked. És el que s’espera, i per això un enllaç de verificació públic és important al costat del fitxer.
- El baking no és una prova per si sol. Qualsevol pot escriure JSON incrustat. La confiança ve de l’asserció allotjada al domini de l’emissor, o d’una signatura vàlida.
- Editar la imatge trenca l’enllaç. Canviar-ne la mida o tornar-la a desar en un editor pot fer perdre el chunk.
- Només PNG i SVG. El JPEG no té una convenció de chunk equivalent a l’especificació, de manera que una insígnia de tipus fotografia exportada com a JPEG no es pot fer baked de la manera estàndard.
La conclusió pràctica: tracta el fitxer baked com un portador còmode i la pàgina de verificació com l’autoritat. Si estàs valorant formats per al teu programa, Open Badges vs certificats en PDF explica per què una credencial llegible per màquina supera un document estàtic.
Com funciona el baking a https://badges.ninja
Quan atorgues una insígnia a https://badges.ninja, la plataforma construeix l’asserció Open Badge per a aquell destinatari i la incrusta a la imatge de la insígnia com a part de l’emissió. No cal configurar cap eina ni executar cap ordre. El flux:
- Dissenyes la insígnia al dissenyador visual, o puges la teva pròpia imatge.
- Emets un atorgament, des del tauler, des d’una pujada de CSV per a atorgaments en massa, o mitjançant l’API.
- La plataforma crea l’asserció, la incrusta al PNG i desa el resultat amb l’atorgament.
- El destinatari rep una pàgina de verificació pública a
https://badges.ninja/awards/<awardId>, un certificat en PDF, un codi QR i una opció d’Add to LinkedIn.
Si el disseny de la insígnia fa servir camps de combinació, com el nom del destinatari, cada atorgament obté una imatge personalitzada, i aquesta imatge personalitzada és la que es fa baked.
El baking es considera una millora de l’emissió, no un requisit: si una imatge concreta no es pot fer baked (per exemple una imatge de marcador de posició degenerada), l’atorgament s’emet igualment amb la imatge original, i la pàgina de verificació pública i el JSON-LD d’Open Badge no se’n ressenten. La imatge que pugis també ha de superar una mida mínima, de manera que un llenç en blanc minúscul es rebutja abans d’arribar al forn.
Com que la pàgina pública és l’autoritat, qualsevol persona pot comprovar un atorgament sense registrar-se. El JSON-LD d’Open Badge v2.0 llegible per màquina d’un atorgament està disponible a https://api.badges.ninja/certify-badge/award/<awardId>.
Emetre un atorgament per API
La majoria de lectors faran servir el tauler, però si automatitzes l’emissió, una sola petició crea l’atorgament (i la imatge baked hi va inclosa). Substitueix la clau i l’id de la insígnia pels teus:
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}`;
La crida retorna HTTP 200 amb { "awardId": "<guid>" }. Construeix la URL de verificació a partir d’aquest id. Per a la configuració de la clau i la referència completa de la petició, consulta la documentació de l’API d’Awards i la guia d’autenticació.

Consells pràctics per a emissors
Publica sempre un enllaç de verificació al costat del fitxer. Posa l’enllaç al correu de l’atorgament, al certificat i a qualsevol pàgina on es mostri la insígnia. Com que les plataformes socials eliminen les metadades, l’enllaç és el que manté la credencial verificable després de compartir-la.
Fes servir una imatge d’origen neta i de mida suficient. Comença amb un PNG de dimensions reals. Una insígnia feta per un dissenyador a resolució normal es fa baked de manera fiable; un marcador de posició d’1 píxel, no.
No editis el fitxer lliurat. Digues als destinataris que comparteixin la descàrrega original o l’enllaç de verificació, no una captura retallada.
Decideix què vols dir sobre la revocació i la caducitat. Com que el registre allotjat és l’autoritat, un fitxer baked pot sobreviure a l’estat de la credencial. Digues-ho clarament a la documentació del teu programa perquè les empreses sàpiguen que han de consultar la pàgina de verificació en lloc de fiar-se només del fitxer.
Prova una insígnia de punta a punta. Emet un atorgament a tu mateix, descarrega el PNG, passa’l per l’script de dalt o per un validador públic, i obre l’enllaç de verificació. Cinc minuts de proves t’expliquen què viuran els teus destinataris.

Preguntes freqüents
Una insígnia baked és el mateix que un certificat digital? No. Un certificat sol ser un PDF per llegir i imprimir. Una insígnia baked és una imatge que també porta dades de credencial llegibles per màquina. https://badges.ninja produeix tots dos a partir del mateix atorgament.
Puc fer baking d’una insígnia sense una plataforma? Sí. L’especificació és oberta i hi ha biblioteques per a diversos llenguatges. La part difícil és allotjar l’asserció en una URL estable, que és el que fa que la verificació tingui sentit. Aquesta és la part que una plataforma gestiona per tu.
El baking exposa el correu del destinatari? No quan la identitat té hash. L’asserció emmagatzema un hash amb salt, de manera que el fitxer no revela l’adreça.
LinkedIn llegirà les dades baked? El flux Add to Profile de LinkedIn funciona a partir del nom de la credencial, l’emissor, la data i la URL, no de les metadades del fitxer. Consulta afegir un botó Add to LinkedIn.
Resum
Una insígnia Open Badge baked és un PNG (o SVG) amb la credencial escrita en un chunk de text anomenat openbadges. Fa que una insígnia sigui portàtil i autodescriptiva, però la confiança real ve de l’asserció allotjada al domini de l’emissor. Fes baking per a la portabilitat, publica un enllaç de verificació per a la confiança i compta que les xarxes socials eliminaran les metadades.
Estàs a punt per emetre la teva primera credencial verificable? Comença gratis a badges.ninja — dissenyador visual, pàgina de verificació pública, certificat en PDF, sortida Open Badge v2.0. Sense targeta de crèdit.
Com es va fer aquest article
Alguns articles d'aquest blog es redacten amb l'ajuda d'un assistent d'IA i després són revisats, verificats i editats per l'equip de Badges Ninja abans de publicar-los. Cada mostra de codi i preu es verifica amb el producte real. Llegeix més sobre el nostre procés editorial i d'IA a la nostra pàgina del procés editorial .

Sobre l'autor
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.
Més de Nacho Coll
- Open Badges per a bootcamps de programació: emet credencials verificables a escala de promoció19 de nov. del 2026 · 13min de lectura
- Configurar webhooks per als esdeveniments d'insígnies: integració en temps real amb el teu backend16 de nov. del 2026 · 10min de lectura
- Caducitat i renovació dels Open Badges: gestió del cicle de vida de les credencials amb termini12 de nov. del 2026 · 12min de lectura


