Open Badge baking selitettynä: näin JSON asuu PNG-kuvan sisällä
”Baked” Open Badge on PNG-kuva, jonka metadataan on upotettu assertion-JSON. Merkkitiedosto ON todistus. Näin baking toimii ja näin varmennat baked-merkin.
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.
Lataa Open Badge lähes miltä tahansa myöntäjältä, ja saat tavallisen näköisen PNG-kuvan. Pudota se chattiin, liitä se sähköpostiin, tulosta se. Se näyttää samalta kuin mikä tahansa muu kuva. Mutta tiedostossa on toinen, näkymätön kerros: itse todistus, kirjoitettuna kuvaan metadatana. Sitä Open Badges -yhteisö kutsuu baked-merkiksi, ja siksi merkki voi liikkua yhtenä tiedostona ja silti todistaa, kuka sen myönsi, kenelle ja mistä.
Tämä opas selittää, mitä baking on, missä data sijaitsee tiedoston sisällä, miten varmentaja lukee sen takaisin ja mitä sinun täytyy päättää todistusten myöntäjänä. Baked-merkkien käyttö ei vaadi koodaamista. Jos myönnät merkit palvelussa https://badges.ninja, baking tapahtuu puolestasi. Mutta mekaniikan ymmärtäminen auttaa vastaamaan kysymyksiin, joita saajat ja työnantajat oikeasti esittävät: “Onko tämä kuva aito?” ja “Voiko kuka tahansa vain kopioida sen?”
Mitä “baking” tarkoittaa
Open Badgessa on kaksi osaa, jotka on helppo sekoittaa keskenään:
- Kuva. PNG tai SVG, jonka ihmiset näkevät profiilissa, diassa tai todistuksessa.
- Assertion. Pieni JSON-dokumentti, joka kertoo tosiasiat: kuka saaja on (hajautettuna tunnisteena), mikä merkkiluokka on suoritettu, kuka sen on myöntänyt, milloin ja mistä sen voi varmentaa.
Baking tarkoittaa assertionin kirjoittamista kuvaan niin, ettei näitä kahta voi erottaa toisistaan. Tuloksena on yksi tiedosto. Kun annat jollekulle PNG:n, olet antanut sekä kuvan että sen takana olevan väitteen.
Idea tulee Open Badges -määrityksestä, jonka Mozilla alun perin kehitti ja jota 1EdTech nyt ylläpitää. Suunnittelun ydin on siirrettävyys. Aluksi merkit elivät yhden alustan sisällä, ja merkin siirtäminen toiseen paikkaan tarkoitti uudelleen lataamista ja toivomista, että metadata säilyy. Baked-tiedosto kantaa omat metadatansa mukanaan minne tahansa.
Missä JSON asuu PNG:n sisällä
PNG-tiedosto koostuu lyhyestä allekirjoituksesta ja sitä seuraavasta chunkien jonosta. Jokaisella chunkilla on pituus, nelikirjaiminen tyyppi, dataa ja tarkistussumma. Katseluohjelmat piirtävät pikselit IDAT-chunkeista ja ohittavat chunk-tyypit, joita eivät ymmärrä. Tämä sallivuus mahdollistaa bakingin: voit lisätä tekstiä täynnä olevan chunkin, ja jokainen maailman kuvankatselin näyttää kuvan silti normaalisti.
Open Badges 2.0:ssa assertion sijoitetaan tekstichunkiin, jonka avainsana on openbadges. Tekstichunk-tyypit, joihin se mahtuu, ovat:
| Chunk | Koodaus | Huomioita |
|---|---|---|
tEXt | Latin-1 | Yksinkertainen, mutta rajoittuu Latin-1-merkkeihin. |
iTXt | UTF-8 | Suositeltu, koska nimet ja kuvaukset eivät usein ole ASCII-merkkejä. |
Käytetäänpä kumpaa chunkia tahansa, rakenne on sama: avainsana openbadges, erotin ja sitten hyötykuorma. Hyötykuorma on jompikumpi kahdesta riippuen siitä, miten myöntäjä päätti bakettaa:
- Itse assertion-JSON. Tiedosto kuvaa itse itsensä. Varmentaja voi lukea väitteen ilman verkkokutsua.
- URL, joka osoittaa isännöityyn assertioniin. Tiedosto on pienempi, ja myöntäjä voi pitää elävän tietueen ensisijaisena, esimerkiksi osoittaakseen, että merkki on myöhemmin peruutettu tai vanhentunut.
Kolmas variantti on olemassa allekirjoitetuille merkeille, joissa hyötykuorma on allekirjoitettu token tavallisen JSONin sijaan. Jos allekirjoituksilla on käyttötapauksessasi merkitystä, lue miten Open Badge -allekirjoitus varmennetaan.
Entä SVG?
SVG-merkit voi myös bakettaa, koska SVG on XML:ää. Assertion sijoitetaan tiedoston sisään openbadges-nimiavaruuden elementtiin, ja verify-attribuutti kantaa isännöidyn assertionin URL-osoitteen. Periaate on sama kuin PNG:ssä: metadata kulkee kuvatiedoston sisällä. Käytännössä useimmat alustat bakettavat PNG:n, koska PNG hyväksytään lähes kaikkialla, minne ihmiset haluavat ladata merkin.
Miltä upotettu assertion näyttää
2.0-muodossa isännöity assertion on JSON-LD, joka yhdistää saajan, merkkiluokan ja varmennustavan. Lyhennetty esimerkki:
{
"@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" }
}
Kiinnitä huomiota saajaan. Sähköpostia ei tallenneta selkotekstinä; se on suolattu SHA-256-tiiviste. Sillä on väliä tiedostolle, joka on suunniteltu kiertämään. Jokainen, jolla on PNG, voi lukea assertionin, joten assertion ei saa paljastaa saajan osoitetta. Varmentaja, joka jo tuntee sähköpostin, voi tiivistää sen samalla suolalla ja tarkistaa, täsmääkö se. Dokumentin läpikäynti kenttä kerrallaan löytyy Open Badge JSON-LD -esimerkistä.
Miten varmentaja lukee baked-merkin
Baked-merkin varmennus on lyhyt, mekaaninen prosessi:
- Avaa PNG ja käy sen chunkit läpi.
- Etsi tekstichunk, jonka avainsana on
openbadges. - Lue hyötykuorma. Jos se on JSON, jäsennä se. Jos se on URL, hae se.
- Tarkista, että assertion viittaa odottamaasi merkkiluokkaan ja myöntäjään ja että saajan identiteetti vastaa merkin esittävää henkilöä.
- Jos varmennustyyppi on
hosted, varmista, että isännöity assertion on yhä olemassaid-URL-osoitteessaan eikä sitä ole peruutettu tai se ei ole vanhentunut.
Vaihe 5 on se, jonka ihmiset ohittavat, ja juuri se tekee todistuksesta luotettavan. Upotettu kopio on tilannekuva. Isännöity tietue on totuuden lähde.
Lue se itse Nodella
Voit tarkastaa minkä tahansa PNG:n lyhyellä skriptillä. Tämä käy chunkit läpi ja tulostaa openbadges-hyötykuorman käsitellen sekä tEXt:n että iTXt:n:
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);
Aja se komennolla node extract-badge.mjs my-badge.png. Jos tiedosto on baked, näet JSONin tai URL-osoitteen. Jos ei, saat selkeän viestin, ettei tiedostoa ole baked. Tämä on opetustyökalu, ei täysi validaattori: se ei tarkista chunkien tarkistussummia, ei jäsennä allekirjoitettuja hyötykuormia eikä hae isännöityä tietuetta.
Jos et halua kirjoittaa koodia, verkossa toimiva merkkivalidaattori tai PNG-metadatan katselija näyttää saman chunkin. Muoto on standardi, joten mikä tahansa yhteensopiva työkalu lukee minkä tahansa yhteensopivan merkin.
Miksi baking on tärkeää
Siirrettävyys. Todistus, joka on pelkkä PNG, voidaan lähettää sähköpostilla, ladata oppimisalustalle tai tallentaa henkilökohtaiseen arkistoon. Sen kantamiseen ei tarvita tiliä.
Varmennuspolku, joka säilyy myöntäjän markkinointisivuston ohi. Upotettu assertion nimeää myöntäjän ja osoittaa isännöityyn tietueeseen, joten varmentaja voi aloittaa pelkästä tiedostosta.
Offline- ja kevyen teknologian työnkulut. Kun hyötykuorma on koko JSON, lukija voi tarkistaa väitteen koneella ilman verkkoa ja varmentaa isännöidyn tietueen myöhemmin.
Todiste, jota on vaikea väärentää huolimattomasti. Kuka tahansa voi ottaa merkistä kuvakaappauksen. Kuvakaappauksessa ei ole metadataa, joten sitä ei voi varmentaa merkkitiedostona. Jo se erottaa aidon todistuksen kopioidusta kuvasta. Se ei estä ketään bakettamasta väärennettyä assertionia varastettuun kuvaan, minkä vuoksi isännöidyn tietueen varmennusvaihe on olemassa.
Bakingin rajat
Ole rehellinen saajillesi näistä, sillä ne vaikuttavat siihen, miten kuvaat todistuksiasi.
- Metadata poistetaan. Monet sosiaaliset verkostot, kuvien optimoijat ja viestisovellukset koodaavat lataukset uudelleen ja pudottavat muut kuin pikselichunkit. Sosiaaliseen syötteeseen julkaistu baked-merkki ei yleensä ole enää baked. Se on odotettua, ja siksi julkinen varmennuslinkki on tärkeä tiedoston rinnalla.
- Baking ei ole yksinään todiste. Upotetun JSONin voi kirjoittaa kuka tahansa. Luottamus tulee myöntäjän verkkotunnuksessa olevasta isännöidystä assertionista tai pätevästä allekirjoituksesta.
- Kuvan muokkaus katkaisee yhteyden. Koon muuttaminen tai uudelleentallennus kuvankäsittelyohjelmassa voi hävittää chunkin.
- Vain PNG ja SVG. JPEG:llä ei ole määrityksessä vastaavaa chunk-käytäntöä, joten JPEGinä viety valokuvatyylinen merkki ei ole bakettavissa vakiotavalla.
Käytännön johtopäätös: pidä baked-tiedostoa kätevänä kuljettajana ja varmennussivua auktoriteettina. Jos vertailet ohjelmasi formaatteja, Open Badges vs. PDF-todistukset kertoo, miksi koneluettava todistus voittaa staattisen dokumentin.
Miten baking toimii palvelussa https://badges.ninja
Kun myönnät merkin palvelussa https://badges.ninja, alusta rakentaa kyseiselle saajalle Open Badge -assertionin ja bakettaa sen merkin kuvaan osana myöntämistä. Sinun ei tarvitse määrittää työkalua tai ajaa komentoa. Kulku:
- Suunnittelet merkin visuaalisella suunnittelijalla tai lataat oman kuvasi.
- Myönnät palkinnon hallintapaneelista, CSV-latauksella massamyöntöä varten tai API:n kautta.
- Alusta luo assertionin, bakettaa sen PNG:hen ja tallentaa tuloksen palkinnon mukana.
- Saaja saa julkisen varmennussivun osoitteessa
https://badges.ninja/awards/<awardId>, PDF-todistuksen, QR-koodin ja Add to LinkedIn -vaihtoehdon.
Jos merkin suunnittelussa käytetään yhdistämiskenttiä, kuten saajan nimeä, jokainen palkinto saa henkilökohtaisen kuvan, ja juuri se henkilökohtainen kuva bakataan.
Baking on parannus myöntämiseen, ei portti: jos tiettyä kuvaa ei voi bakettaa (esimerkiksi rappeutunutta paikkamerkkikuvaa), palkinto myönnetään silti alkuperäisellä kuvalla, eikä julkinen varmennussivu tai Open Badge JSON-LD muutu. Lataamasi kuvan on myös täytettävä vähimmäiskoko, joten pieni tyhjä kangas hylätään ennen kuin se pääsee leipomoon.
Koska julkinen sivu on auktoriteetti, kuka tahansa voi tarkistaa palkinnon rekisteröitymättä. Palkinnon koneluettava Open Badge v2.0 JSON-LD on saatavilla osoitteessa https://api.badges.ninja/certify-badge/award/<awardId>.
Yhden palkinnon myöntäminen API:lla
Useimmat käyttävät hallintapaneelia, mutta jos automatisoit myöntämisen, yksi pyyntö luo palkinnon (ja baked-kuva tulee mukana). Korvaa avain ja merkin id omillasi:
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}`;
Kutsu palauttaa HTTP 200 -vastauksen { "awardId": "<guid>" }. Rakenna varmennus-URL tästä id:stä. Avainten käyttöönotosta ja täydestä pyyntöviitteestä saat tietoa Awards API -dokumentaatiosta ja todennusoppaasta.

Käytännön neuvoja myöntäjille
Julkaise aina varmennuslinkki tiedoston rinnalla. Laita linkki palkintosähköpostiin, todistukseen ja jokaiselle sivulle, jolla merkki näytetään. Koska sosiaaliset alustat poistavat metadatan, linkki pitää todistuksen varmennettavana jaon jälkeenkin.
Käytä puhdasta, riittävän suurta lähdekuvaa. Aloita PNG:stä, jolla on todelliset mitat. Suunnittelijan tekemä merkki normaalilla resoluutiolla bakataan luotettavasti; yhden pikselin paikkamerkki ei.
Älä muokkaa toimitettua tiedostoa. Kehota saajia jakamaan alkuperäinen lataus tai varmennuslinkki, ei rajattua kuvakaappausta.
Päätä, mitä haluat sanoa peruutuksesta ja vanhenemisesta. Koska isännöity tietue on ensisijainen, baked-tiedosto voi elää pidempään kuin todistuksen tila. Kerro se selvästi ohjelmasi dokumentaatiossa, jotta työnantajat tietävät tarkistaa varmennussivun eivätkä luota pelkkään tiedostoon.
Testaa yksi merkki päästä päähän. Myönnä palkinto itsellesi, lataa PNG, aja se yllä olevan skriptin tai julkisen validaattorin läpi ja avaa varmennuslinkki. Viiden minuutin testaus kertoo, mitä saajasi kokevat.

Usein kysytyt kysymykset
Onko baked-merkki sama asia kuin digitaalinen todistus? Ei. Todistus on yleensä PDF luettavaksi ja tulostettavaksi. Baked-merkki on kuva, joka kantaa myös koneluettavaa todistusdataa. https://badges.ninja tuottaa molemmat samasta palkinnosta.
Voinko bakettaa merkin ilman alustaa? Kyllä. Määritys on avoin, ja kirjastoja on usealle kielelle. Vaikeampaa on isännöidä assertion vakaassa URL-osoitteessa, mikä tekee varmennuksesta merkityksellisen. Sen alusta hoitaa puolestasi.
Paljastaako baking saajan sähköpostin? Ei, kun identiteetti on tiivistetty. Assertion tallentaa suolatun tiivisteen, joten tiedosto ei paljasta osoitetta.
Lukeeko LinkedIn bakatun datan? LinkedInin Add to Profile -toiminto perustuu todistuksen nimeen, myöntäjään, päivämäärään ja URL-osoitteeseen eikä tiedoston metadataan. Katso Add to LinkedIn -painikkeen lisääminen.
Yhteenveto
Baked Open Badge on PNG (tai SVG), jonka todistus on kirjoitettu openbadges-nimiseen tekstichunkiin. Se tekee merkistä siirrettävän ja itsensä kuvaavan, mutta todellinen luottamus tulee myöntäjän verkkotunnuksessa olevasta isännöidystä assertionista. Baketa siirrettävyyden vuoksi, julkaise varmennuslinkki luottamuksen vuoksi ja varaudu siihen, että sosiaaliset verkostot poistavat metadatan.
Valmiina myöntämään ensimmäisen varmennettavan todistuksesi? Aloita ilmaiseksi badges.ninjassa — visuaalinen suunnittelija, julkinen varmennussivu, PDF-todistus, Open Badge v2.0 -tuloste. Luottokorttia ei tarvita.
Miten tämä artikkeli tehtiin
Osa tämän blogin artikkeleista laaditaan tekoälyavustajan avulla, minkä jälkeen Badges Ninja -tiimi tarkistaa, faktantarkistaa ja muokkaa ne ennen julkaisua. Jokainen koodiesimerkki ja hinta tarkistetaan live-tuotteesta. Lue lisää toimituksellisesta ja tekoälyprosessistamme toimitusprosessin sivulla .

Kirjoittajasta
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.
Lisää käyttäjältä Nacho Coll
- Open Badges koodauskoulutuksiin: varmennettavat todistukset kohortin mittakaavassa19.11.2026 · 8min lukuaika
- Webhookien käyttöönotto merkkitapahtumille: reaaliaikainen integraatio taustajärjestelmääsi16.11.2026 · 7min lukuaika
- Open Badgen voimassaolon päättyminen ja uusiminen: määräaikaisten todistusten elinkaaren hallinta12.11.2026 · 8min lukuaika


