Open Badge baking objašnjen: kako JSON živi unutar PNG-a

„Baked” Open Badge je PNG s JSON-om tvrdnje (assertion) ugrađenim kao metapodaci slike. Datoteka značke JE vjerodajnica. Kako baking funkcionira i kako provjeriti baked značku.

Nacho Coll Autor: Ažurirano 10 min čitanja
„Baked” Open Badge je PNG s JSON-om tvrdnje (assertion) ugrađenim kao metapodaci slike. Datoteka značke JE vjerodajnica. Kako baking funkcionira i kako provjeriti baked značku.

Preuzmite Open Badge od gotovo bilo kojeg izdavatelja i dobit ćete PNG običnog izgleda. Ubacite ga u chat, priložite e-poruci, isprintajte. Izgleda kao bilo koja druga slika. No datoteka nosi i drugi, nevidljivi sloj: samu vjerodajnicu, upisanu u sliku kao metapodatke. To zajednica Open Badgesa naziva baked značkom, i zato značka može putovati kao jedna datoteka, a opet dokazivati tko ju je izdao, kome i za što.

Ovaj vodič objašnjava što je baking, gdje se podaci nalaze unutar datoteke, kako ih provjeravatelj ponovno čita i što trebate odlučiti kao izdavatelj vjerodajnica. Za korištenje baked znački ne morate pisati kod. Ako izdajete putem https://badges.ninja, baking se događa umjesto vas. No razumijevanje mehanike pomaže vam odgovoriti na pitanja koja primatelji i poslodavci doista postavljaju: „Je li ova slika prava?” i „Može li je itko jednostavno kopirati?”

Što znači „baking”

Open Badge ima dva dijela koja je lako pomiješati:

  • Slika. PNG ili SVG koji ljudi vide na profilu, slajdu ili certifikatu.
  • Tvrdnja (assertion). Mali JSON dokument koji iznosi činjenice: tko je primatelj (kao hashirani identifikator), koja je klasa značke zaslužena, tko je izdavatelj, kada je izdana i gdje se može provjeriti.

Baking je čin upisivanja tvrdnje u sliku tako da se to dvoje ne može razdvojiti. Rezultat je jedna datoteka. Kad nekome date PNG, dali ste mu i sliku i tvrdnju koja stoji iza nje.

Ideja potječe iz specifikacije Open Badges koju je izvorno razvio Mozilla, a danas je održava 1EdTech. Smisao dizajna je prenosivost. Na početku su značke živjele unutar jedne platforme, a premještanje na novo mjesto značilo je ponovno učitavanje i nadu da će metapodaci preživjeti. Baked datoteka sa sobom nosi vlastite metapodatke kamo god ide.

Gdje JSON živi unutar PNG-a

PNG datoteka je kratak potpis nakon kojeg slijedi niz chunkova. Svaki chunk ima duljinu, tip od četiri slova, neke podatke i kontrolni zbroj. Preglednici crtaju piksele iz IDAT chunkova i zanemaruju tipove chunkova koje ne razumiju. Upravo ta tolerancija omogućuje baking: možete dodati chunk pun teksta, a svaki preglednik slika na svijetu i dalje će normalno prikazati sliku.

Za Open Badges 2.0 tvrdnja ide u tekstualni chunk s ključnom riječi openbadges. Tipovi tekstualnih chunkova koji je mogu sadržavati su:

ChunkKodiranjeNapomene
tEXtLatin-1Jednostavan, ali ograničen na Latin-1 znakove.
iTXtUTF-8Poželjniji jer imena i opisi često nisu ASCII.

Koji god se chunk koristi, raspored je ista ideja: ključna riječ openbadges, separator, pa sadržaj (payload). Sadržaj je jedna od dvije stvari, ovisno o tome kako je izdavatelj odlučio napraviti baking:

  1. Sam JSON tvrdnje. Datoteka je samoopisna. Provjeravatelj može pročitati tvrdnju bez ikakvog mrežnog poziva.
  2. URL koji upućuje na hostiranu tvrdnju. Datoteka je manja, a izdavatelj može zadržati živi zapis kao mjerodavan, primjerice da pokaže da je značka naknadno opozvana ili da je istekla.

Postoji i treća varijanta za potpisane značke, gdje je sadržaj potpisani token umjesto običnog JSON-a. Ako su potpisi važni za vaš slučaj, pročitajte kako provjeriti potpis Open Badgea.

A SVG?

SVG značke također se mogu „bakati”, jer je SVG XML. Tvrdnja se smješta unutar datoteke u element XML imenskog prostora openbadges, a atribut verify nosi URL hostirane tvrdnje. Načelo je isto kao kod PNG-a: metapodaci putuju unutar datoteke slike. U praksi većina platformi radi baking PNG-a jer se PNG prihvaća gotovo svugdje gdje ljudi žele učitati značku.

Kako izgleda ugrađena tvrdnja

Za format 2.0 hostirana tvrdnja je JSON-LD koji povezuje primatelja, klasu značke i metodu provjere. Skraćeni primjer:

{
  "@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" }
}

Obratite pozornost na primatelja. E-adresa nije pohranjena u čitljivom obliku; to je SHA-256 hash sa saltom. To je važno za datoteku koja je namijenjena dijeljenju. Svatko tko ima PNG može pročitati tvrdnju, pa tvrdnja ne smije odati adresu primatelja. Provjeravatelj koji već zna e-adresu može je hashirati istim saltom i provjeriti podudaraju li se. Za pregled ovog dokumenta polje po polje pogledajte Open Badge JSON-LD walkthrough.

Kako provjeravatelj čita baked značku

Provjera baked značke kratak je, mehanički postupak:

  1. Otvorite PNG i prođite kroz njegove chunkove.
  2. Pronađite tekstualni chunk s ključnom riječi openbadges.
  3. Pročitajte sadržaj. Ako je JSON, parsirajte ga. Ako je URL, dohvatite ga.
  4. Provjerite upućuje li tvrdnja na klasu značke i izdavatelja koje očekujete te podudara li se identitet primatelja s osobom koja je predočuje.
  5. Ako je tip provjere hosted, potvrdite da hostirana tvrdnja još postoji na svom id URL-u te da nije opozvana ili istekla.

Korak 5 je onaj koji ljudi preskaču, a upravo on čini vjerodajnicu pouzdanom. Ugrađena kopija je snimka stanja. Hostirani zapis je izvor istine.

Čitanje u Nodeu na vlastitu ruku

Bilo koji PNG možete pregledati kratkom skriptom. Ova prolazi kroz chunkove i ispisuje openbadges sadržaj, uz podršku za 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);

Pokrenite je s node extract-badge.mjs my-badge.png. Ako je datoteka baked, vidjet ćete JSON ili URL. Ako nije, dobit ćete običnu poruku „not baked”. Ovo je alat za učenje, a ne potpuni validator: ne provjerava kontrolne zbrojeve chunkova, ne parsira potpisane sadržaje niti dohvaća hostirani zapis.

Ako radije ne biste pisali kod, online validator znački ili preglednik PNG metapodataka pokazat će isti chunk. Format je standard, pa svaki usklađeni alat čita svaku usklađenu značku.

Zašto je baking važan

Prenosivost. Vjerodajnica koja je samo PNG može se poslati e-poštom, učitati na platformu za učenje ili pohraniti u osobnu arhivu. Za njezino nošenje nije potreban račun.

Put provjere koji nadživljava izdavateljevu marketinšku stranicu. Ugrađena tvrdnja imenuje izdavatelja i upućuje na hostirani zapis, pa provjeravatelj može krenuti samo od datoteke.

Offline i low-tech tijekovi rada. Kad je sadržaj cijeli JSON, čitatelj može provjeriti tvrdnju na računalu bez mreže, a hostirani zapis provjeriti kasnije.

Dokaz koji je teško usput krivotvoriti. Svatko može snimiti zaslon značke. Snimka zaslona nema metapodatke pa se ne može provjeriti kao datoteka značke. Već samo to razlikuje pravu vjerodajnicu od kopirane slike. To ne sprječava nekoga da u ukradenu sliku ugradi krivotvorenu tvrdnju, zbog čega postoji korak hostirane provjere.

Ograničenja bakinga

Budite iskreni prema primateljima o tome, jer to utječe na način na koji opisujete svoje vjerodajnice.

  • Metapodaci se brišu. Mnoge društvene mreže, optimizatori slika i aplikacije za poruke ponovno kodiraju učitane slike i odbacuju chunkove koji nisu pikseli. Baked značka objavljena na društvenoj mreži obično više nije baked. To je očekivano, i zato je uz datoteku važna javna poveznica za provjeru.
  • Baking sam po sebi nije dokaz. Ugrađeni JSON može napisati bilo tko. Povjerenje dolazi od hostirane tvrdnje na izdavateljevoj domeni ili od valjanog potpisa.
  • Uređivanje slike prekida vezu. Promjena veličine ili ponovno spremanje u uređivaču može izgubiti chunk.
  • Samo PNG i SVG. JPEG u specifikaciji nema ekvivalentnu konvenciju chunkova, pa se znaka u fotografskom stilu izvezena kao JPEG ne može „bakati” na standardan način.

Praktičan zaključak: baked datoteku tretirajte kao prikladnog nositelja, a stranicu za provjeru kao mjerodavni izvor. Ako birate formate za svoj program, Open Badges vs PDF certifikati objašnjava zašto strojno čitljiva vjerodajnica pobjeđuje statični dokument.

Kako baking radi na https://badges.ninja

Kad dodijelite značku na https://badges.ninja, platforma izgradi Open Badge tvrdnju za tog primatelja i ugradi je u sliku značke kao dio izdavanja. Ne konfigurirate nikakav alat niti pokrećete naredbu. Tijek:

  1. Značku dizajnirate u vizualnom dizajneru ili učitate vlastitu sliku.
  2. Izdate dodjelu (award) s nadzorne ploče, iz CSV učitavanja za skupne dodjele ili putem API-ja.
  3. Platforma kreira tvrdnju, ugrađuje je u PNG i sprema rezultat uz dodjelu.
  4. Primatelj dobiva javnu stranicu za provjeru na https://badges.ninja/awards/<awardId>, PDF certifikat, QR kod i opciju Add to LinkedIn.

Ako dizajn značke koristi polja za spajanje (merge fields), poput imena primatelja, svaka dodjela dobiva personaliziranu sliku, a upravo ta personalizirana slika se „peče”.

Baking se smatra poboljšanjem izdavanja, a ne preduvjetom: ako se određena slika ne može „bakati” (na primjer degenerirana slika rezervnog mjesta), dodjela se svejedno izdaje s izvornom slikom, a javna stranica za provjeru i Open Badge JSON-LD ostaju nepromijenjeni. Slika koju učitate mora zadovoljiti i minimalnu veličinu, pa se sićušno prazno platno odbija prije nego što stigne do pekare.

Budući da je javna stranica mjerodavna, svatko može provjeriti dodjelu bez registracije. Strojno čitljiv Open Badge v2.0 JSON-LD za dodjelu dostupan je na https://api.badges.ninja/certify-badge/award/<awardId>.

Izdavanje jedne dodjele putem API-ja

Većina čitatelja koristit će nadzornu ploču, ali ako automatizirate izdavanje, jedan zahtjev kreira dodjelu (a baked slika dolazi uz nju). Zamijenite ključ i ID značke vlastitima:

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}`;

Poziv vraća HTTP 200 s { "awardId": "<guid>" }. Iz tog ID-a izgradite URL za provjeru. Za postavljanje ključa i cjelovitu referencu zahtjeva pogledajte Awards API dokumentaciju i vodič za autentifikaciju.

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

Praktični savjeti za izdavatelje

Uz datoteku uvijek objavite poveznicu za provjeru. Stavite poveznicu u e-poruku o dodjeli, na certifikat i na svaku stranicu na kojoj se značka prikazuje. Budući da društvene platforme brišu metapodatke, poveznica je ono što vjerodajnicu održava provjerljivom nakon dijeljenja.

Koristite čistu izvornu sliku primjerene veličine. Krenite od PNG-a stvarnih dimenzija. Značka koju je izradio dizajner u normalnoj rezoluciji pouzdano se „peče”; rezervno mjesto od 1 piksela ne.

Ne uređujte isporučenu datoteku. Recite primateljima da dijele izvorno preuzetu datoteku ili poveznicu za provjeru, a ne izrezanu snimku zaslona.

Odlučite što želite reći o opozivu i isteku. Budući da je hostirani zapis mjerodavan, baked datoteka može nadživjeti status vjerodajnice. Jasno to navedite u dokumentaciji programa kako bi poslodavci znali provjeriti stranicu za provjeru umjesto da se oslanjaju samo na datoteku.

Testirajte jednu značku od početka do kraja. Izdajte dodjelu sebi, preuzmite PNG, provucite ga kroz gornju skriptu ili javni validator i otvorite poveznicu za provjeru. Pet minuta testiranja pokazuje što će doživjeti vaši primatelji.

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

Često postavljana pitanja

Je li baked značka isto što i digitalni certifikat? Ne. Certifikat je obično PDF za čitanje i ispis. Baked značka je slika koja nosi i strojno čitljive podatke o vjerodajnici. https://badges.ninja proizvodi oboje iz iste dodjele.

Mogu li napraviti baking značke bez platforme? Da. Specifikacija je otvorena, a biblioteke postoje za nekoliko jezika. Teži dio je hostiranje tvrdnje na stabilnom URL-u, što provjeru čini smislenom. Taj dio platforma rješava umjesto vas.

Otkriva li baking e-adresu primatelja? Ne kada je identitet hashiran. Tvrdnja pohranjuje hash sa saltom, pa datoteka ne otkriva adresu.

Hoće li LinkedIn pročitati baked podatke? LinkedInov tijek Add to Profile radi na temelju naziva vjerodajnice, izdavatelja, datuma i URL-a, a ne metapodataka datoteke. Pogledajte dodavanje gumba Add to LinkedIn.

Sažetak

Baked Open Badge je PNG (ili SVG) s vjerodajnicom upisanom u tekstualni chunk imena openbadges. Čini značku prenosivom i samoopisnom, ali stvarno povjerenje dolazi od hostirane tvrdnje na izdavateljevoj domeni. Radite baking zbog prenosivosti, objavite poveznicu za provjeru zbog povjerenja i računajte da će društvene mreže ukloniti metapodatke.

Spremni izdati svoju prvu provjerljivu vjerodajnicu? Započnite besplatno na badges.ninja — vizualni dizajner, javna stranica za provjeru, PDF certifikat, Open Badge v2.0 izlaz. Kreditna kartica nije potrebna.

Nacho Coll

O autoru

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.

Natrag na Blog

Povezani članci