Open Badge Baking, Ipinaliwanag: Paano Nakatira ang JSON sa Loob ng PNG
Ang "baked" na Open Badge ay isang PNG na may assertion JSON na naka-embed bilang image metadata. Ang badge file MISMO ang credential. Paano gumagana ang baking + paano i-verify ang baked badge.
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.
Mag-download ng Open Badge mula sa halos kahit anong issuer at makakakuha ka ng PNG na mukhang normal. I-drop mo sa chat, i-attach sa email, i-print. Mukha lang itong ordinaryong image. Pero may dala ang file na pangalawang, hindi nakikitang layer: ang credential mismo, nakasulat sa loob ng image bilang metadata. Iyan ang tinatawag ng Open Badges community na baked badge, at iyan ang dahilan kung bakit puwedeng bumiyahe ang isang badge bilang iisang file at napapatunayan pa rin kung sino ang nag-issue, kanino, at para saan.
Ipinapaliwanag ng gabay na ito kung ano ang baking, kung saan nakalagay ang data sa loob ng file, paano ito binabasa ng verifier, at ano ang kailangan mong pagpasyahan bilang nag-iisyu ng credentials. Hindi mo kailangang magsulat ng code para gumamit ng baked badges. Kung nag-iisyu ka sa https://badges.ninja, awtomatiko na ang baking. Pero nakakatulong ang pag-unawa sa mechanics para masagot mo ang mga tanong na talagang itinatanong ng mga recipient at employer: “Totoo ba ang image na ito?” at “Puwede ba itong kopyahin ng kahit sino?”
Ano ang ibig sabihin ng “baking”
May dalawang bahagi ang Open Badge na madaling mapagkamalan:
- Ang larawan. Ang PNG o SVG na nakikita ng mga tao sa profile, slide, o certificate.
- Ang assertion. Isang maliit na JSON document na nagsasaad ng mga katotohanan: sino ang recipient (bilang hashed identifier), aling badge class ang nakuha, sino ang nag-issue, kailan, at saan ito ive-verify.
Ang baking ay ang pagsusulat ng assertion sa loob ng larawan para hindi na sila maghiwalay. Ang resulta ay isang file. Ibigay mo sa isang tao ang PNG at naibigay mo na pareho ang image at ang claim sa likod nito.
Galing ang ideya sa Open Badges specification na orihinal na binuo ng Mozilla at ngayon ay pinapanatili ng 1EdTech. Ang punto ng disenyo ay portability. Noong una, nasa loob lang ng iisang platform ang mga badge, at ang paglipat sa ibang lugar ay nangangahulugang mag-re-upload at umasang mabubuhay ang metadata. Ang baked file ay dala ang sarili nitong metadata saan man ito mapunta.
Saan nakatira ang JSON sa loob ng PNG
Ang PNG file ay isang maikling signature na sinusundan ng sunod-sunod na chunks. Bawat chunk ay may length, apat na letrang type, ilang data, at checksum. Iginuguhit ng mga viewer ang pixels mula sa mga IDAT chunk at hindi pinapansin ang mga chunk type na hindi nila naiintindihan. Ang pagpapaubayang iyon ang nagpapaging posible sa baking: puwede kang magdagdag ng chunk na puno ng text at ipapakita pa rin nang normal ng lahat ng image viewer sa mundo ang larawan.
Para sa Open Badges 2.0, napupunta ang assertion sa isang text chunk na may keyword na openbadges. Ang mga text chunk type na puwedeng maglaman nito ay:
| Chunk | Encoding | Mga tala |
|---|---|---|
tEXt | Latin-1 | Simple, pero limitado sa mga Latin-1 character. |
iTXt | UTF-8 | Mas gusto, dahil madalas na hindi ASCII ang mga pangalan at description. |
Alinmang chunk ang gamitin, pareho ang layout: ang keyword na openbadges, isang separator, tapos ang payload. Ang payload ay isa sa dalawang bagay, depende sa kung paano pinili ng issuer na mag-bake:
- Ang mismong assertion JSON. Self-describing ang file. Mababasa ng verifier ang claim nang walang network call.
- Isang URL na tumuturo sa naka-host na assertion. Mas maliit ang file at mapapanatili ng issuer na authoritative ang live record, halimbawa para ipakitang na-revoke ang badge sa kalaunan o nag-expire na.
May pangatlong variant para sa signed badges, kung saan signed token ang payload imbes na plain JSON. Kung mahalaga sa use case mo ang signatures, basahin ang paano i-verify ang signature ng Open Badge.
Paano naman ang SVG?
Puwede ring i-bake ang SVG badges, dahil XML ang SVG. Inilalagay ang assertion sa loob ng file sa isang openbadges XML namespace element, at dala ng verify attribute ang URL ng naka-host na assertion. Pareho ang prinsipyo sa PNG: sumasakay ang metadata sa loob ng image file. Sa praktika, PNG ang binebake ng karamihan ng platform, dahil tinatanggap ang PNG halos kahit saan gustong mag-upload ng badge ng mga tao.
Ano ang itsura ng naka-embed na assertion
Para sa 2.0 format, ang naka-host na assertion ay JSON-LD na nag-uugnay sa recipient, badge class, at verification method. Isang pinaikling halimbawa:
{
"@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" }
}
Pansinin ang recipient. Hindi naka-store nang malinaw ang email; ito ay salted SHA-256 hash. Mahalaga ito para sa file na idinisenyong ipasa-pasa. Kahit sinong may hawak ng PNG ay makakabasa ng assertion, kaya hindi dapat ma-leak ng assertion ang address ng recipient. Ang verifier na alam na ang email ay puwedeng i-hash ito gamit ang parehong salt at tingnan kung tugma. Para sa field-by-field na paglalakbay sa dokumentong ito, tingnan ang Open Badge JSON-LD walkthrough.
Paano binabasa ng verifier ang baked badge
Maikli at mekanikal ang proseso ng pag-verify ng baked badge:
- Buksan ang PNG at lakarin ang mga chunk nito.
- Hanapin ang text chunk na may keyword na
openbadges. - Basahin ang payload. Kung JSON, i-parse. Kung URL, i-fetch.
- Tiyaking tumutukoy ang assertion sa badge class at issuer na inaasahan mo, at tugma ang identity ng recipient sa taong nagpapakita nito.
- Kung
hostedang verification type, kumpirmahing umiiral pa rin ang naka-host na assertion saidURL nito at hindi pa na-revoke o nag-expire.
Ang step 5 ang madalas laktawan, at ito ang nagpapaging mapagkakatiwalaan ng isang credential. Snapshot lang ang naka-embed na kopya. Ang naka-host na record ang source of truth.
Sariling pagbasa gamit ang Node
Puwede mong suriin ang kahit anong PNG gamit ang maikling script. Nilalakad nito ang mga chunk at piniprint ang openbadges payload, na kayang hawakan ang parehong tEXt at 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);
I-run ito gamit ang node extract-badge.mjs my-badge.png. Kung baked ang file, makikita mo ang JSON o URL. Kung hindi, makakakuha ka ng simpleng “not baked” na mensahe. Teaching tool ito, hindi buong validator: hindi nito sinusuri ang chunk checksums, hindi nito pina-parse ang signed payloads, at hindi nito kinukuha ang naka-host na record.
Kung ayaw mong magsulat ng code, ipapakita ng online badge validator o PNG metadata viewer ang parehong chunk. Ang format ay ang standard, kaya binabasa ng anumang compliant na tool ang anumang compliant na badge.
Bakit mahalaga ang baking
Portability. Ang credential na PNG lang ay puwedeng i-email, i-upload sa learning platform, o itago sa personal na archive. Hindi kailangan ng account para dalhin ito.
Verification path na nabubuhay kahit wala ang marketing site ng issuer. Pinapangalanan ng naka-embed na assertion ang issuer at tumuturo sa naka-host na record, kaya makakapagsimula ang verifier sa file lang.
Offline at low-tech na workflow. Kapag buong JSON ang payload, makakapag-check ang reader ng claim sa makinang walang network, tapos i-verify ang naka-host na record sa ibang pagkakataon.
Ebidensyang mahirap pekein nang basta-basta. Kahit sino ay makakapag-screenshot ng badge. Walang metadata ang screenshot, kaya hindi ito mave-verify bilang badge file. Iyon lang ay naghihiwalay na sa tunay na credential at kinopyang image. Hindi nito napipigilan ang isang tao na mag-bake ng pekeng assertion sa ninakaw na larawan, kaya may hosted verification step.
Ang mga limitasyon ng baking
Maging tapat sa mga recipient mo tungkol dito, dahil naaapektuhan nito kung paano mo inilalarawan ang mga credential mo.
- Natatanggal ang metadata. Maraming social network, image optimizer, at messaging app ang nag-re-re-encode ng uploads at nagtatanggal ng non-pixel chunks. Ang baked badge na ipinost sa social feed ay kadalasang hindi na baked. Inaasahan iyan, at iyan ang dahilan kung bakit mahalaga ang public verification link kasama ng file.
- Hindi patunay ang baking mismo. Kahit sino ay puwedeng magsulat ng embedded JSON. Ang tiwala ay nagmumula sa naka-host na assertion sa domain ng issuer, o sa valid na signature.
- Sinisira ng image edits ang link. Ang pag-resize o pag-save ulit sa editor ay puwedeng makawala ng chunk.
- PNG at SVG lang. Walang katumbas na chunk convention ang JPEG sa spec, kaya ang photo-style na badge na na-export bilang JPEG ay hindi mabe-bake sa standard na paraan.
Ang praktikal na konklusyon: ituring ang baked file bilang maginhawang carrier, at ang verification page bilang awtoridad. Kung tinitimbang mo ang mga format para sa program mo, ipinapaliwanag ng Open Badges vs PDF certificates kung bakit mas mahusay ang machine-readable na credential kaysa sa static na dokumento.
Paano gumagana ang baking sa https://badges.ninja
Kapag nag-award ka ng badge sa https://badges.ninja, binubuo ng platform ang Open Badge assertion para sa recipient na iyon at binebake ito sa badge image bilang bahagi ng pag-issue. Hindi ka magko-configure ng tool o magre-run ng command. Ang flow:
- Idinisenyo mo ang badge sa visual designer, o mag-upload ng sarili mong image.
- Mag-issue ka ng award, mula sa dashboard, mula sa CSV upload para sa bulk awards, o sa pamamagitan ng API.
- Gumagawa ang platform ng assertion, binebake ito sa PNG, at sine-save ang resulta kasama ng award.
- Nakakakuha ang recipient ng public verification page sa
https://badges.ninja/awards/<awardId>, PDF certificate, QR code, at Add to LinkedIn option.
Kung gumagamit ang badge design ng merge fields tulad ng pangalan ng recipient, bawat award ay may personalized na image, at ang personalized na image na iyon ang binebake.
Itinuturing ang baking bilang pagpapahusay sa pag-issue, hindi hadlang: kung hindi ma-bake ang isang partikular na image (halimbawa ay degenerate na placeholder image), iiisyu pa rin ang award gamit ang orihinal na image, at hindi maaapektuhan ang public verification page at Open Badge JSON-LD. Kailangan ding lumampas sa minimum size ang image na ina-upload mo, kaya tinatanggihan ang napakaliit na blank canvas bago ito makarating sa bakery.
Dahil ang public page ang awtoridad, kahit sino ay makakapag-check ng award nang hindi nagsa-sign up. Ang machine-readable na Open Badge v2.0 JSON-LD para sa isang award ay makukuha sa https://api.badges.ninja/certify-badge/award/<awardId>.
Pag-issue ng isang award sa pamamagitan ng API
Dashboard ang gagamitin ng karamihan ng mambabasa, pero kung ino-automate mo ang pag-issue, isang request lang ang gumagawa ng award (kasama na ang baked image). Palitan ang key at badge id ng sa iyo:
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}`;
Nagbabalik ang call ng HTTP 200 na may { "awardId": "<guid>" }. Buuin ang verification URL mula sa id na iyon. Para sa key setup at buong request reference, tingnan ang Awards API docs at ang authentication guide.

Praktikal na payo para sa mga issuer
Laging maglathala ng verification link sa tabi ng file. Ilagay ang link sa award email, sa certificate, at sa anumang page kung saan ipinapakita ang badge. Dahil tinatanggal ng mga social platform ang metadata, ang link ang nagpapanatiling verifiable ng credential pagkatapos i-share.
Gumamit ng malinis at sapat na laking source image. Magsimula sa PNG na may totoong dimensions. Ang badge na gawa ng designer sa normal na resolution ay maaasahang nabebake; ang 1-pixel na placeholder ay hindi.
Huwag i-edit ang naihatid na file. Sabihan ang mga recipient na i-share ang orihinal na download o ang verification link, hindi ang na-crop na screenshot.
Pagpasyahan kung ano ang gusto mong sabihin tungkol sa revocation at expiry. Dahil authoritative ang naka-host na record, ang baked file ay puwedeng mas tumagal kaysa sa status ng credential. Sabihin ito nang malinaw sa program documentation mo para alam ng mga employer na tingnan ang verification page at hindi lang magtiwala sa file.
Subukan ang isang badge mula simula hanggang dulo. Mag-issue ng award sa sarili mo, i-download ang PNG, patakbuhin sa script sa itaas o sa public validator, at buksan ang verification link. Ang limang minutong pagsubok ay magsasabi sa iyo kung ano ang mararanasan ng mga recipient mo.

Mga madalas itanong
Pareho ba ang baked badge at digital certificate? Hindi. Ang certificate ay kadalasang PDF para basahin at i-print. Ang baked badge ay image na may dala ring machine-readable na credential data. Gumagawa ang https://badges.ninja ng pareho mula sa iisang award.
Puwede ba akong mag-bake ng badge nang walang platform? Oo. Bukas ang specification, at may mga library para sa ilang wika. Ang mas mahirap na bahagi ay ang pag-host ng assertion sa stable na URL, na siyang nagbibigay-kahulugan sa verification. Iyon ang bahaging inaasikaso ng platform para sa iyo.
Ibinubunyag ba ng baking ang email ng recipient? Hindi kapag hashed ang identity. Nag-iimbak ang assertion ng salted hash, kaya hindi ibinubunyag ng file ang address.
Babasahin ba ng LinkedIn ang baked data? Gumagana ang Add to Profile flow ng LinkedIn mula sa pangalan ng credential, issuer, petsa at URL, hindi mula sa file metadata. Tingnan ang pagdaragdag ng Add to LinkedIn button.
Buod
Ang baked Open Badge ay isang PNG (o SVG) na may credential na nakasulat sa text chunk na pinangalanang openbadges. Ginagawa nitong portable at self-describing ang badge, pero ang tunay na tiwala ay nagmumula sa naka-host na assertion sa domain ng issuer. Mag-bake para sa portability, maglathala ng verification link para sa tiwala, at asahang tatanggalin ng mga social network ang metadata.
Handa nang mag-issue ng una mong verifiable credential? Magsimula nang libre sa badges.ninja — visual designer, public verification page, PDF certificate, Open Badge v2.0 output. Hindi kailangan ng credit card.
Paano ginawa ang artikulong ito
Ang ilang artikulo sa blog na ito ay ginagawa gamit ang tulong ng AI assistant, pagkatapos ay sinusuri, tinitiyak ang katumpakan, at ine-edit ng Badges Ninja team bago ilathala. Bawat code sample at presyo ay beripikado laban sa live na produkto. Alamin pa ang tungkol sa aming editorial at AI na proseso sa aming pahina ng editorial process .

Tungkol sa may-akda
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.
Higit pa mula kay Nacho Coll
- Open Badges para sa Coding Bootcamp: Mag-issue ng Verifiable Credentials sa Laki ng Buong CohortNob 19, 2026 · 12min basahin
- Pag-set Up ng Webhooks para sa Badge Events: Real-Time na Integration sa Iyong BackendNob 16, 2026 · 10min basahin
- Expiration at Renewal ng Open Badge: Lifecycle Management para sa mga Credentials na may Takdang PanahonNob 12, 2026 · 12min basahin


