Baking v Open Badge vysvětleno: jak JSON žije uvnitř PNG

„Upečený“ Open Badge je PNG s JSON asercí vloženou jako metadata obrázku. Soubor odznaku JE ověřitelné osvědčení. Jak baking funguje a jak ověřit upečený odznak.

Nacho Coll Autor Aktualizováno 10 min čtení
„Upečený“ Open Badge je PNG s JSON asercí vloženou jako metadata obrázku. Soubor odznaku JE ověřitelné osvědčení. Jak baking funguje a jak ověřit upečený odznak.

Stáhněte si Open Badge od téměř libovolného vydavatele a dostanete běžně vypadající PNG. Vložte ho do chatu, přiložte k e-mailu, vytiskněte. Vypadá jako každý jiný obrázek. Soubor ale nese druhou, neviditelnou vrstvu: samotné osvědčení, zapsané do obrázku jako metadata. Komunita kolem Open Badges tomu říká upečený odznak (baked badge) a právě proto může odznak putovat jako jediný soubor a přesto prokázat, kdo ho vydal, komu a za co.

Tento průvodce vysvětluje, co baking je, kde v souboru data leží, jak je ověřovatel čte zpět a co musíte rozhodnout jako ten, kdo osvědčení vydává. K používání upečených odznaků nemusíte psát kód. Pokud vydáváte přes https://badges.ninja, baking proběhne za vás. Pochopení mechaniky ale pomáhá odpovídat na otázky, které příjemci a zaměstnavatelé skutečně kladou: „Je ten obrázek pravý?“ a „Nemůže si ho prostě někdo zkopírovat?“

Co znamená „baking“

Open Badge má dvě části, které se snadno pletou:

  • Obrázek. PNG nebo SVG, které lidé vidí na profilu, snímku prezentace nebo certifikátu.
  • Aserce. Malý JSON dokument, který uvádí fakta: kdo je příjemce (jako hashovaný identifikátor), jaká třída odznaku byla získána, kdo ji vydal, kdy a kde ji ověřit.

Baking je zapsání asserce do obrázku tak, aby je nešlo oddělit. Výsledkem je jeden soubor. Předáte někomu PNG a předali jste mu obrázek i tvrzení, které za ním stojí.

Myšlenka pochází ze specifikace Open Badges, kterou původně vyvinula Mozilla a dnes ji spravuje 1EdTech. Smyslem návrhu je přenositelnost. Zpočátku odznaky žily uvnitř jedné platformy a přesun jinam znamenal znovu nahrávat a doufat, že metadata přežijí. Upečený soubor si svá metadata nese všude s sebou.

Kde v PNG leží JSON

Soubor PNG je krátká signatura následovaná posloupností chunků. Každý chunk má délku, čtyřpísmenný typ, data a kontrolní součet. Prohlížeče vykreslují pixely z chunků IDAT a typy chunků, kterým nerozumějí, ignorují. Právě tato tolerance baking umožňuje: můžete přidat chunk plný textu a každý prohlížeč obrázků na světě stále zobrazí obrázek normálně.

U Open Badges 2.0 se asserce ukládá do textového chunku s klíčovým slovem openbadges. Typy textových chunků, které ji mohou pojmout:

ChunkKódováníPoznámky
tEXtLatin-1Jednoduchý, ale omezený na znaky Latin-1.
iTXtUTF-8Preferovaný, protože jména a popisy často nejsou ASCII.

Ať se použije kterýkoli chunk, uspořádání je stejné: klíčové slovo openbadges, oddělovač, pak obsah. Obsah je jedna ze dvou věcí podle toho, jak se vydavatel rozhodl péct:

  1. Samotný JSON asserce. Soubor je samopopisný. Ověřovatel si může přečíst tvrzení bez jakéhokoli síťového volání.
  2. URL odkazující na hostovanou asserci. Soubor je menší a vydavatel může nechat živý záznam jako závazný, například aby ukázal, že odznak byl později odvolán nebo mu vypršela platnost.

Pro podepsané odznaky existuje třetí varianta, kde je obsahem podepsaný token místo prostého JSON. Pokud pro vás podpisy hrají roli, přečtěte si jak ověřit podpis Open Badge.

A co SVG?

SVG odznaky lze péct také, protože SVG je XML. Asserce se umístí do souboru v elementu jmenného prostoru XML openbadges a atribut verify nese URL hostované asserce. Princip je stejný jako u PNG: metadata cestují uvnitř souboru obrázku. V praxi většina platforem peče PNG, protože PNG se přijímá téměř všude, kam lidé chtějí odznak nahrát.

Jak vypadá vložená asserce

U formátu 2.0 je hostovaná asserce JSON-LD, který propojuje příjemce, třídu odznaku a způsob ověření. Zkrácený pří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šimněte si příjemce. E-mail není uložen v čitelné podobě; je to hash SHA-256 se solí. To je důležité u souboru, který je určený k předávání. Kdokoli, kdo drží PNG, může asserci přečíst, takže nesmí prozradit adresu příjemce. Ověřovatel, který e-mail už zná, ho může stejnou solí zahashovat a zkontrolovat shodu. Podrobný průchod tímto dokumentem pole po poli najdete v průvodci JSON-LD pro Open Badge.

Jak ověřovatel čte upečený odznak

Ověření upečeného odznaku je krátký mechanický postup:

  1. Otevřete PNG a projděte jeho chunky.
  2. Najděte textový chunk s klíčovým slovem openbadges.
  3. Přečtěte obsah. Pokud je to JSON, zpracujte ho. Pokud je to URL, stáhněte ho.
  4. Zkontrolujte, že se asserce vztahuje k očekávané třídě odznaku a vydavateli a že identita příjemce odpovídá osobě, která odznak předkládá.
  5. Pokud je typ ověření hosted, potvrďte, že hostovaná asserce stále existuje na URL v poli id a nebyla odvolána ani jí nevypršela platnost.

Krok 5 lidé přeskakují, a přitom právě on činí osvědčení důvěryhodným. Vložená kopie je snímek. Zdrojem pravdy je hostovaný záznam.

Čtení vlastními silami v Node

Libovolné PNG můžete prozkoumat krátkým skriptem. Tento projde chunky a vypíše obsah openbadges, přičemž zvládá tEXt i 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);

Spusťte ho příkazem node extract-badge.mjs my-badge.png. Pokud je soubor upečený, uvidíte JSON nebo URL. Pokud ne, dostanete prostou zprávu „not baked“. Je to ukázkový nástroj, ne plnohodnotný validátor: nekontroluje kontrolní součty chunků, nezpracovává podepsané obsahy ani nestahuje hostovaný záznam.

Pokud nechcete psát kód, ukáže stejný chunk online validátor odznaků nebo prohlížeč metadat PNG. Formát je standard, takže každý kompatibilní nástroj přečte každý kompatibilní odznak.

Proč baking záleží

Přenositelnost. Osvědčení, které je jen PNG, lze poslat e-mailem, nahrát na vzdělávací platformu nebo uložit do osobního archivu. K jeho přenášení není potřeba žádný účet.

Cesta k ověření, která přežije marketingový web vydavatele. Vložená asserce jmenuje vydavatele a odkazuje na hostovaný záznam, takže ověřovatel může začít jen se souborem.

Offline a nenáročné postupy. Když je obsahem celý JSON, čtenář může tvrzení zkontrolovat na stroji bez sítě a hostovaný záznam ověřit později.

Důkaz, který se mimochodem těžko padělá. Snímek obrazovky odznaku pořídí kdokoli. Snímek nemá metadata, takže ho nelze ověřit jako soubor odznaku. Už to odděluje skutečné osvědčení od zkopírovaného obrázku. Nezabrání to ale tomu, aby někdo upekl padělanou asserci do ukradeného obrázku, a proto existuje krok ověření hostovaného záznamu.

Limity bakingu

Buďte k příjemcům upřímní, protože ovlivňují to, jak svá osvědčení popisujete.

  • Metadata se odstraňují. Mnoho sociálních sítí, optimalizátorů obrázků a komunikátorů nahrané soubory překódovává a zahazuje chunky, které nejsou pixely. Upečený odznak zveřejněný na sociální síti už obvykle upečený není. To je očekávané a proto je vedle souboru důležitý veřejný odkaz k ověření.
  • Baking sám o sobě není důkaz. Vložený JSON může napsat kdokoli. Důvěra pochází z hostované asserce na doméně vydavatele nebo z platného podpisu.
  • Úpravy obrázku vazbu přeruší. Změna velikosti nebo opětovné uložení v editoru může chunk ztratit.
  • Pouze PNG a SVG. JPEG nemá ve specifikaci ekvivalentní konvenci chunků, takže odznak ve stylu fotografie exportovaný do JPEG nelze standardním způsobem upéct.

Praktický závěr: berte upečený soubor jako pohodlný nosič a stránku s ověřením jako autoritu. Pokud pro svůj program vybíráte formáty, Open Badges vs. PDF certifikáty vysvětluje, proč strojově čitelné osvědčení poráží statický dokument.

Jak baking funguje na https://badges.ninja

Když na https://badges.ninja udělíte odznak, platforma sestaví asserci Open Badge pro daného příjemce a při vydání ji upeče do obrázku odznaku. Nenastavujete žádný nástroj ani nespouštíte žádný příkaz. Postup:

  1. Odznak navrhnete ve vizuálním návrháři, nebo nahrajete vlastní obrázek.
  2. Vydáte ocenění z dashboardu, z nahraného CSV pro hromadná ocenění nebo přes API.
  3. Platforma vytvoří asserci, upeče ji do PNG a výsledek uloží k ocenění.
  4. Příjemce dostane veřejnou stránku k ověření na https://badges.ninja/awards/<awardId>, PDF certifikát, QR kód a možnost Přidat na LinkedIn.

Pokud návrh odznaku používá slučovací pole, například jméno příjemce, každé ocenění dostane personalizovaný obrázek a právě ten personalizovaný obrázek se peče.

Baking se považuje za vylepšení vydávání, ne za bránu: pokud konkrétní obrázek nelze upéct (například degenerovaný zástupný obrázek), ocenění se přesto vydá s původním obrázkem a veřejná stránka k ověření i JSON-LD Open Badge zůstanou nedotčeny. Nahrávaný obrázek musí také splnit minimální velikost, takže drobné prázdné plátno je odmítnuto dřív, než se dostane do pekárny.

Protože autoritou je veřejná stránka, může kdokoli ocenění ověřit bez registrace. Strojově čitelný JSON-LD Open Badge v2.0 pro ocenění je dostupný na https://api.badges.ninja/certify-badge/award/<awardId>.

Vydání jednoho ocenění přes API

Většina čtenářů použije dashboard, ale pokud vydávání automatizujete, jeden požadavek vytvoří ocenění (a upečený obrázek je jeho součástí). Nahraďte klíč a ID odznaku 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}`;

Volání vrací HTTP 200 s { "awardId": "<guid>" }. Z tohoto ID sestavte URL k ověření. Nastavení klíče a úplný popis požadavků najdete v dokumentaci Awards API a v průvodci autentizací.

Badge detail screen in the https://badges.ninja dashboard

Praktické rady pro vydavatele

Vždy zveřejněte odkaz k ověření vedle souboru. Umístěte odkaz do e-mailu s oceněním, na certifikát a na každou stránku, kde se odznak zobrazuje. Protože sociální platformy metadata odstraňují, právě odkaz udržuje osvědčení ověřitelné i po sdílení.

Používejte čistý zdrojový obrázek rozumné velikosti. Začněte s PNG se skutečnými rozměry. Odznak vytvořený grafikem v běžném rozlišení se peče spolehlivě; jednopixelový zástupný obrázek ne.

Nijak neupravujte doručený soubor. Řekněte příjemcům, ať sdílejí původní stažený soubor nebo odkaz k ověření, ne oříznutý snímek obrazovky.

Rozhodněte se, co chcete říct o odvolání a vypršení platnosti. Protože je hostovaný záznam závazný, upečený soubor může přežít stav osvědčení. Napište to jasně do dokumentace programu, aby zaměstnavatelé věděli, že mají zkontrolovat stránku s ověřením, a ne věřit samotnému souboru.

Otestujte jeden odznak od začátku do konce. Vydejte ocenění sobě, stáhněte PNG, proženete ho výše uvedeným skriptem nebo veřejným validátorem a otevřete odkaz k ověření. Pět minut testování vám ukáže, co zažijí vaši příjemci.

List of badges in the https://badges.ninja dashboard

Často kladené otázky

Je upečený odznak totéž co digitální certifikát? Ne. Certifikát je obvykle PDF ke čtení a tisku. Upečený odznak je obrázek, který zároveň nese strojově čitelná data osvědčení. https://badges.ninja vytváří obojí ze stejného ocenění.

Mohu upéct odznak bez platformy? Ano. Specifikace je otevřená a knihovny existují pro několik jazyků. Těžší je hostovat asserci na stabilní URL, což dává ověření smysl. Tuto část za vás vyřeší platforma.

Prozrazuje baking e-mail příjemce? Ne, když je identita hashovaná. Asserce ukládá hash se solí, takže soubor adresu neodhalí.

Přečte LinkedIn upečená data? Tok Přidat do profilu na LinkedIn vychází z názvu osvědčení, vydavatele, data a URL, ne z metadat souboru. Viz přidání tlačítka Přidat na LinkedIn.

Shrnutí

Upečený Open Badge je PNG (nebo SVG) s osvědčením zapsaným v textovém chunku s názvem openbadges. Díky tomu je odznak přenositelný a samopopisný, ale skutečná důvěra pochází z hostované asserce na doméně vydavatele. Pečte kvůli přenositelnosti, zveřejňujte odkaz k ověření kvůli důvěře a počítejte s tím, že sociální sítě metadata odstraní.

Připraveni vydat své první ověřitelné osvědčení? Začněte zdarma na badges.ninja — vizuální návrhář, veřejná stránka k ověření, PDF certifikát, výstup Open Badge v2.0. Není potřeba kreditní karta.

Nacho Coll

O autorovi

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.

Zpět na Blog

Související články