Open Badge Baking explicat: cum trăiește JSON-ul în interiorul PNG-ului

O insignă Open Badge „coaptă” este un PNG cu JSON-ul asertiunii încorporat ca metadate de imagine. Fișierul insignei ESTE credențialul. Cum funcționează baking-ul și cum verifici o insignă coaptă.

Nacho Coll De Actualizat 11 min de citit
O insignă Open Badge „coaptă” este un PNG cu JSON-ul asertiunii încorporat ca metadate de imagine. Fișierul insignei ESTE credențialul. Cum funcționează baking-ul și cum verifici o insignă coaptă.

Descarcă o insignă Open Badge de la aproape orice emitent și primești un PNG care arată complet obișnuit. Îl poți trimite într-un chat, îl poți atașa la un e-mail, îl poți tipări. Arată ca orice altă imagine. Dar fișierul ascunde un al doilea strat, invizibil: credențialul în sine, scris în imagine sub formă de metadate. Comunitatea Open Badges îl numește insignă coaptă (baked badge) și tocmai de aceea o insignă poate circula ca un singur fișier și totuși poate dovedi cine a emis-o, cui și pentru ce.

Acest ghid explică ce este baking-ul, unde se află datele în fișier, cum le citește un verificator și ce trebuie să decizi ca emitent de credențiale. Nu ai nevoie să scrii cod pentru a folosi insignele coapte. Dacă emiți prin https://badges.ninja, baking-ul se face automat. Dar înțelegerea mecanismului te ajută să răspunzi la întrebările pe care le pun de fapt destinatarii și angajatorii: „Este imaginea asta reală?” și „Poate oricine să o copieze?”

Ce înseamnă „baking”

O insignă Open Badge are două părți ușor de confundat:

  • Imaginea. PNG-ul sau SVG-ul pe care oamenii îl văd pe un profil, într-o prezentare sau pe o diplomă.
  • Asertiunea. Un mic document JSON care enunță faptele: cine este destinatarul (ca identificator hash-uit), ce clasă de insignă a fost obținută, cine a emis-o, când și unde poate fi verificată.

Baking-ul este actul de a scrie asertiunea în imagine, astfel încât cele două să nu mai poată fi separate. Rezultatul este un singur fișier. Dacă îi dai cuiva PNG-ul, i-ai dat atât imaginea, cât și afirmația din spatele ei.

Ideea vine din specificația Open Badges, dezvoltată inițial de Mozilla și întreținută acum de 1EdTech. Scopul designului este portabilitatea. La început, insignele trăiau în interiorul unei singure platforme, iar mutarea uneia în alt loc însemna reîncărcare și speranța că metadatele supraviețuiesc. Un fișier copt își poartă propriile metadate oriunde ajunge.

Unde trăiește JSON-ul într-un PNG

Un fișier PNG este o scurtă semnătură urmată de o secvență de chunk-uri. Fiecare chunk are o lungime, un tip de patru litere, niște date și o sumă de control. Vizualizatoarele desenează pixelii din chunk-urile IDAT și ignoră tipurile de chunk pe care nu le înțeleg. Această toleranță face baking-ul posibil: poți adăuga un chunk plin de text, iar orice vizualizator de imagini din lume va afișa în continuare imaginea normal.

Pentru Open Badges 2.0, asertiunea se pune într-un chunk de text cu cuvântul-cheie openbadges. Tipurile de chunk de text care o pot conține sunt:

ChunkCodificareNote
tEXtLatin-1Simplu, dar limitat la caractere Latin-1.
iTXtUTF-8Preferat, pentru că numele și descrierile nu sunt adesea ASCII.

Indiferent de chunk, structura este aceeași: cuvântul-cheie openbadges, un separator, apoi conținutul. Conținutul este unul din două lucruri, în funcție de cum a ales emitentul să facă baking-ul:

  1. Chiar JSON-ul asertiunii. Fișierul se descrie singur. Un verificator poate citi afirmația fără niciun apel în rețea.
  2. Un URL care indică asertiunea găzduită. Fișierul este mai mic, iar emitentul poate păstra înregistrarea live ca sursă autoritară, de exemplu pentru a arăta că o insignă a fost ulterior revocată sau a expirat.

Există și o a treia variantă, pentru insignele semnate, în care conținutul este un token semnat în loc de JSON simplu. Dacă semnăturile contează pentru cazul tău de utilizare, citește cum verifici semnătura unei insigne Open Badge.

Dar SVG?

Insignele SVG pot fi coapte și ele, deoarece SVG este XML. Asertiunea este plasată în fișier într-un element din namespace-ul XML openbadges, iar atributul verify conține URL-ul asertiunii găzduite. Principiul este același ca la PNG: metadatele călătoresc în interiorul fișierului imagine. În practică, majoritatea platformelor coc PNG, pentru că PNG este acceptat aproape peste tot unde oamenii vor să încarce o insignă.

Cum arată asertiunea încorporată

Pentru formatul 2.0, o asertiune găzduită este JSON-LD care leagă destinatarul, clasa insignei și metoda de verificare. Un exemplu prescurtat:

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

Observă destinatarul. E-mailul nu este stocat în clar; este un hash SHA-256 cu salt. Asta contează pentru un fișier făcut să circule. Oricine deține PNG-ul poate citi asertiunea, deci asertiunea nu trebuie să dezvăluie adresa destinatarului. Un verificator care cunoaște deja e-mailul îl poate hash-ui cu același salt și poate verifica dacă se potrivește. Pentru o prezentare câmp cu câmp a acestui document, vezi parcurgerea Open Badge JSON-LD.

Cum citește un verificator o insignă coaptă

Verificarea unei insigne coapte este un proces scurt și mecanic:

  1. Deschide PNG-ul și parcurge chunk-urile.
  2. Găsește chunk-ul de text cu cuvântul-cheie openbadges.
  3. Citește conținutul. Dacă este JSON, parsează-l. Dacă este un URL, descarcă-l.
  4. Verifică dacă asertiunea se referă la clasa de insignă și la emitentul pe care îi aștepți și dacă identitatea destinatarului corespunde persoanei care o prezintă.
  5. Dacă tipul de verificare este hosted, confirmă că asertiunea găzduită există încă la URL-ul id și nu a fost revocată sau expirată.

Pasul 5 este cel pe care oamenii îl sar, și el este cel care face un credențial demn de încredere. O copie încorporată este un instantaneu. Înregistrarea găzduită este sursa adevărului.

Citește-l singur în Node

Poți inspecta orice PNG cu un script scurt. Acesta parcurge chunk-urile și afișează conținutul openbadges, tratând atât tEXt, cât și 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);

Rulează-l cu node extract-badge.mjs my-badge.png. Dacă fișierul este copt, vei vedea JSON sau un URL. Dacă nu, primești un simplu mesaj „not baked”. Este un instrument didactic, nu un validator complet: nu verifică sumele de control ale chunk-urilor, nu parsează conținuturi semnate și nu descarcă înregistrarea găzduită.

Dacă preferi să nu scrii cod, un validator online de insigne sau un vizualizator de metadate PNG va arăta același chunk. Formatul este standardul, deci orice instrument conform citește orice insignă conformă.

De ce contează baking-ul

Portabilitate. Un credențial care este doar un PNG poate fi trimis prin e-mail, încărcat pe o platformă de învățare sau păstrat într-o arhivă personală. Nu ai nevoie de cont ca să-l duci cu tine.

O cale de verificare care supraviețuiește site-ului de marketing al emitentului. Asertiunea încorporată numește emitentul și indică înregistrarea găzduită, așa că un verificator poate porni doar de la fișier.

Fluxuri offline și low-tech. Când conținutul este JSON-ul complet, un cititor poate verifica afirmația pe o mașină fără rețea și poate verifica înregistrarea găzduită mai târziu.

Dovezi greu de falsificat casual. Oricine poate face o captură de ecran a unei insigne. O captură nu are metadate, deci nu poate fi verificată ca fișier de insignă. Asta singură separă un credențial real de o imagine copiată. Nu oprește pe cineva să coacă o asertiune falsă într-o imagine furată, motiv pentru care există pasul de verificare găzduită.

Limitele baking-ului

Fii sincer cu destinatarii tăi în privința lor, pentru că influențează modul în care îți descrii credențialele.

  • Metadatele sunt șterse. Multe rețele sociale, optimizatoare de imagini și aplicații de mesagerie re-codifică încărcările și elimină chunk-urile care nu sunt pixeli. O insignă coaptă postată pe o rețea socială de obicei nu mai este coaptă. Este de așteptat și de aceea contează un link public de verificare alături de fișier.
  • Baking-ul nu este o dovadă în sine. JSON-ul încorporat poate fi scris de oricine. Încrederea vine din asertiunea găzduită pe domeniul emitentului sau dintr-o semnătură validă.
  • Editările imaginii rup legătura. Redimensionarea sau re-salvarea într-un editor poate pierde chunk-ul.
  • Doar PNG și SVG. JPEG nu are o convenție echivalentă de chunk în specificație, deci o insignă de tip fotografie exportată ca JPEG nu poate fi coaptă în modul standard.

Concluzia practică: tratează fișierul copt ca pe un purtător convenabil, iar pagina de verificare ca pe autoritate. Dacă compari formate pentru programul tău, Open Badges vs certificate PDF explică de ce un credențial care poate fi citit de mașini bate un document static.

Cum funcționează baking-ul pe https://badges.ninja

Când acorzi o insignă pe https://badges.ninja, platforma construiește asertiunea Open Badge pentru acel destinatar și o coace în imaginea insignei ca parte a emiterii. Nu configurezi niciun instrument și nu rulezi nicio comandă. Fluxul:

  1. Proiectezi insigna în designerul vizual sau încarci propria imagine.
  2. Emiți un premiu, din dashboard, dintr-un upload CSV pentru premii în masă sau prin API.
  3. Platforma creează asertiunea, o coace în PNG și stochează rezultatul împreună cu premiul.
  4. Destinatarul primește o pagină publică de verificare la https://badges.ninja/awards/<awardId>, un certificat PDF, un cod QR și o opțiune Add to LinkedIn.

Dacă designul insignei folosește câmpuri de îmbinare, cum ar fi numele destinatarului, fiecare premiu primește o imagine personalizată, iar imaginea personalizată este cea care se coace.

Baking-ul este tratat ca un plus al emiterii, nu ca o barieră: dacă o anumită imagine nu poate fi coaptă (de exemplu o imagine placeholder degenerată), premiul este emis oricum folosind imaginea originală, iar pagina publică de verificare și Open Badge JSON-LD nu sunt afectate. Imaginea încărcată trebuie să depășească și o dimensiune minimă, astfel că un canvas gol minuscul este respins înainte să ajungă la bakery.

Deoarece pagina publică este autoritatea, oricine poate verifica un premiu fără să se înregistreze. JSON-LD-ul Open Badge v2.0 care poate fi citit de mașini pentru un premiu este disponibil la https://api.badges.ninja/certify-badge/award/<awardId>.

Emiterea unui premiu prin API

Majoritatea cititorilor vor folosi dashboardul, dar dacă automatizezi emiterea, o singură cerere creează premiul (iar imaginea coaptă vine odată cu el). Înlocuiește cheia și id-ul insignei cu ale tale:

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

Apelul returnează HTTP 200 cu { "awardId": "<guid>" }. Construiește URL-ul de verificare din acest id. Pentru configurarea cheii și referința completă a cererii, vezi documentația Awards API și ghidul de autentificare.

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

Sfaturi practice pentru emitenți

Publică întotdeauna un link de verificare lângă fișier. Pune linkul în e-mailul de premiu, pe certificat și pe orice pagină unde este afișată insigna. Deoarece platformele sociale șterg metadatele, linkul este cel care păstrează credențialul verificabil după partajare.

Folosește o imagine sursă curată, de dimensiuni decente. Pornește de la un PNG cu dimensiuni reale. O insignă făcută de un designer la rezoluție normală se coace fiabil; un placeholder de 1 pixel nu.

Nu edita fișierul livrat. Spune-le destinatarilor să partajeze descărcarea originală sau linkul de verificare, nu o captură de ecran decupată.

Decide ce vrei să spui despre revocare și expirare. Deoarece înregistrarea găzduită este autoritară, un fișier copt poate supraviețui statutului credențialului. Spune clar asta în documentația programului tău, ca angajatorii să știe să verifice pagina de verificare, în loc să aibă încredere doar în fișier.

Testează o insignă cap-coadă. Emite un premiu pentru tine, descarcă PNG-ul, rulează-l prin scriptul de mai sus sau printr-un validator public și deschide linkul de verificare. Cinci minute de testare îți arată ce vor experimenta destinatarii tăi.

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

Întrebări frecvente

Este o insignă coaptă același lucru cu un certificat digital? Nu. Un certificat este de obicei un PDF pentru citit și tipărit. O insignă coaptă este o imagine care poartă și date de credențial care pot fi citite de mașini. https://badges.ninja produce ambele din același premiu.

Pot coace o insignă fără o platformă? Da. Specificația este deschisă și există biblioteci pentru mai multe limbaje. Partea mai grea este găzduirea asertiunii la un URL stabil, ceea ce face verificarea semnificativă. Aceasta este partea pe care o rezolvă o platformă pentru tine.

Expune baking-ul e-mailul destinatarului? Nu, când identitatea este hash-uită. Asertiunea stochează un hash cu salt, deci fișierul nu dezvăluie adresa.

Va citi LinkedIn datele coapte? Fluxul Add to Profile de la LinkedIn funcționează pe baza numelui credențialului, a emitentului, a datei și a URL-ului, nu a metadatelor fișierului. Vezi adăugarea unui buton Add to LinkedIn.

Rezumat

O insignă Open Badge coaptă este un PNG (sau SVG) cu credențialul scris într-un chunk de text numit openbadges. O face portabilă și auto-descriptivă, dar încrederea reală vine din asertiunea găzduită pe domeniul emitentului. Coace pentru portabilitate, publică un link de verificare pentru încredere și așteaptă-te ca rețelele sociale să șteargă metadatele.

Ești gata să emiți primul tău credențial verificabil? Începe gratuit pe badges.ninja — designer vizual, pagină publică de verificare, certificat PDF, ieșire Open Badge v2.0. Fără card de credit.

Nacho Coll

Despre autor

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.

Înapoi la Blog

Articole similare