Az Open Badge baking magyarázata: hogyan él a JSON a PNG-ben
A „sütött” Open Badge egy PNG, amelybe képmetaadatként beágyazták az assertion JSON-t. A jelvényfájl MAGA a hitelesítő adat. Hogyan működik a baking, és hogyan ellenőrizhetsz egy sütött jelvényt.
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ölts le egy Open Badge-et szinte bármelyik kibocsátótól, és egy teljesen átlagosnak tűnő PNG-t kapsz. Bedobhatod egy chatbe, csatolhatod e-mailhez, kinyomtathatod. Úgy néz ki, mint bármely más kép. A fájl azonban egy második, láthatatlan réteget is hordoz: magát a hitelesítő adatot, metaadatként a képbe írva. Az Open Badges közösség ezt nevezi sütött jelvénynek (baked badge), és ezért utazhat egy jelvény egyetlen fájlként, mégis bizonyítva, hogy ki állította ki, kinek és miért.
Ez az útmutató elmagyarázza, mi a baking, hol találhatók az adatok a fájlban, hogyan olvassa vissza egy ellenőrző, és miről kell döntened kibocsátóként. Sütött jelvények használatához nem kell kódot írnod. Ha a https://badges.ninja-n keresztül bocsátasz ki, a baking magától megtörténik. A mechanika megértése viszont segít válaszolni a kérdésekre, amelyeket a címzettek és a munkáltatók valóban feltesznek: „Valódi ez a kép?” és „Bárki egyszerűen lemásolhatja?”
Mit jelent a „baking”
Az Open Badge két, könnyen összekeverhető részből áll:
- A kép. A PNG vagy SVG, amelyet az emberek egy profilon, egy diaképen vagy egy tanúsítványon látnak.
- Az assertion. Egy kis JSON-dokumentum, amely a tényeket rögzíti: ki a címzett (hash-elt azonosítóként), melyik jelvényosztályt szerezte meg, ki állította ki, mikor, és hol ellenőrizhető.
A baking az assertion képbe írása úgy, hogy a kettő ne legyen szétválasztható. Az eredmény egyetlen fájl. Ha valakinek átadod a PNG-t, a képet és a mögötte álló állítást is átadtad.
Az ötlet az Open Badges specifikációból származik, amelyet eredetileg a Mozilla fejlesztett, és ma az 1EdTech gondoz. A tervezés lényege a hordozhatóság. Eleinte a jelvények egyetlen platformon belül éltek, és egy másik helyre költöztetésük újrafeltöltést jelentett, a metaadatok túlélésében bízva. A sütött fájl magával viszi a saját metaadatait, bárhová kerül.
Hol él a JSON a PNG-ben
A PNG-fájl egy rövid aláírásból és chunkok sorozatából áll. Minden chunknak van hossza, négybetűs típusa, adata és ellenőrző összege. A megjelenítők az IDAT chunkokból rajzolják ki a pixeleket, és figyelmen kívül hagyják azokat a chunktípusokat, amelyeket nem értenek. Ez a tolerancia teszi lehetővé a bakinget: hozzáadhatsz egy szöveggel teli chunkot, és a világ minden képmegjelenítője továbbra is normálisan mutatja a képet.
Az Open Badges 2.0 esetén az assertion egy openbadges kulcsszavú szövegchunkba kerül. A szövegchunk-típusok, amelyek tárolhatják:
| Chunk | Kódolás | Megjegyzések |
|---|---|---|
tEXt | Latin-1 | Egyszerű, de Latin-1 karakterekre korlátozott. |
iTXt | UTF-8 | Előnyben részesített, mert a nevek és leírások gyakran nem ASCII-k. |
Bármelyik chunkot használják, az elrendezés ugyanaz: az openbadges kulcsszó, egy elválasztó, majd a tartalom. A tartalom két dolog egyike, attól függően, hogyan döntött a kibocsátó:
- Maga az assertion JSON. A fájl önleíró. Az ellenőrző hálózati hívás nélkül elolvashatja az állítást.
- Egy URL, amely a tárolt assertionre mutat. A fájl kisebb, és a kibocsátó az élő rekordot tarthatja mérvadónak, például hogy kimutassa, egy jelvényt később visszavontak vagy lejárt.
Létezik egy harmadik változat az aláírt jelvényekhez, ahol a tartalom sima JSON helyett aláírt token. Ha az aláírások fontosak a felhasználási esetedben, olvasd el, hogyan ellenőrizheted egy Open Badge aláírását.
És az SVG?
SVG jelvények is süthetők, mivel az SVG XML. Az assertion a fájlon belül egy openbadges XML-névterű elembe kerül, a verify attribútum pedig a tárolt assertion URL-jét hordozza. Az elv ugyanaz, mint a PNG-nél: a metaadatok a képfájlban utaznak. A gyakorlatban a legtöbb platform PNG-t süt, mert a PNG-t szinte mindenhol elfogadják, ahová jelvényt akarnak feltölteni.
Hogyan néz ki a beágyazott assertion
A 2.0 formátumban a tárolt assertion JSON-LD, amely összekapcsolja a címzettet, a jelvényosztályt és az ellenőrzési módszert. Egy rövidített példa:
{
"@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" }
}
Figyeld meg a címzettet. Az e-mail cím nincs egyszerű szövegként tárolva; sózott SHA-256 hash. Ez egy továbbadásra szánt fájlnál számít. Bárki, aki birtokolja a PNG-t, elolvashatja az assertiont, ezért az assertion nem szivárogtathatja ki a címzett címét. Az az ellenőrző, aki már ismeri az e-mail címet, ugyanazzal a sóval hash-elheti, és ellenőrizheti az egyezést. A dokumentum mezőnkénti bemutatásához lásd az Open Badge JSON-LD bemutatót.
Hogyan olvassa be az ellenőrző a sütött jelvényt
A sütött jelvény ellenőrzése rövid, mechanikus folyamat:
- Nyisd meg a PNG-t, és járd be a chunkjait.
- Keresd meg az
openbadgeskulcsszavú szövegchunkot. - Olvasd el a tartalmat. Ha JSON, elemezd. Ha URL, kérd le.
- Ellenőrizd, hogy az assertion a várt jelvényosztályra és kibocsátóra hivatkozik-e, és hogy a címzett azonosítója egyezik-e a bemutató személlyel.
- Ha az ellenőrzési típus
hosted, győződj meg róla, hogy a tárolt assertion még létezik azidURL-jén, és nem vonták vissza, illetve nem járt le.
Az 5. lépést szokták kihagyni, pedig ez teszi megbízhatóvá a hitelesítő adatot. A beágyazott másolat pillanatkép. A tárolt rekord az igazság forrása.
Olvasd be magad Node-dal
Bármely PNG-t megvizsgálhatsz egy rövid szkripttel. Ez bejárja a chunkokat, és kiírja az openbadges tartalmat, a tEXt és az iTXt esetét is kezelve:
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);
Futtasd így: node extract-badge.mjs my-badge.png. Ha a fájl sütött, JSON-t vagy URL-t látsz. Ha nem, egy sima „not baked” üzenetet kapsz. Ez oktatóeszköz, nem teljes értékű validátor: nem ellenőrzi a chunkok ellenőrző összegét, nem elemzi az aláírt tartalmat, és nem kéri le a tárolt rekordot.
Ha nem szeretnél kódot írni, egy online jelvényvalidátor vagy egy PNG-metaadatnéző ugyanazt a chunkot megmutatja. A formátum a szabvány, így bármely megfelelő eszköz beolvassa bármely megfelelő jelvényt.
Miért számít a baking
Hordozhatóság. Az a hitelesítő adat, amely csak egy PNG, elküldhető e-mailben, feltölthető egy tanulási platformra, vagy eltárolható egy személyes archívumban. Fiók nélkül is magaddal viheted.
Ellenőrzési út, amely túléli a kibocsátó marketingoldalát. A beágyazott assertion megnevezi a kibocsátót, és a tárolt rekordra mutat, így az ellenőrző pusztán a fájlból elindulhat.
Offline és low-tech munkafolyamatok. Ha a tartalom a teljes JSON, az olvasó hálózat nélküli gépen is ellenőrizheti az állítást, a tárolt rekordot pedig később.
Alkalmi hamisításnak nehezen ellenálló bizonyíték. Bárki készíthet képernyőképet egy jelvényről. A képernyőképnek nincs metaadata, így jelvényfájlként nem ellenőrizhető. Már ez is elválasztja a valódi hitelesítő adatot a lemásolt képtől. Azt nem akadályozza meg, hogy valaki hamis assertiont süssön egy ellopott képbe, ezért van szükség a tárolt rekord ellenőrzésére.
A baking korlátai
Légy őszinte a címzettekkel ezekről, mert befolyásolják, hogyan írod le a hitelesítő adataidat.
- A metaadatok lekerülnek. Sok közösségi hálózat, képoptimalizáló és üzenetküldő alkalmazás újrakódolja a feltöltéseket, és eldobja a nem pixeladatot tartalmazó chunkokat. Egy közösségi hírfolyamba posztolt sütött jelvény általában már nem sütött. Ez várható, és ezért számít a nyilvános ellenőrző link a fájl mellett.
- A baking önmagában nem bizonyíték. A beágyazott JSON-t bárki megírhatja. A bizalom a kibocsátó domainjén tárolt assertionből vagy érvényes aláírásból ered.
- A képszerkesztés megszakítja a kapcsolatot. Az átméretezés vagy a szerkesztőben való újramentés elveszítheti a chunkot.
- Csak PNG és SVG. A JPEG-nek nincs megfelelő chunk-konvenciója a specifikációban, ezért a JPEG-ként exportált, fotószerű jelvény nem süthető a szabványos módon.
A gyakorlati következtetés: a sütött fájlt kényelmes hordozónak tekintsd, az ellenőrző oldalt pedig mérvadó forrásnak. Ha formátumokat mérlegelsz a programodhoz, az Open Badges vs PDF tanúsítványok bemutatja, miért veri a gépileg olvasható hitelesítő adat a statikus dokumentumot.
Hogyan működik a baking a https://badges.ninja-n
Amikor jelvényt adományozol a https://badges.ninja-n, a platform felépíti az Open Badge assertiont az adott címzettnek, és a kiadás részeként belesüti a jelvény képébe. Nem kell eszközt beállítanod vagy parancsot futtatnod. A folyamat:
- Megtervezed a jelvényt a vizuális tervezőben, vagy feltöltöd a saját képedet.
- Kiadsz egy elismerést a vezérlőpultról, tömeges elismeréshez CSV-feltöltésből, vagy az API-n keresztül.
- A platform létrehozza az assertiont, belesüti a PNG-be, és az eredményt az elismeréssel együtt tárolja.
- A címzett kap egy nyilvános ellenőrző oldalt a
https://badges.ninja/awards/<awardId>címen, egy PDF-tanúsítványt, egy QR-kódot és egy Add to LinkedIn lehetőséget.
Ha a jelvény terve egyesítési mezőket használ, például a címzett nevét, minden elismerés személyre szabott képet kap, és a személyre szabott képet sütik.
A baking a kiadás kiegészítése, nem kapuja: ha egy adott kép nem süthető (például egy elfajult helyőrző kép), az elismerés ettől még kiadásra kerül az eredeti képpel, a nyilvános ellenőrző oldalt és az Open Badge JSON-LD-t pedig ez nem érinti. A feltöltött képnek egy minimális méretet is el kell érnie, így egy apró üres vásznat elutasít a rendszer, mielőtt a sütödéhez érne.
Mivel a nyilvános oldal a mérvadó, bárki ellenőrizhet egy elismerést regisztráció nélkül. Az elismerés gépileg olvasható Open Badge v2.0 JSON-LD-je a https://api.badges.ninja/certify-badge/award/<awardId> címen érhető el.
Egy elismerés kiadása API-val
A legtöbb olvasó a vezérlőpultot használja, de ha automatizálod a kiadást, egyetlen kérés létrehozza az elismerést (és a sütött kép vele együtt jön). Cseréld le a kulcsot és a jelvényazonosítót a sajátodra:
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}`;
A hívás HTTP 200-at ad vissza { "awardId": "<guid>" } tartalommal. Ebből az azonosítóból építsd fel az ellenőrző URL-t. A kulcs beállításához és a teljes kérésleíráshoz lásd az Awards API dokumentációt és a hitelesítési útmutatót.

Gyakorlati tanácsok kibocsátóknak
Mindig tegyél közzé ellenőrző linket a fájl mellett. Tedd a linket az elismerő e-mailbe, a tanúsítványra, és minden oldalra, ahol a jelvény megjelenik. Mivel a közösségi platformok lehúzzák a metaadatokat, a link tartja ellenőrizhetően a hitelesítő adatot megosztás után.
Használj tiszta, megfelelő méretű forrásképet. Valódi méretű PNG-ből indulj ki. Egy tervező által készített, normál felbontású jelvény megbízhatóan sütődik; egy 1 pixeles helyőrző nem.
Ne szerkeszd a kézbesített fájlt. Mondd meg a címzetteknek, hogy az eredeti letöltést vagy az ellenőrző linket osszák meg, ne egy körbevágott képernyőképet.
Döntsd el, mit mondasz a visszavonásról és a lejáratról. Mivel a tárolt rekord a mérvadó, egy sütött fájl túlélheti a hitelesítő adat státuszát. Mondd ki ezt világosan a programdokumentációdban, hogy a munkáltatók az ellenőrző oldalt nézzék meg, és ne csak a fájlban bízzanak.
Tesztelj egy jelvényt elejétől a végéig. Adj ki egy elismerést magadnak, töltsd le a PNG-t, futtasd át a fenti szkripten vagy egy nyilvános validátoron, és nyisd meg az ellenőrző linket. Öt perc tesztelés megmutatja, mit tapasztalnak majd a címzettjeid.

Gyakran ismételt kérdések
A sütött jelvény ugyanaz, mint a digitális tanúsítvány? Nem. A tanúsítvány általában olvasásra és nyomtatásra szánt PDF. A sütött jelvény olyan kép, amely gépileg olvasható hitelesítőadat-adatokat is hordoz. A https://badges.ninja mindkettőt ugyanabból az elismerésből állítja elő.
Süthetek jelvényt platform nélkül? Igen. A specifikáció nyílt, és több nyelvhez léteznek könyvtárak. A nehezebb rész az assertion tárolása stabil URL-en, ami értelmessé teszi az ellenőrzést. Ezt a részt a platform elvégzi helyetted.
Felfedi a baking a címzett e-mail címét? Nem, ha az azonosító hash-elt. Az assertion sózott hasht tárol, így a fájl nem fedi fel a címet.
Olvassa a LinkedIn a sütött adatot? A LinkedIn Add to Profile folyamata a hitelesítő adat nevéből, a kibocsátóból, a dátumból és az URL-ből dolgozik, nem a fájl metaadataiból. Lásd az Add to LinkedIn gomb hozzáadását.
Összefoglalás
A sütött Open Badge egy PNG (vagy SVG), amelybe a hitelesítő adatot egy openbadges nevű szövegchunkba írták. Hordozhatóvá és önleíróvá teszi a jelvényt, de az igazi bizalom a kibocsátó domainjén tárolt assertionből jön. Süss a hordozhatóságért, tegyél közzé ellenőrző linket a bizalomért, és számíts rá, hogy a közösségi hálózatok lehúzzák a metaadatokat.
Készen állsz az első ellenőrizhető hitelesítő adatod kiadására? Kezdd ingyen a badges.ninja-n — vizuális tervező, nyilvános ellenőrző oldal, PDF-tanúsítvány, Open Badge v2.0 kimenet. Bankkártya nélkül.
Hogyan készült ez a cikk
A blog egyes bejegyzéseit AI-asszisztens segítségével írjuk, majd közzététel előtt a Badges Ninja csapata ellenőrzi, tényellenőrzi és szerkeszti. Minden kódrészletet és árat az élő termékkel egyeztetve ellenőrzünk. Szerkesztési és AI-folyamatunkról bővebben olvashat a szerkesztési folyamat oldalunkon .

A szerzőről
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.
Több cikk tőle: Nacho Coll
- Coding bootcamp Open Badges: ellenőrizhető igazolások kibocsátása évfolyamméretben2026. nov. 19. · 10perc olvasás
- Webhookok beállítása jelvényeseményekhez: valós idejű integráció a backendeddel2026. nov. 16. · 8perc olvasás
- Open Badge lejárat és megújítás: életciklus-kezelés időkorlátos tanúsítványokhoz2026. nov. 12. · 10perc olvasás


