Peko Open Badge pojasnjena: kako JSON živi v PNG-ju

„Pečena“ Open Badge je PNG z vdelanim JSON-om izjave kot metapodatki slike. Datoteka značke JE poverilnica. Kako peko deluje in kako preveriti pečeno značko.

Nacho Coll Avtor Posodobljeno 10 min branja
„Pečena“ Open Badge je PNG z vdelanim JSON-om izjave kot metapodatki slike. Datoteka značke JE poverilnica. Kako peko deluje in kako preveriti pečeno značko.

Prenesite Open Badge od skoraj katerega koli izdajatelja in dobili boste povsem običajno videti PNG. Spustite ga v klepet, priložite e-pošti, natisnite. Videti je kot vsaka druga slika. A datoteka nosi še drugo, nevidno plast: samo poverilnico, zapisano v sliko kot metapodatke. Skupnost Open Badges to imenuje pečena značka (baked badge) in prav zato lahko značka potuje kot ena sama datoteka in še vedno dokazuje, kdo jo je izdal, komu in za kaj.

Ta vodnik pojasnjuje, kaj je peka, kje v datoteki živijo podatki, kako jih preverjevalec prebere nazaj in o čem morate odločiti kot izdajatelj poverilnic. Za uporabo pečenih značk vam ni treba pisati kode. Če izdajate prek https://badges.ninja, se peka zgodi samodejno. Razumevanje mehanike pa vam pomaga odgovoriti na vprašanja, ki jih prejemniki in delodajalci res postavljajo: „Je ta slika pristna?“ in „Ali jo lahko kdo preprosto kopira?“

Kaj pomeni „peka“

Open Badge ima dva dela, ki ju je lahko zamenjati:

  • Slika. PNG ali SVG, ki ga ljudje vidijo na profilu, diapozitivu ali certifikatu.
  • Izjava (assertion). Majhen JSON dokument, ki navaja dejstva: kdo je prejemnik (kot zgoščen identifikator), katera vrsta značke je bila pridobljena, kdo jo je izdal, kdaj in kje jo je mogoče preveriti.

Peka je dejanje, ko izjavo zapišete v sliko, tako da ju ni mogoče ločiti. Rezultat je ena datoteka. Če nekomu izročite PNG, ste mu izročili tako sliko kot trditev za njo.

Zamisel izvira iz specifikacije Open Badges, ki jo je prvotno razvil Mozilla, danes pa jo vzdržuje 1EdTech. Bistvo zasnove je prenosljivost. V zgodnjih časih so značke živele znotraj ene same platforme, selitev na novo mesto pa je pomenila ponovno nalaganje v upanju, da bodo metapodatki preživeli. Pečena datoteka nosi svoje metapodatke s seboj, kamor koli gre.

Kje v PNG-ju živi JSON

Datoteka PNG je kratek podpis, ki mu sledi zaporedje odsekov (chunks). Vsak odsek ima dolžino, štiričrkovni tip, nekaj podatkov in kontrolno vsoto. Pregledovalniki izrišejo piksle iz odsekov IDAT in ignorirajo tipe odsekov, ki jih ne razumejo. Prav ta toleranca omogoča peko: dodate lahko odsek, poln besedila, in vsak pregledovalnik slik na svetu bo sliko še vedno prikazal normalno.

Pri Open Badges 2.0 gre izjava v tekstovni odsek s ključno besedo openbadges. Tipi tekstovnih odsekov, ki jo lahko hranijo, so:

OdsekKodiranjeOpombe
tEXtLatin-1Preprosto, a omejeno na znake Latin-1.
iTXtUTF-8Prednostno, ker imena in opisi pogosto niso ASCII.

Ne glede na to, kateri odsek se uporabi, je postavitev enaka: ključna beseda openbadges, ločilo, nato vsebina. Vsebina je ena od dveh stvari, odvisno od tega, kako se je izdajatelj odločil peči:

  1. Sam JSON izjave. Datoteka je samoopisna. Preverjevalec lahko prebere trditev brez kakršnega koli omrežnega klica.
  2. URL, ki kaže na gostovano izjavo. Datoteka je manjša, izdajatelj pa lahko živi zapis ohrani kot avtoritativen, na primer da pokaže, da je bila značka pozneje preklicana ali je potekla.

Za podpisane značke obstaja tretja različica, kjer je vsebina podpisan žeton namesto navadnega JSON-a. Če so podpisi pomembni za vaš primer uporabe, preberite kako preveriti podpis Open Badge.

Kaj pa SVG?

Tudi SVG značke je mogoče peči, saj je SVG XML. Izjava je v datoteki nameščena v elementu z XML imenskim prostorom openbadges, atribut verify pa nosi URL gostovane izjave. Načelo je enako kot pri PNG: metapodatki potujejo znotraj slikovne datoteke. V praksi večina platform peče PNG, ker je PNG sprejet skoraj povsod, kamor ljudje želijo naložiti značko.

Kako je videti vdelana izjava

Pri formatu 2.0 je gostovana izjava JSON-LD, ki povezuje prejemnika, vrsto značke in način preverjanja. Skrajšan primer:

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

Poglejte prejemnika. E-pošta ni shranjena v čistem besedilu; je soljen zgoščen SHA-256. To je pomembno za datoteko, namenjeno kroženju. Vsak, ki ima PNG, lahko prebere izjavo, zato ta ne sme razkriti prejemnikovega naslova. Preverjevalec, ki e-pošto že pozna, jo lahko zgosti z isto soljo in preveri ujemanje. Za pregled tega dokumenta polje za poljem glejte razlago Open Badge JSON-LD.

Kako preverjevalec prebere pečeno značko

Preverjanje pečene značke je kratek, mehanski postopek:

  1. Odprite PNG in se sprehodite po njegovih odsekih.
  2. Poiščite tekstovni odsek s ključno besedo openbadges.
  3. Preberite vsebino. Če je JSON, ga razčlenite. Če je URL, ga prenesite.
  4. Preverite, ali se izjava nanaša na vrsto značke in izdajatelja, ki ju pričakujete, ter ali identiteta prejemnika ustreza osebi, ki jo predloži.
  5. Če je vrsta preverjanja hosted, potrdite, da gostovana izjava na svojem URL-ju id še obstaja in ni bila preklicana ali potekla.

Korak 5 ljudje najpogosteje preskočijo, a prav on poverilnico naredi zaupanja vredno. Vdelana kopija je posnetek. Gostovani zapis je vir resnice.

Branje v Nodu

Vsak PNG lahko pregledate s kratkim skriptom. Ta se sprehodi po odsekih in izpiše vsebino openbadges, pri čemer obravnava tEXt in 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);

Zaženite ga z node extract-badge.mjs my-badge.png. Če je datoteka pečena, boste videli JSON ali URL. Če ni, dobite navadno sporočilo „not baked“. To je učno orodje, ne popoln validator: ne preverja kontrolnih vsot odsekov, ne razčlenjuje podpisanih vsebin in ne prenaša gostovanega zapisa.

Če raje ne pišete kode, bo spletni validator značk ali pregledovalnik metapodatkov PNG pokazal isti odsek. Format je standard, zato vsako skladno orodje prebere vsako skladno značko.

Zakaj je peka pomembna

Prenosljivost. Poverilnico, ki je samo PNG, lahko pošljete po e-pošti, naložite na učno platformo ali shranite v osebni arhiv. Za prenašanje ne potrebujete računa.

Pot preverjanja, ki preživi tržno spletno mesto izdajatelja. Vdelana izjava poimenuje izdajatelja in kaže na gostovani zapis, zato lahko preverjevalec začne samo z datoteko.

Izvenmrežni in nizkotehnološki delovni tokovi. Ko je vsebina celoten JSON, lahko bralec preveri trditev na napravi brez omrežja, gostovani zapis pa preveri pozneje.

Dokaz, ki ga je težko nonšalantno ponarediti. Zaslonski posnetek značke lahko naredi kdorkoli. Posnetek nima metapodatkov, zato ga ni mogoče preveriti kot datoteko značke. Že to loči pravo poverilnico od kopirane slike. Ne prepreči pa, da bi kdo v ukradeno sliko spekel ponarejeno izjavo, zato obstaja korak gostovanega preverjanja.

Omejitve peke

Bodite pošteni do prejemnikov glede teh stvari, ker vplivajo na to, kako opisujete svoje poverilnice.

  • Metapodatki se odstranijo. Številna družbena omrežja, optimizatorji slik in aplikacije za sporočanje ponovno kodirajo naložene datoteke in odvržejo odseke, ki niso pikslji. Pečena značka, objavljena v družbenem viru, običajno ni več pečena. To je pričakovano in zato je poleg datoteke pomembna javna povezava za preverjanje.
  • Peka sama po sebi ni dokaz. Vdelan JSON lahko napiše kdorkoli. Zaupanje izhaja iz gostovane izjave na domeni izdajatelja ali iz veljavnega podpisa.
  • Urejanje slike prekine povezavo. Spreminjanje velikosti ali ponovno shranjevanje v urejevalniku lahko izgubi odsek.
  • Samo PNG in SVG. JPEG v specifikaciji nima enakovredne konvencije odsekov, zato značke v fotografskem slogu, izvožene kot JPEG, ni mogoče peči na standarden način.

Praktičen zaključek: pečeno datoteko obravnavajte kot priročnega nosilca, stran za preverjanje pa kot avtoriteto. Če tehtate formate za svoj program, Open Badges proti PDF certifikatom pojasnjuje, zakaj strojno berljiva poverilnica premaga statičen dokument.

Kako peka deluje na https://badges.ninja

Ko podelite značko na https://badges.ninja, platforma zgradi izjavo Open Badge za tega prejemnika in jo med izdajanjem speče v sliko značke. Ne nastavljate nobenega orodja in ne zaganjate nobenega ukaza. Potek:

  1. Značko oblikujete v vizualnem oblikovalniku ali naložite svojo sliko.
  2. Podelite nagrado: z nadzorne plošče, z nalaganjem CSV za množične nagrade ali prek API-ja.
  3. Platforma ustvari izjavo, jo speče v PNG in rezultat shrani ob nagradi.
  4. Prejemnik dobi javno stran za preverjanje na https://badges.ninja/awards/<awardId>, PDF certifikat, QR kodo in možnost Add to LinkedIn.

Če oblika značke uporablja polja za združevanje, kot je prejemnikovo ime, vsaka nagrada dobi personalizirano sliko, in prav ta personalizirana slika je pečena.

Peka je obravnavana kot izboljšava izdajanja, ne kot pogoj: če določene slike ni mogoče speči (na primer degenerirana slika nadomestnega mesta), je nagrada še vedno izdana z izvirno sliko, javna stran za preverjanje in Open Badge JSON-LD pa ostaneta nespremenjena. Naložena slika mora tudi doseči minimalno velikost, zato je drobno prazno platno zavrnjeno, še preden doseže pekarno.

Ker je javna stran avtoriteta, lahko vsakdo preveri nagrado brez registracije. Strojno berljiv Open Badge v2.0 JSON-LD za nagrado je na voljo na https://api.badges.ninja/certify-badge/award/<awardId>.

Izdaja ene nagrade prek API-ja

Večina bralcev bo uporabljala nadzorno ploščo, če pa izdajanje avtomatizirate, nagrado ustvari ena zahteva (pečena slika pride zraven). Ključ in ID značke zamenjajte s svojima:

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

Klic vrne HTTP 200 z { "awardId": "<guid>" }. URL za preverjanje sestavite iz tega ID-ja. Za nastavitev ključa in celoten opis zahtev glejte dokumentacijo Awards API in vodnik za overjanje.

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

Praktični nasveti za izdajatelje

Ob datoteki vedno objavite povezavo za preverjanje. Povezavo dodajte v e-pošto z nagrado, na certifikat in na vsako stran, kjer je značka prikazana. Ker družbene platforme odstranijo metapodatke, povezava poskrbi, da poverilnica ostane preverljiva tudi po deljenju.

Uporabite čisto, dovolj veliko izvorno sliko. Začnite s PNG-jem z resnično ločljivostjo. Značka, ki jo je izdelal oblikovalec v običajni ločljivosti, se peče zanesljivo; 1-pikselska nadomestna slika ne.

Ne urejajte dostavljene datoteke. Prejemnikom povejte, naj delijo izvirni prenos ali povezavo za preverjanje, ne obrezanega zaslonskega posnetka.

Odločite se, kaj želite povedati o preklicu in poteku. Ker je gostovani zapis avtoritativen, lahko pečena datoteka preživi status poverilnice. To jasno zapišite v dokumentaciji programa, da delodajalci vedo, da naj preverijo stran za preverjanje in ne zaupajo samo datoteki.

Preizkusite eno značko od začetka do konca. Izdajte nagrado sebi, prenesite PNG, ga pognajte skozi zgornji skript ali javni validator in odprite povezavo za preverjanje. Pet minut testiranja pove, kaj bodo doživeli vaši prejemniki.

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

Pogosta vprašanja

Ali je pečena značka isto kot digitalni certifikat? Ne. Certifikat je običajno PDF za branje in tiskanje. Pečena značka je slika, ki nosi tudi strojno berljive podatke o poverilnici. https://badges.ninja izdela oboje iz iste nagrade.

Ali lahko spečem značko brez platforme? Da. Specifikacija je odprta, knjižnice pa obstajajo za več jezikov. Težji del je gostovanje izjave na stabilnem URL-ju, ki preverjanju daje smisel. Ta del opravi platforma namesto vas.

Ali peka razkrije prejemnikovo e-pošto? Ne, če je identiteta zgoščena. Izjava shrani soljen zgoščen niz, zato datoteka naslova ne razkrije.

Ali bo LinkedIn prebral pečene podatke? Postopek Add to Profile na LinkedInu deluje iz imena poverilnice, izdajatelja, datuma in URL-ja, ne iz metapodatkov datoteke. Glejte dodajanje gumba Add to LinkedIn.

Povzetek

Pečena Open Badge je PNG (ali SVG) s poverilnico, zapisano v tekstovni odsek z imenom openbadges. Značko naredi prenosljivo in samoopisno, a pravo zaupanje izhaja iz gostovane izjave na domeni izdajatelja. Pecite zaradi prenosljivosti, objavite povezavo za preverjanje zaradi zaupanja in pričakujte, da bodo družbena omrežja metapodatke odstranila.

Ste pripravljeni izdati svojo prvo preverljivo poverilnico? Začnite brezplačno na badges.ninja — vizualni oblikovalnik, javna stran za preverjanje, PDF certifikat, izpis Open Badge v2.0. Kreditne kartice ne potrebujete.

Nacho Coll

O avtorju

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.

Nazaj na Blog

Povezani članki