Open Badge Baking Dijelaskan: Bagaimana JSON Tinggal di Dalam PNG
Open Badge yang «dibake» adalah PNG dengan JSON assertion yang disematkan sebagai metadata gambar. File lencana itu ADALAH kredensialnya. Cara kerja baking + cara memverifikasi lencana yang dibake.
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.
Unduh Open Badge dari hampir semua penerbit dan Anda mendapatkan PNG yang tampak biasa. Masukkan ke chat, lampirkan di email, cetak. Tampilannya seperti gambar lainnya. Namun file itu membawa lapisan kedua yang tak terlihat: kredensial itu sendiri, yang ditulis ke dalam gambar sebagai metadata. Inilah yang disebut komunitas Open Badges sebagai baked badge, dan inilah alasan sebuah lencana bisa berpindah sebagai satu file namun tetap membuktikan siapa penerbitnya, untuk siapa, dan untuk apa.
Panduan ini menjelaskan apa itu baking, di mana data berada di dalam file, bagaimana verifier membacanya kembali, dan apa yang perlu Anda putuskan sebagai penerbit kredensial. Anda tidak perlu menulis kode untuk memakai lencana yang dibake. Jika Anda menerbitkan lewat https://badges.ninja, baking dilakukan otomatis. Tetapi memahami mekanismenya membantu Anda menjawab pertanyaan yang benar-benar diajukan penerima dan pemberi kerja: “Apakah gambar ini asli?” dan “Bisakah siapa saja menyalinnya begitu saja?”
Apa arti “baking”
Sebuah Open Badge punya dua bagian yang mudah tertukar:
- Gambarnya. PNG atau SVG yang dilihat orang di profil, slide, atau sertifikat.
- Assertion. Dokumen JSON kecil yang menyatakan fakta: siapa penerimanya (sebagai identifier yang di-hash), badge class mana yang diraih, siapa penerbitnya, kapan, dan di mana memverifikasinya.
Baking adalah tindakan menulis assertion ke dalam gambar sehingga keduanya tidak dapat dipisahkan. Hasilnya satu file. Serahkan PNG itu kepada seseorang dan Anda telah menyerahkan gambar sekaligus klaim di baliknya.
Gagasan ini berasal dari spesifikasi Open Badges yang awalnya dikembangkan oleh Mozilla dan kini dikelola oleh 1EdTech. Inti desainnya adalah portabilitas. Pada awalnya, lencana hidup di dalam satu platform, dan memindahkannya ke tempat baru berarti mengunggah ulang sambil berharap metadata tetap utuh. File yang dibake membawa metadatanya sendiri ke mana pun ia pergi.
Di mana JSON berada di dalam PNG
File PNG adalah tanda tangan (signature) pendek diikuti rangkaian chunk. Setiap chunk memiliki panjang, tipe empat huruf, sejumlah data, dan checksum. Viewer menggambar piksel dari chunk IDAT dan mengabaikan tipe chunk yang tidak mereka kenali. Toleransi itulah yang memungkinkan baking: Anda bisa menambahkan chunk berisi teks dan setiap penampil gambar di dunia tetap menampilkan gambar seperti biasa.
Untuk Open Badges 2.0, assertion masuk ke chunk teks dengan keyword openbadges. Tipe chunk teks yang dapat menyimpannya adalah:
| Chunk | Encoding | Catatan |
|---|---|---|
tEXt | Latin-1 | Sederhana, tetapi terbatas pada karakter Latin-1. |
iTXt | UTF-8 | Lebih disukai, karena nama dan deskripsi sering bukan ASCII. |
Chunk mana pun yang dipakai, susunannya sama: keyword openbadges, sebuah pemisah, lalu payload. Payload berupa salah satu dari dua hal, tergantung cara penerbit memilih untuk membake:
- JSON assertion itu sendiri. File bersifat self-describing. Verifier dapat membaca klaim tanpa panggilan jaringan apa pun.
- URL yang menunjuk ke assertion yang di-host. File lebih kecil dan penerbit dapat menjadikan catatan aktif sebagai rujukan utama, misalnya untuk menunjukkan bahwa lencana kemudian dicabut atau telah kedaluwarsa.
Ada varian ketiga untuk lencana bertanda tangan, di mana payload berupa token bertanda tangan, bukan JSON polos. Jika tanda tangan penting untuk kasus penggunaan Anda, baca cara memverifikasi tanda tangan Open Badge.
Bagaimana dengan SVG?
Lencana SVG juga bisa dibake, karena SVG adalah XML. Assertion ditempatkan di dalam file pada elemen namespace XML openbadges, dan atribut verify membawa URL assertion yang di-host. Prinsipnya sama seperti PNG: metadata menumpang di dalam file gambar. Dalam praktiknya sebagian besar platform membake PNG, karena PNG diterima hampir di mana pun orang ingin mengunggah lencana.
Seperti apa assertion yang tertanam
Untuk format 2.0, assertion yang di-host adalah JSON-LD yang menghubungkan penerima, badge class, dan metode verifikasi. Contoh yang diringkas:
{
"@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 bagian penerima. Email tidak disimpan apa adanya; ia berupa hash SHA-256 bersalt. Ini penting untuk file yang dirancang untuk diedarkan. Siapa pun yang memegang PNG dapat membaca assertion, jadi assertion tidak boleh membocorkan alamat penerima. Verifier yang sudah mengetahui email dapat meng-hash-nya dengan salt yang sama dan memeriksa kecocokannya. Untuk tur dokumen ini bidang demi bidang, lihat penjelasan JSON-LD Open Badge.
Bagaimana verifier membaca lencana yang dibake
Verifikasi lencana yang dibake adalah proses mekanis yang singkat:
- Buka PNG dan telusuri chunk-chunknya.
- Temukan chunk teks dengan keyword
openbadges. - Baca payload. Jika berupa JSON, parse. Jika berupa URL, ambil (fetch).
- Periksa bahwa assertion merujuk ke badge class dan penerbit yang Anda harapkan, dan bahwa identitas penerima cocok dengan orang yang menyajikannya.
- Jika tipe verifikasinya
hosted, pastikan assertion yang di-host masih ada di URLid-nya dan belum dicabut atau kedaluwarsa.
Langkah 5 adalah yang sering dilewati orang, dan itulah yang membuat kredensial dapat dipercaya. Salinan yang tertanam hanyalah snapshot. Catatan yang di-host adalah sumber kebenaran.
Membacanya sendiri di Node
Anda dapat memeriksa PNG apa pun dengan skrip singkat. Skrip ini menelusuri chunk dan mencetak payload openbadges, menangani tEXt maupun 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 file dibake, Anda akan melihat JSON atau URL. Jika tidak, Anda mendapat pesan sederhana “not baked”. Ini alat bantu belajar, bukan validator lengkap: ia tidak memeriksa checksum chunk, tidak mem-parse payload bertanda tangan, dan tidak mengambil catatan yang di-host.
Jika Anda tidak ingin menulis kode, validator lencana online atau penampil metadata PNG akan menunjukkan chunk yang sama. Formatnya adalah standar, sehingga alat yang patuh standar mana pun dapat membaca lencana yang patuh standar mana pun.
Mengapa baking penting
Portabilitas. Kredensial yang hanya berupa PNG dapat diemail, diunggah ke platform pembelajaran, atau disimpan di arsip pribadi. Tidak perlu akun untuk membawanya.
Jalur verifikasi yang bertahan melampaui situs pemasaran penerbit. Assertion yang tertanam menyebut penerbit dan menunjuk ke catatan yang di-host, sehingga verifier bisa memulai hanya dari file.
Alur kerja offline dan berteknologi rendah. Ketika payload adalah JSON lengkap, pembaca dapat memeriksa klaim di mesin tanpa jaringan, lalu memverifikasi catatan yang di-host nanti.
Bukti yang sulit dipalsukan secara sembarangan. Siapa pun bisa men-screenshot lencana. Screenshot tidak memiliki metadata, sehingga tidak dapat diverifikasi sebagai file lencana. Itu saja sudah membedakan kredensial asli dari gambar salinan. Itu tidak menghentikan seseorang membake assertion palsu ke gambar curian, dan karena itulah langkah verifikasi yang di-host ada.
Keterbatasan baking
Bersikaplah jujur kepada penerima Anda tentang hal-hal ini, karena memengaruhi cara Anda mendeskripsikan kredensial.
- Metadata terhapus. Banyak jejaring sosial, pengoptimal gambar, dan aplikasi pesan meng-encode ulang unggahan dan membuang chunk non-piksel. Lencana yang dibake lalu diposting ke feed sosial biasanya tidak lagi terbake. Itu wajar, dan itulah sebabnya tautan verifikasi publik penting di samping file.
- Baking bukan bukti dengan sendirinya. JSON yang tertanam dapat ditulis siapa saja. Kepercayaan berasal dari assertion yang di-host pada domain penerbit, atau dari tanda tangan yang valid.
- Pengeditan gambar memutus tautan. Mengubah ukuran atau menyimpan ulang di editor dapat menghilangkan chunk.
- Hanya PNG dan SVG. JPEG tidak memiliki konvensi chunk setara dalam spesifikasi, sehingga lencana bergaya foto yang diekspor sebagai JPEG tidak dapat dibake dengan cara standar.
Kesimpulan praktisnya: perlakukan file yang dibake sebagai pembawa yang praktis, dan perlakukan halaman verifikasi sebagai otoritasnya. Jika Anda menimbang format untuk program Anda, Open Badges vs sertifikat PDF membahas mengapa kredensial yang dapat dibaca mesin lebih unggul daripada dokumen statis.
Cara kerja baking di https://badges.ninja
Saat Anda memberikan lencana di https://badges.ninja, platform membangun assertion Open Badge untuk penerima tersebut dan membake-nya ke gambar lencana sebagai bagian dari proses penerbitan. Anda tidak perlu mengonfigurasi alat atau menjalankan perintah. Alurnya:
- Anda mendesain lencana di visual designer, atau mengunggah gambar Anda sendiri.
- Anda menerbitkan award, dari dashboard, dari unggahan CSV untuk award massal, atau lewat API.
- Platform membuat assertion, membake-nya ke PNG, dan menyimpan hasilnya bersama award.
- Penerima mendapatkan halaman verifikasi publik di
https://badges.ninja/awards/<awardId>, sertifikat PDF, kode QR, dan opsi Add to LinkedIn.
Jika desain lencana memakai merge field seperti nama penerima, setiap award mendapat gambar yang dipersonalisasi, dan gambar yang dipersonalisasi itulah yang dibake.
Baking diperlakukan sebagai penyempurnaan penerbitan, bukan syarat penghalang: jika suatu gambar tertentu tidak dapat dibake (misalnya gambar placeholder yang rusak/degenerate), award tetap diterbitkan menggunakan gambar asli, dan halaman verifikasi publik serta JSON-LD Open Badge tidak terpengaruh. Gambar yang Anda unggah juga harus memenuhi ukuran minimum, sehingga kanvas kosong yang sangat kecil ditolak sebelum sampai ke bakery.
Karena halaman publik adalah otoritasnya, siapa pun dapat memeriksa award tanpa mendaftar. JSON-LD Open Badge v2.0 yang dapat dibaca mesin untuk sebuah award tersedia di https://api.badges.ninja/certify-badge/award/<awardId>.
Menerbitkan satu award lewat API
Kebanyakan pembaca akan memakai dashboard, tetapi jika Anda mengotomatiskan penerbitan, satu request membuat award (dan gambar yang dibake ikut serta). Ganti key dan badge id 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>" }. Bangun URL verifikasi dari id tersebut. Untuk penyiapan key dan referensi request lengkap, lihat dokumentasi Awards API dan panduan autentikasi.

Saran praktis untuk penerbit
Selalu publikasikan tautan verifikasi di samping file. Letakkan tautan di email award, di sertifikat, dan di halaman mana pun tempat lencana ditampilkan. Karena platform sosial menghapus metadata, tautanlah yang menjaga kredensial tetap dapat diverifikasi setelah dibagikan.
Gunakan gambar sumber yang bersih dan berukuran memadai. Mulailah dari PNG dengan dimensi yang sebenarnya. Lencana buatan desainer pada resolusi normal dibake dengan andal; placeholder 1 piksel tidak.
Jangan edit file yang dikirimkan. Minta penerima membagikan unduhan asli atau tautan verifikasi, bukan screenshot yang dipotong.
Putuskan apa yang ingin Anda sampaikan tentang pencabutan dan kedaluwarsa. Karena catatan yang di-host bersifat otoritatif, file yang dibake bisa bertahan lebih lama daripada status kredensialnya. Nyatakan ini dengan jelas dalam dokumentasi program Anda agar pemberi kerja tahu untuk memeriksa halaman verifikasi, bukan hanya memercayai file.
Uji satu lencana dari ujung ke ujung. Terbitkan award untuk diri Anda sendiri, unduh PNG-nya, jalankan lewat skrip di atas atau validator publik, dan buka tautan verifikasinya. Lima menit pengujian memberi tahu apa yang akan dialami penerima Anda.

Pertanyaan yang sering diajukan
Apakah lencana yang dibake sama dengan sertifikat digital? Tidak. Sertifikat biasanya berupa PDF untuk dibaca dan dicetak. Lencana yang dibake adalah gambar yang juga membawa data kredensial yang dapat dibaca mesin. https://badges.ninja menghasilkan keduanya dari award yang sama.
Bisakah saya membake lencana tanpa platform? Bisa. Spesifikasinya terbuka, dan ada pustaka untuk beberapa bahasa. Bagian yang lebih sulit adalah meng-host assertion pada URL yang stabil, yang membuat verifikasi bermakna. Itulah bagian yang ditangani platform untuk Anda.
Apakah baking mengungkap email penerima? Tidak, selama identitasnya di-hash. Assertion menyimpan hash bersalt, sehingga file tidak mengungkap alamatnya.
Apakah LinkedIn akan membaca data yang dibake? Alur Add to Profile LinkedIn bekerja dari nama kredensial, penerbit, tanggal, dan URL, bukan dari metadata file. Lihat menambahkan tombol Add to LinkedIn.
Ringkasan
Open Badge yang dibake adalah PNG (atau SVG) dengan kredensial yang ditulis ke dalam chunk teks bernama openbadges. Ini membuat lencana portabel dan self-describing, tetapi kepercayaan sejati berasal dari assertion yang di-host pada domain penerbit. Bake untuk portabilitas, publikasikan tautan verifikasi untuk kepercayaan, dan harapkan jejaring sosial menghapus metadata.
Siap menerbitkan kredensial terverifikasi pertama Anda? Mulai gratis di badges.ninja — visual designer, halaman verifikasi publik, sertifikat PDF, keluaran Open Badge v2.0. Tanpa kartu kredit.
Bagaimana artikel ini dibuat
Beberapa artikel di blog ini disusun dengan bantuan asisten AI, lalu ditinjau, diperiksa faktanya, dan disunting oleh tim Badges Ninja sebelum dipublikasikan. Setiap contoh kode dan harga diverifikasi terhadap produk yang aktif. Baca selengkapnya 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.
Lainnya dari Nacho Coll
- Open Badges untuk Bootcamp Coding: Menerbitkan Kredensial Terverifikasi dalam Skala Angkatan19 Nov 2026 · 10menit baca
- Menyiapkan Webhook untuk Peristiwa Lencana: Integrasi Real-Time dengan Backend Anda16 Nov 2026 · 8menit baca
- Masa Berlaku dan Perpanjangan Open Badge: Manajemen Siklus Hidup Kredensial Berbatas Waktu12 Nov 2026 · 10menit baca


