Penjelasan Open Badge Baking: Bagaimana JSON Tinggal di Dalam PNG
Open Badge yang "dibakar" (baked) ialah PNG dengan JSON penegasan tertanam sebagai metadata imej. Fail lencana ITU ialah kelayakan. Cara baking berfungsi + cara mengesahkan lencana yang dibakar.
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.
Muat turun Open Badge daripada hampir mana-mana pengeluar dan anda akan mendapat PNG yang kelihatan biasa. Letakkan dalam sembang, lampirkan pada e-mel, cetak. Ia kelihatan seperti imej lain. Namun fail itu membawa lapisan kedua yang tidak kelihatan: kelayakan itu sendiri, ditulis ke dalam imej sebagai metadata. Itulah yang dipanggil komuniti Open Badges sebagai lencana yang dibakar (baked badge), dan itulah sebabnya sesebuah lencana boleh dibawa sebagai satu fail dan masih membuktikan siapa yang mengeluarkannya, kepada siapa, dan untuk apa.
Panduan ini menerangkan apa itu baking, di mana data tersebut terletak di dalam fail, bagaimana pengesah membacanya semula, dan perkara yang perlu anda putuskan sebagai pengeluar kelayakan. Anda tidak perlu menulis kod untuk menggunakan lencana yang dibakar. Jika anda mengeluarkan melalui https://badges.ninja, baking dilakukan untuk anda. Tetapi memahami mekanismenya membantu anda menjawab soalan yang benar-benar ditanya oleh penerima dan majikan: “Adakah imej ini tulen?” dan “Bolehkah sesiapa sahaja menyalinnya?”
Maksud “baking”
Open Badge mempunyai dua bahagian yang mudah dikelirukan:
- Gambar. PNG atau SVG yang dilihat orang pada profil, slaid, atau sijil.
- Penegasan (assertion). Dokumen JSON kecil yang menyatakan fakta: siapa penerima (sebagai pengecam yang di-hash), kelas lencana mana yang diperoleh, siapa pengeluarnya, bila, dan di mana untuk mengesahkannya.
Baking ialah tindakan menulis penegasan ke dalam gambar supaya keduanya tidak boleh dipisahkan. Hasilnya ialah satu fail. Serahkan PNG itu kepada seseorang dan anda telah menyerahkan kedua-dua imej dan tuntutan di sebaliknya.
Idea ini datang daripada spesifikasi Open Badges yang pada asalnya dibangunkan oleh Mozilla dan kini diselenggara oleh 1EdTech. Tujuan reka bentuk ini ialah kebolehpindahan. Pada awalnya, lencana wujud di dalam satu platform sahaja, dan memindahkannya ke tempat baharu bermakna memuat naik semula dan berharap metadata kekal. Fail yang dibakar membawa metadatanya sendiri ke mana sahaja ia pergi.
Di mana JSON terletak di dalam PNG
Fail PNG ialah tandatangan pendek diikuti urutan chunk. Setiap chunk mempunyai panjang, jenis empat huruf, sedikit data, dan checksum. Pemapar melukis piksel daripada chunk IDAT dan mengabaikan jenis chunk yang tidak difahami. Toleransi itulah yang membolehkan baking: anda boleh menambah chunk penuh teks dan setiap pemapar imej di dunia masih akan memaparkan gambar seperti biasa.
Untuk Open Badges 2.0, penegasan diletakkan dalam chunk teks dengan kata kunci openbadges. Jenis chunk teks yang boleh menyimpannya ialah:
| Chunk | Pengekodan | Nota |
|---|---|---|
tEXt | Latin-1 | Mudah, tetapi terhad kepada aksara Latin-1. |
iTXt | UTF-8 | Diutamakan, kerana nama dan huraian selalunya bukan ASCII. |
Chunk mana pun yang digunakan, susun atur asasnya sama: kata kunci openbadges, pemisah, kemudian muatan. Muatan ialah salah satu daripada dua perkara, bergantung pada cara pengeluar memilih untuk melakukan baking:
- JSON penegasan itu sendiri. Fail ini menerangkan dirinya sendiri. Pengesah boleh membaca tuntutan tanpa sebarang panggilan rangkaian.
- URL yang menuju ke penegasan yang dihoskan. Fail lebih kecil dan pengeluar boleh mengekalkan rekod langsung sebagai yang autoritatif, contohnya untuk menunjukkan bahawa lencana kemudiannya dibatalkan atau telah tamat tempoh.
Varian ketiga wujud untuk lencana bertandatangan, di mana muatan ialah token bertandatangan dan bukannya JSON biasa. Jika tandatangan penting untuk kes penggunaan anda, baca cara mengesahkan tandatangan Open Badge.
Bagaimana dengan SVG?
Lencana SVG juga boleh dibakar, kerana SVG ialah XML. Penegasan diletakkan di dalam fail dalam elemen ruang nama XML openbadges, dan atribut verify membawa URL penegasan yang dihoskan. Prinsipnya sama seperti PNG: metadata menumpang di dalam fail imej. Dalam praktiknya kebanyakan platform membakar PNG, kerana PNG diterima hampir di mana-mana orang mahu memuat naik lencana.
Rupa penegasan yang tertanam
Untuk format 2.0, penegasan yang dihoskan ialah JSON-LD yang menghubungkan penerima, kelas lencana, dan kaedah pengesahan. Contoh ringkas:
{
"@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" }
}
Perhatikan penerima. E-mel tidak disimpan secara jelas; ia ialah hash SHA-256 bergaram. Ini penting untuk fail yang direka untuk diedarkan. Sesiapa yang memegang PNG boleh membaca penegasan, jadi penegasan tidak boleh membocorkan alamat penerima. Pengesah yang sudah tahu e-mel itu boleh melakukan hash dengan garam yang sama dan menyemak bahawa ia sepadan. Untuk tinjauan medan demi medan dokumen ini, lihat panduan Open Badge JSON-LD.
Bagaimana pengesah membaca lencana yang dibakar
Pengesahan lencana yang dibakar ialah proses mekanikal yang ringkas:
- Buka PNG dan lalui chunk-nya.
- Cari chunk teks dengan kata kunci
openbadges. - Baca muatan. Jika JSON, huraikannya. Jika URL, dapatkannya.
- Semak bahawa penegasan merujuk kelas lencana dan pengeluar yang anda jangkakan, dan identiti penerima sepadan dengan orang yang mengemukakannya.
- Jika jenis pengesahan ialah
hosted, sahkan bahawa penegasan yang dihoskan masih wujud pada URLid-nya dan belum dibatalkan atau tamat tempoh.
Langkah 5 ialah langkah yang sering dilangkau, dan ia yang menjadikan kelayakan boleh dipercayai. Salinan tertanam ialah syot kilat. Rekod yang dihoskan ialah sumber kebenaran.
Membacanya sendiri dalam Node
Anda boleh memeriksa mana-mana PNG dengan skrip pendek. Skrip ini melalui chunk dan mencetak muatan openbadges, mengendalikan kedua-dua tEXt dan 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);
Jalankan dengan node extract-badge.mjs my-badge.png. Jika fail itu dibakar, anda akan melihat JSON atau URL. Jika tidak, anda mendapat mesej “not baked” yang ringkas. Ini alat pengajaran, bukan pengesah penuh: ia tidak menyemak checksum chunk, tidak menghuraikan muatan bertandatangan, dan tidak mendapatkan rekod yang dihoskan.
Jika anda tidak mahu menulis kod, pengesah lencana dalam talian atau pemapar metadata PNG akan menunjukkan chunk yang sama. Formatnya ialah standard, jadi mana-mana alat yang patuh membaca mana-mana lencana yang patuh.
Mengapa baking penting
Kebolehpindahan. Kelayakan yang hanya PNG boleh dihantar melalui e-mel, dimuat naik ke platform pembelajaran, atau disimpan dalam arkib peribadi. Tiada akaun diperlukan untuk membawanya.
Laluan pengesahan yang kekal melangkaui laman pemasaran pengeluar. Penegasan tertanam menamakan pengeluar dan menuju ke rekod yang dihoskan, jadi pengesah boleh bermula daripada fail sahaja.
Aliran kerja luar talian dan berteknologi rendah. Apabila muatan ialah JSON penuh, pembaca boleh menyemak tuntutan pada mesin tanpa rangkaian, kemudian mengesahkan rekod yang dihoskan kemudian.
Bukti yang sukar dipalsukan sambil lewa. Sesiapa sahaja boleh mengambil tangkapan skrin lencana. Tangkapan skrin tidak mempunyai metadata, jadi ia tidak boleh disahkan sebagai fail lencana. Itu sahaja sudah membezakan kelayakan sebenar daripada imej yang disalin. Ia tidak menghalang seseorang daripada membakar penegasan palsu ke dalam gambar yang dicuri, dan itulah sebabnya langkah pengesahan yang dihoskan wujud.
Had baking
Berterus-teranglah dengan penerima anda tentang perkara ini, kerana ia mempengaruhi cara anda menerangkan kelayakan anda.
- Metadata dilucutkan. Banyak rangkaian sosial, pengoptimum imej, dan aplikasi pemesejan mengekod semula muat naik dan membuang chunk bukan piksel. Lencana yang dibakar yang disiarkan ke suapan sosial biasanya tidak lagi dibakar. Ini dijangka, dan itulah sebabnya pautan pengesahan awam penting bersama fail.
- Baking bukan bukti dengan sendirinya. JSON tertanam boleh ditulis oleh sesiapa sahaja. Kepercayaan datang daripada penegasan yang dihoskan pada domain pengeluar, atau daripada tandatangan yang sah.
- Suntingan imej memutuskan pautan. Mengubah saiz atau menyimpan semula dalam editor boleh menghilangkan chunk.
- PNG dan SVG sahaja. JPEG tidak mempunyai konvensyen chunk yang setara dalam spesifikasi, jadi lencana gaya foto yang dieksport sebagai JPEG tidak boleh dibakar dengan cara standard.
Kesimpulan praktikal: anggap fail yang dibakar sebagai pembawa yang mudah, dan anggap halaman pengesahan sebagai pihak berkuasa. Jika anda menimbang format untuk program anda, Open Badges lwn sijil PDF menerangkan mengapa kelayakan yang boleh dibaca mesin mengatasi dokumen statik.
Cara baking berfungsi di https://badges.ninja
Apabila anda menganugerahkan lencana di https://badges.ninja, platform membina penegasan Open Badge untuk penerima itu dan membakarnya ke dalam imej lencana sebagai sebahagian daripada pengeluaran. Anda tidak perlu mengkonfigurasi alat atau menjalankan arahan. Alirannya:
- Anda mereka bentuk lencana dalam pereka visual, atau memuat naik imej anda sendiri.
- Anda mengeluarkan anugerah, daripada papan pemuka, daripada muat naik CSV untuk anugerah pukal, atau melalui API.
- Platform mencipta penegasan, membakarnya ke dalam PNG, dan menyimpan hasilnya bersama anugerah.
- Penerima mendapat halaman pengesahan awam di
https://badges.ninja/awards/<awardId>, sijil PDF, kod QR, dan pilihan Add to LinkedIn.
Jika reka bentuk lencana menggunakan medan gabungan seperti nama penerima, setiap anugerah mendapat imej yang diperibadikan, dan imej yang diperibadikan itulah yang dibakar.
Baking dianggap sebagai penambahbaikan kepada pengeluaran, bukan penghalang: jika imej tertentu tidak boleh dibakar (contohnya imej pemegang tempat yang merosot), anugerah tetap dikeluarkan menggunakan imej asal, dan halaman pengesahan awam serta Open Badge JSON-LD tidak terjejas. Imej yang anda muat naik juga mesti melepasi saiz minimum, jadi kanvas kosong yang kecil ditolak sebelum sampai ke tempat pembakaran.
Kerana halaman awam ialah pihak berkuasa, sesiapa sahaja boleh menyemak anugerah tanpa mendaftar. JSON-LD Open Badge v2.0 yang boleh dibaca mesin untuk sesuatu anugerah tersedia di https://api.badges.ninja/certify-badge/award/<awardId>.
Mengeluarkan satu anugerah melalui API
Kebanyakan pembaca akan menggunakan papan pemuka, tetapi jika anda mengautomasikan pengeluaran, satu permintaan mencipta anugerah (dan imej yang dibakar disertakan bersamanya). Gantikan kunci dan id lencana dengan milik anda:
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}`;
Panggilan ini mengembalikan HTTP 200 dengan { "awardId": "<guid>" }. Bina URL pengesahan daripada id itu. Untuk persediaan kunci dan rujukan permintaan penuh, lihat dokumen Awards API dan panduan pengesahihan.

Nasihat praktikal untuk pengeluar
Sentiasa terbitkan pautan pengesahan di sebelah fail. Letakkan pautan dalam e-mel anugerah, pada sijil, dan pada mana-mana halaman yang memaparkan lencana. Memandangkan platform sosial melucutkan metadata, pautan itulah yang mengekalkan kelayakan boleh disahkan selepas dikongsi.
Gunakan imej sumber yang bersih dan bersaiz sewajarnya. Mulakan daripada PNG dengan dimensi sebenar. Lencana buatan pereka pada resolusi biasa dibakar dengan pasti; pemegang tempat 1 piksel tidak.
Jangan sunting fail yang dihantar. Beritahu penerima supaya berkongsi muat turun asal atau pautan pengesahan, bukan tangkapan skrin yang dipotong.
Tentukan apa yang anda mahu katakan tentang pembatalan dan tamat tempoh. Oleh sebab rekod yang dihoskan ialah autoritatif, fail yang dibakar boleh hidup lebih lama daripada status kelayakan. Nyatakan dengan jelas dalam dokumentasi program anda supaya majikan tahu untuk menyemak halaman pengesahan dan bukan hanya mempercayai fail.
Uji satu lencana dari hujung ke hujung. Keluarkan anugerah kepada diri sendiri, muat turun PNG, jalankan melalui skrip di atas atau pengesah awam, dan buka pautan pengesahan. Lima minit ujian memberitahu anda apa yang akan dialami penerima anda.

Soalan lazim
Adakah lencana yang dibakar sama dengan sijil digital? Tidak. Sijil biasanya PDF untuk dibaca dan dicetak. Lencana yang dibakar ialah imej yang turut membawa data kelayakan yang boleh dibaca mesin. https://badges.ninja menghasilkan kedua-duanya daripada anugerah yang sama.
Bolehkah saya membakar lencana tanpa platform? Boleh. Spesifikasinya terbuka, dan pustaka wujud untuk beberapa bahasa. Bahagian yang lebih sukar ialah menghoskan penegasan pada URL yang stabil, yang menjadikan pengesahan bermakna. Itulah bahagian yang diuruskan platform untuk anda.
Adakah baking mendedahkan e-mel penerima? Tidak apabila identiti di-hash. Penegasan menyimpan hash bergaram, jadi fail tidak mendedahkan alamat.
Adakah LinkedIn akan membaca data yang dibakar? Aliran Add to Profile LinkedIn berfungsi daripada nama kelayakan, pengeluar, tarikh dan URL, bukan daripada metadata fail. Lihat menambah butang Add to LinkedIn.
Ringkasan
Open Badge yang dibakar ialah PNG (atau SVG) dengan kelayakan ditulis ke dalam chunk teks bernama openbadges. Ia menjadikan lencana mudah alih dan menerangkan dirinya sendiri, tetapi kepercayaan sebenar datang daripada penegasan yang dihoskan pada domain pengeluar. Bakar untuk kebolehpindahan, terbitkan pautan pengesahan untuk kepercayaan, dan jangkakan rangkaian sosial melucutkan metadata.
Bersedia untuk mengeluarkan kelayakan boleh disahkan pertama anda? Mulakan percuma di badges.ninja — pereka visual, halaman pengesahan awam, sijil PDF, output Open Badge v2.0. Tiada kad kredit diperlukan.
Bagaimana artikel ini dihasilkan
Sebahagian catatan di blog ini dirangka dengan bantuan pembantu AI, kemudian disemak, disahkan fakta, dan disunting oleh pasukan Badges Ninja sebelum diterbitkan. Setiap sampel kod dan harga disahkan berdasarkan produk sebenar. Ketahui lebih lanjut tentang proses editorial dan AI kami di halaman proses editorial .

Tentang penulis
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.
Lagi daripada Nacho Coll
- Open Badges untuk Bootcamp Pengekodan: Mengeluarkan Kelayakan Digital Boleh Disahkan pada Skala Kohort19 Nov 2026 · 10minit bacaan
- Menyediakan Webhook untuk Peristiwa Lencana: Integrasi Masa Nyata dengan Backend Anda16 Nov 2026 · 8minit bacaan
- Tamat Tempoh dan Pembaharuan Open Badge: Pengurusan Kitaran Hayat untuk Kelayakan Berhad Masa12 Nov 2026 · 10minit bacaan


