Baking Open Badge vysvetlený: ako JSON žije vnútri PNG
„Upečený“ (baked) Open Badge je PNG s JSON-om osvedčenia vloženým ako metadáta obrázka. Súbor odznaku JE samotné osvedčenie. Ako baking funguje a ako overiť upečený odznak.
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.
Stiahnite si Open Badge od takmer ktoréhokoľvek vydavateľa a dostanete bežne vyzerajúci PNG. Vložte ho do chatu, priložte k e-mailu, vytlačte. Vyzerá ako každý iný obrázok. Súbor však nesie druhú, neviditeľnú vrstvu: samotné osvedčenie zapísané do obrázka ako metadáta. Komunita okolo Open Badges to nazýva upečený odznak (baked badge) a je to dôvod, prečo môže odznak cestovať ako jediný súbor a stále dokazovať, kto ho vydal, komu a za čo.
Tento sprievodca vysvetľuje, čo je baking, kde sa v súbore dáta nachádzajú, ako ich overovateľ načíta späť a čo sa musíte rozhodnúť ako vydavateľ osvedčení. Na používanie upečených odznakov nemusíte písať kód. Ak vydávate cez https://badges.ninja, baking sa deje za vás. Pochopenie mechaniky vám však pomôže odpovedať na otázky, ktoré príjemcovia a zamestnávatelia naozaj kladú: „Je tento obrázok pravý?“ a „Môže si ho niekto jednoducho skopírovať?“
Čo znamená „baking“
Open Badge má dve časti, ktoré sa dajú ľahko zamieňať:
- Obrázok. PNG alebo SVG, ktoré ľudia vidia v profile, na slajde alebo na certifikáte.
- Tvrdenie (assertion). Malý JSON dokument, ktorý uvádza fakty: kto je príjemca (ako hashovaný identifikátor), ktorá trieda odznaku bola získaná, kto ju vydal, kedy a kde sa dá overiť.
Baking je zápis assertion do obrázka tak, aby sa tieto dve časti nedali oddeliť. Výsledkom je jeden súbor. Keď niekomu odovzdáte PNG, odovzdali ste mu obrázok aj tvrdenie, ktoré za ním stojí.
Myšlienka pochádza zo špecifikácie Open Badges, ktorú pôvodne vyvinula Mozilla a dnes ju spravuje 1EdTech. Zmyslom návrhu je prenosnosť. Spočiatku odznaky žili v jedinej platforme a presun na nové miesto znamenal opätovné nahratie a nádej, že metadáta prežijú. Upečený súbor nesie svoje metadáta so sebou, kamkoľvek ide.
Kde JSON žije vnútri PNG
Súbor PNG je krátka signatúra, za ktorou nasleduje postupnosť chunkov. Každý chunk má dĺžku, štvorpísmenový typ, nejaké dáta a kontrolný súčet. Prehliadače vykresľujú pixely z chunkov IDAT a ignorujú typy chunkov, ktorým nerozumejú. Práve táto tolerancia umožňuje baking: môžete pridať chunk plný textu a každý prehliadač obrázkov na svete bude obrázok naďalej zobrazovať normálne.
Pre Open Badges 2.0 ide assertion do textového chunku s kľúčovým slovom openbadges. Typy textových chunkov, ktoré ho môžu obsahovať:
| Chunk | Kódovanie | Poznámky |
|---|---|---|
tEXt | Latin-1 | Jednoduché, ale obmedzené na znaky Latin-1. |
iTXt | UTF-8 | Preferované, pretože mená a popisy často nie sú ASCII. |
Bez ohľadu na použitý chunk je usporiadanie rovnaké: kľúčové slovo openbadges, oddeľovač a potom obsah (payload). Payload je jedna z dvoch vecí podľa toho, ako sa vydavateľ rozhodol piecť:
- Samotný assertion JSON. Súbor je samopopisný. Overovateľ môže prečítať tvrdenie bez jediného sieťového volania.
- URL odkazujúce na hostovaný assertion. Súbor je menší a vydavateľ môže ponechať živý záznam ako autoritatívny, napríklad aby ukázal, že odznak bol neskôr odvolaný alebo mu skončila platnosť.
Existuje aj tretí variant pre podpísané odznaky, kde je payload podpísaný token namiesto čistého JSON-u. Ak sú pre váš prípad použitia podpisy dôležité, prečítajte si ako overiť podpis Open Badge.
A čo SVG?
SVG odznaky sa dajú piecť tiež, keďže SVG je XML. Assertion sa umiestni do súboru v prvku z XML priestoru mien openbadges a atribút verify nesie URL hostovaného assertion. Princíp je rovnaký ako pri PNG: metadáta cestujú vnútri súboru obrázka. V praxi väčšina platforiem pečie PNG, pretože PNG sa akceptuje takmer všade, kde ľudia chcú odznak nahrať.
Ako vyzerá vložený assertion
Pre formát 2.0 je hostovaný assertion JSON-LD, ktorý prepája príjemcu, triedu odznaku a spôsob overenia. Skrátený príklad:
{
"@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" }
}
Všimnite si príjemcu. E-mail nie je uložený v čitateľnej podobe; je to hash SHA-256 so salt. Je to dôležité pri súbore určenom na rozosielanie. Každý, kto drží PNG, môže assertion prečítať, takže nesmie prezradiť adresu príjemcu. Overovateľ, ktorý e-mail už pozná, ho môže zahashovať rovnakým salt a skontrolovať zhodu. Prehliadku tohto dokumentu pole po poli nájdete v rozbore Open Badge JSON-LD.
Ako overovateľ číta upečený odznak
Overenie upečeného odznaku je krátky, mechanický proces:
- Otvorte PNG a prejdite jeho chunky.
- Nájdite textový chunk s kľúčovým slovom
openbadges. - Prečítajte payload. Ak je to JSON, spracujte ho. Ak je to URL, stiahnite ho.
- Skontrolujte, či sa assertion vzťahuje na triedu odznaku a vydavateľa, ktorých očakávate, a či identita príjemcu zodpovedá osobe, ktorá ho predkladá.
- Ak je typ overenia
hosted, potvrďte, že hostovaný assertion na svojejidURL stále existuje a nebol odvolaný ani mu neskončila platnosť.
Krok 5 je ten, ktorý ľudia vynechávajú, a práve on robí osvedčenie dôveryhodným. Vložená kópia je snímka. Hostovaný záznam je zdrojom pravdy.
Prečítajte si to sami v Node
Ľubovoľný PNG môžete preskúmať krátkym skriptom. Tento prechádza chunky a vypíše payload openbadges, pričom zvláda tEXt aj 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);
Spustite ho príkazom node extract-badge.mjs my-badge.png. Ak je súbor upečený, uvidíte JSON alebo URL. Ak nie, dostanete jednoduchú správu „not baked“. Je to učebná pomôcka, nie plnohodnotný validátor: nekontroluje kontrolné súčty chunkov, nespracúva podpísané payloady ani nesťahuje hostovaný záznam.
Ak by ste radšej nepísali kód, online validátor odznakov alebo prehliadač metadát PNG zobrazí ten istý chunk. Formát je štandard, takže každý vyhovujúci nástroj prečíta každý vyhovujúci odznak.
Prečo je baking dôležitý
Prenosnosť. Osvedčenie, ktoré je len PNG, sa dá poslať e-mailom, nahrať na vzdelávaciu platformu alebo uložiť do osobného archívu. Na jeho prenášanie nie je potrebný účet.
Cesta k overeniu, ktorá prežije marketingový web vydavateľa. Vložený assertion pomenúva vydavateľa a odkazuje na hostovaný záznam, takže overovateľ môže začať iba zo súboru.
Offline a nízkotechnologické postupy. Keď je payload úplný JSON, čitateľ môže tvrdenie skontrolovať na stroji bez siete a hostovaný záznam overiť neskôr.
Dôkaz, ktorý sa ťažko len tak sfalšuje. Snímku obrazovky odznaku urobí každý. Snímka obrazovky nemá metadáta, takže sa nedá overiť ako súbor odznaku. Už to oddeľuje skutočné osvedčenie od skopírovaného obrázka. Nebráni to však nikomu, aby do ukradnutého obrázka upiekol sfalšovaný assertion, a preto existuje krok overenia hostovaného záznamu.
Limity bakingu
Buďte k príjemcom úprimní, pretože ovplyvňujú to, ako svoje osvedčenia opisujete.
- Metadáta sa odstraňujú. Mnohé sociálne siete, optimalizátory obrázkov a aplikácie na správy nahraté súbory znovu kódujú a zahadzujú chunky, ktoré nie sú pixelmi. Upečený odznak zverejnený na sociálnej sieti už zvyčajne upečený nie je. Je to očakávané a preto je popri súbore dôležitý verejný odkaz na overenie.
- Baking sám osebe nie je dôkaz. Vložený JSON môže napísať ktokoľvek. Dôvera pochádza z hostovaného assertion na doméne vydavateľa alebo z platného podpisu.
- Úpravy obrázka prerušia väzbu. Zmena veľkosti alebo opätovné uloženie v editore môže chunk stratiť.
- Iba PNG a SVG. JPEG nemá v špecifikácii ekvivalentnú konvenciu chunkov, takže odznak v štýle fotografie exportovaný ako JPEG sa štandardným spôsobom upiecť nedá.
Praktický záver: upečený súbor berte ako pohodlný nosič a stránku overenia ako autoritu. Ak porovnávate formáty pre svoj program, Open Badges vs PDF certifikáty vysvetľuje, prečo strojovo čitateľné osvedčenie poráža statický dokument.
Ako baking funguje vo https://badges.ninja
Keď udelíte odznak vo https://badges.ninja, platforma zostaví Open Badge assertion pre daného príjemcu a v rámci vydania ho upečie do obrázka odznaku. Nenastavujete žiadny nástroj ani nespúšťate príkaz. Postup:
- Odznak navrhnete vo vizuálnom dizajnéri alebo nahráte vlastný obrázok.
- Udelenie vydáte z dashboardu, z nahratia CSV pri hromadných udeleniach alebo cez API.
- Platforma vytvorí assertion, upečie ho do PNG a výsledok uloží spolu s udelením.
- Príjemca dostane verejnú stránku overenia na
https://badges.ninja/awards/<awardId>, PDF certifikát, QR kód a možnosť Add to LinkedIn.
Ak dizajn odznaku používa polia zlúčenia (merge fields), napríklad meno príjemcu, každé udelenie dostane personalizovaný obrázok a práve ten personalizovaný obrázok sa pečie.
Baking sa považuje za vylepšenie vydávania, nie za bránu: ak sa konkrétny obrázok nedá upiecť (napríklad degenerovaný zástupný obrázok), udelenie sa stále vydá s pôvodným obrázkom a verejná stránka overenia aj Open Badge JSON-LD zostanú nedotknuté. Nahrávaný obrázok musí zároveň spĺňať minimálnu veľkosť, takže drobné prázdne plátno sa odmietne ešte predtým, než sa dostane do „pekárne“.
Keďže verejná stránka je autoritou, ktokoľvek môže udelenie skontrolovať bez registrácie. Strojovo čitateľný Open Badge v2.0 JSON-LD pre udelenie je dostupný na https://api.badges.ninja/certify-badge/award/<awardId>.
Vydanie jedného udelenia cez API
Väčšina čitateľov použije dashboard, ale ak vydávanie automatizujete, jedna požiadavka vytvorí udelenie (a upečený obrázok príde s ním). Kľúč a id odznaku nahraďte vlastnými:
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}`;
Volanie vráti HTTP 200 s { "awardId": "<guid>" }. URL overenia zostavte z tohto id. Nastavenie kľúča a úplný popis požiadaviek nájdete v dokumentácii Awards API a v sprievodcovi autentifikáciou.

Praktické rady pre vydavateľov
Vždy zverejnite odkaz na overenie vedľa súboru. Vložte odkaz do e-mailu o udelení, na certifikát a na každú stránku, kde sa odznak zobrazuje. Keďže sociálne platformy metadáta odstraňujú, práve odkaz zachováva overiteľnosť osvedčenia po zdieľaní.
Použite čistý obrázok primeranej veľkosti. Začnite s PNG so skutočnými rozmermi. Odznak od dizajnéra v bežnom rozlíšení sa pečie spoľahlivo; 1-pixelový zástupný obrázok nie.
Nedoručený súbor neupravujte. Povedzte príjemcom, aby zdieľali pôvodné stiahnutie alebo odkaz na overenie, nie orezanú snímku obrazovky.
Rozhodnite sa, čo chcete povedať o odvolaní a vypršaní platnosti. Keďže hostovaný záznam je autoritatívny, upečený súbor môže prežiť stav osvedčenia. Jasne to uveďte v dokumentácii programu, aby zamestnávatelia vedeli skontrolovať stránku overenia a nespoliehali sa iba na súbor.
Otestujte jeden odznak od začiatku do konca. Vydajte udelenie sebe, stiahnite PNG, pustite ho cez skript vyššie alebo verejný validátor a otvorte odkaz na overenie. Päť minút testovania vám ukáže, čo zažijú vaši príjemcovia.

Často kladené otázky
Je upečený odznak to isté ako digitálny certifikát? Nie. Certifikát je zvyčajne PDF na čítanie a tlač. Upečený odznak je obrázok, ktorý zároveň nesie strojovo čitateľné údaje o osvedčení. https://badges.ninja vytvára oboje z toho istého udelenia.
Môžem upiecť odznak bez platformy? Áno. Špecifikácia je otvorená a knižnice existujú pre viaceré jazyky. Ťažšou časťou je hostovanie assertion na stabilnej URL, čo robí overenie zmysluplným. Túto časť za vás rieši platforma.
Prezrádza baking e-mail príjemcu? Nie, ak je identita hashovaná. Assertion ukladá hash so salt, takže súbor adresu neodhalí.
Prečíta LinkedIn upečené dáta? Tok Add to Profile na LinkedIn funguje z názvu osvedčenia, vydavateľa, dátumu a URL, nie z metadát súboru. Pozrite si pridanie tlačidla Add to LinkedIn.
Zhrnutie
Upečený Open Badge je PNG (alebo SVG) s osvedčením zapísaným do textového chunku s názvom openbadges. Robí odznak prenosným a samopopisným, no skutočná dôvera pochádza z hostovaného assertion na doméne vydavateľa. Pečte kvôli prenosnosti, zverejnite odkaz na overenie kvôli dôvere a počítajte s tým, že sociálne siete metadáta odstránia.
Ste pripravení vydať svoje prvé overiteľné osvedčenie? Začnite zadarmo na badges.ninja — vizuálny dizajnér, verejná stránka overenia, PDF certifikát, výstup Open Badge v2.0. Bez kreditnej karty.
Ako vznikol tento článok
Niektoré príspevky na tomto blogu vznikajú s pomocou AI asistenta a pred publikovaním ich kontroluje, overuje a upravuje tím Badges Ninja. Každá ukážka kódu a cena je overená priamo v produkte. Viac o našom redakčnom a AI procese nájdete na našej stránke o redakčnom procese .

O autorovi
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.
Viac od Nacho Coll
- Open Badges pre programátorské bootcampy: overiteľné osvedčenia v rozsahu celého ročníka19. 11. 2026 · 10min čítania
- Nastavenie webhookov pre udalosti odznakov: integrácia v reálnom čase s vaším backendom16. 11. 2026 · 8min čítania
- Platnosť a obnovenie Open Badge: správa životného cyklu časovo obmedzených osvedčení12. 11. 2026 · 10min čítania


