Open Badge „kepimas“: kaip JSON gyvena PNG viduje

„Iškeptas” Open Badge yra PNG failas, kurio paveikslėlio metaduomenyse įterptas patvirtinimo JSON. Ženklelio failas YRA kredencialas. Kaip veikia kepimas ir kaip patikrinti iškeptą ženklelį.

Nacho Coll Autorius Atnaujinta 9 min skaitymo
„Iškeptas” Open Badge yra PNG failas, kurio paveikslėlio metaduomenyse įterptas patvirtinimo JSON. Ženklelio failas YRA kredencialas. Kaip veikia kepimas ir kaip patikrinti iškeptą ženklelį.

Parsisiųskite Open Badge iš beveik bet kurio išdavėjo ir gausite įprastai atrodantį PNG. Įmeskite jį į pokalbį, pridėkite prie el. laiško, atsispausdinkite. Jis atrodo kaip bet kuris kitas paveikslėlis. Tačiau faile slypi antras, nematomas sluoksnis: pats kredencialas, įrašytas į paveikslėlį kaip metaduomenys. Tai Open Badges bendruomenė vadina iškeptu ženkleliu, ir būtent dėl to ženklelis gali keliauti vienu failu ir vis tiek įrodyti, kas jį išdavė, kam ir už ką.

Šiame vadove paaiškinama, kas yra kepimas, kur faile gyvena duomenys, kaip tikrintojas juos nuskaito ir ką turite nuspręsti jūs, kaip kredencialų išdavėjas. Norint naudoti iškeptus ženklelius, programuoti nereikia. Jei išduodate per https://badges.ninja, kepimas vyksta už jus. Tačiau suprasdami mechaniką lengviau atsakysite į klausimus, kuriuos gavėjai ir darbdaviai iš tikrųjų užduoda: „Ar šis paveikslėlis tikras?“ ir „Ar kas nors gali tiesiog jį nukopijuoti?“

Ką reiškia „kepimas“

Open Badge turi dvi dalis, kurias lengva supainioti:

  • Paveikslėlis. PNG arba SVG, kurį žmonės mato profilyje, skaidrėje ar pažymėjime.
  • Patvirtinimas (assertion). Nedidelis JSON dokumentas, nurodantis faktus: kas yra gavėjas (kaip užhashuotas identifikatorius), kokia ženklelio klasė įgyta, kas išdavė, kada ir kur galima patikrinti.

Kepimas yra patvirtinimo įrašymas į paveikslėlį taip, kad jų nebūtų galima atskirti. Rezultatas – vienas failas. Perdavę kam nors PNG, perduodate ir paveikslėlį, ir už jo stovintį teiginį.

Idėja kilusi iš Open Badges specifikacijos, kurią iš pradžių sukūrė Mozilla, o dabar prižiūri 1EdTech. Dizaino esmė – perkeliamumas. Anksčiau ženkleliai gyveno vienoje platformoje, o perkėlimas į kitą vietą reiškė pakartotinį įkėlimą ir viltį, kad metaduomenys išliks. Iškeptas failas savo metaduomenis nešasi su savimi, kad ir kur nukeliautų.

Kur JSON gyvena PNG viduje

PNG failą sudaro trumpa signatūra ir blokų (chunks) seka. Kiekvienas blokas turi ilgį, keturių raidžių tipą, duomenis ir kontrolinę sumą. Peržiūros programos piešia taškus iš IDAT blokų ir ignoruoja jų nesuprantamus bloko tipus. Būtent ši tolerancija ir leidžia kepti: galite pridėti bloką, pilną teksto, ir visos pasaulio paveikslėlių peržiūros programos vis tiek rodys paveikslėlį kaip įprasta.

Open Badges 2.0 atveju patvirtinimas patenka į teksto bloką su raktažodžiu openbadges. Teksto bloko tipai, kuriuose jis gali būti:

BlokasKodavimasPastabos
tEXtLatin-1Paprastas, bet apribotas Latin-1 simboliais.
iTXtUTF-8Pageidautinas, nes vardai ir aprašymai dažnai nėra ASCII.

Kad ir koks blokas naudojamas, struktūra ta pati: raktažodis openbadges, skirtukas, tada turinys. Turinys yra vienas iš dviejų dalykų, priklausomai nuo to, kaip išdavėjas pasirinko kepti:

  1. Pats patvirtinimo JSON. Failas aprašo save pats. Tikrintojas gali perskaityti teiginį be jokio tinklo kreipinio.
  2. URL, nurodantis į talpinamą patvirtinimą. Failas mažesnis, o išdavėjas gali palikti gyvą įrašą autoritetingu, pavyzdžiui, kad parodytų, jog ženklelis vėliau buvo atšauktas arba nustojo galioti.

Egzistuoja ir trečias variantas pasirašytiems ženklikliams, kai turinys yra ne paprastas JSON, o pasirašytas žetonas. Jei jūsų atvejui parašai svarbūs, skaitykite kaip patikrinti Open Badge parašą.

O kaip SVG?

SVG ženklelius taip pat galima kepti, nes SVG yra XML. Patvirtinimas įdedamas į failą openbadges XML vardų erdvės elemente, o atributas verify nurodo talpinamo patvirtinimo URL. Principas toks pat kaip su PNG: metaduomenys keliauja paveikslėlio faile. Praktiškai dauguma platformų kepa PNG, nes PNG priimamas beveik visur, kur žmonės nori įkelti ženklelį.

Kaip atrodo įterptas patvirtinimas

2.0 formatu talpinamas patvirtinimas yra JSON-LD, susiejantis gavėją, ženklelio klasę ir patikrinimo metodą. Sutrumpintas pavyzdys:

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

Atkreipkite dėmesį į gavėją. El. paštas nesaugomas atviru tekstu; tai sūdytas SHA-256 hash. Tai svarbu faile, skirtame keliauti iš rankų į rankas. Kiekvienas, turintis PNG, gali perskaityti patvirtinimą, todėl jis neturi atskleisti gavėjo adreso. Tikrintojas, jau žinantis el. paštą, gali jį užhashuoti su ta pačia druska ir patikrinti, ar sutampa. Norėdami peržvelgti šį dokumentą laukas po lauko, žr. Open Badge JSON-LD apžvalgą.

Kaip tikrintojas nuskaito iškeptą ženklelį

Iškepto ženklelio patikrinimas yra trumpas mechaninis procesas:

  1. Atidarykite PNG ir pereikite per jo blokus.
  2. Raskite teksto bloką su raktažodžiu openbadges.
  3. Perskaitykite turinį. Jei tai JSON, išanalizuokite jį. Jei tai URL, gaukite jį.
  4. Patikrinkite, ar patvirtinimas nurodo jūsų tikėtą ženklelio klasę ir išdavėją ir ar gavėjo tapatybė sutampa su ženklelį pateikiančiu asmeniu.
  5. Jei patikrinimo tipas yra hosted, įsitikinkite, kad talpinamas patvirtinimas vis dar egzistuoja savo id URL ir nėra atšauktas ar pasibaigęs.

5 žingsnį žmonės praleidžia, o būtent jis kredencialą daro patikimą. Įterpta kopija yra momentinė nuotrauka. Talpinamas įrašas yra tiesos šaltinis.

Perskaitykite patys su Node

Bet kurį PNG galite apžiūrėti trumpu skriptu. Šis pereina per blokus ir išspausdina openbadges turinį, palaikydamas ir tEXt, ir 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);

Paleiskite jį komanda node extract-badge.mjs my-badge.png. Jei failas iškeptas, pamatysite JSON arba URL. Jei ne, gausite paprastą pranešimą „not baked“. Tai mokymo įrankis, o ne pilnas validatorius: jis netikrina bloko kontrolinių sumų, neanalizuoja pasirašytų turinių ir negauna talpinamo įrašo.

Jei nenorite rašyti kodo, internetinis ženklelių validatorius ar PNG metaduomenų žiūryklė parodys tą patį bloką. Formatas yra standartas, todėl bet kuris atitinkantis įrankis perskaito bet kurį atitinkantį ženklelį.

Kodėl kepimas svarbus

Perkeliamumas. Kredencialą, kuris yra tiesiog PNG, galima nusiųsti el. paštu, įkelti į mokymosi platformą ar laikyti asmeniniame archyve. Jam nešti paskyros nereikia.

Patikrinimo kelias, išgyvenantis išdavėjo rinkodaros svetainę. Įterptas patvirtinimas nurodo išdavėją ir veda į talpinamą įrašą, todėl tikrintojas gali pradėti vien nuo failo.

Neprisijungus ir paprastos technikos darbo eigos. Kai turinys yra visas JSON, skaitytojas gali patikrinti teiginį kompiuteryje be tinklo, o talpinamą įrašą patikrinti vėliau.

Įrodymas, kurį sunku atsitiktinai suklastoti. Bet kas gali padaryti ženklelio ekrano nuotrauką. Ekrano nuotrauka neturi metaduomenų, todėl jos negalima patikrinti kaip ženklelio failo. Vien tai skiria tikrą kredencialą nuo nukopijuoto paveikslėlio. Tai nesustabdo žmogaus, kuris įkepa suklastotą patvirtinimą į pavogtą paveikslėlį, todėl ir egzistuoja talpinamo įrašo patikrinimo žingsnis.

Kepimo ribos

Būkite sąžiningi su gavėjais dėl šių dalykų, nes jie veikia tai, kaip aprašote savo kredencialus.

  • Metaduomenys pašalinami. Daug socialinių tinklų, paveikslėlių optimizatorių ir žinučių programėlių perkoduoja įkeltus failus ir išmeta ne taškų blokus. Iškeptas ženklelis, paskelbtas socialiniame sraute, paprastai nebėra iškeptas. Tai tikėtina, todėl šalia failo svarbi vieša patikrinimo nuoroda.
  • Kepimas pats savaime nėra įrodymas. Įterptą JSON gali parašyti bet kas. Pasitikėjimas kyla iš talpinamo patvirtinimo išdavėjo domene arba iš galiojančio parašo.
  • Paveikslėlio redagavimas nutraukia ryšį. Dydžio keitimas ar išsaugojimas redaktoriuje gali prarasti bloką.
  • Tik PNG ir SVG. JPEG specifikacijoje neturi atitinkamos bloko konvencijos, todėl nuotraukos stiliaus ženklelio, eksportuoto kaip JPEG, standartiniu būdu iškepti negalima.

Praktinė išvada: laikykite iškeptą failą patogiu nešikliu, o patikrinimo puslapį – autoritetu. Jei svarstote formatus savo programai, Open Badges ir PDF pažymėjimai paaiškina, kodėl mašininiu būdu skaitomas kredencialas pranašesnis už statinį dokumentą.

Kaip kepimas veikia https://badges.ninja

Kai skiriate ženklelį per https://badges.ninja, platforma sukuria to gavėjo Open Badge patvirtinimą ir išdavimo metu įkepa jį į ženklelio paveikslėlį. Nereikia konfigūruoti įrankio ar vykdyti komandos. Eiga:

  1. Suprojektuojate ženklelį vizualiame dizaineryje arba įkeliate savo paveikslėlį.
  2. Išduodate apdovanojimą iš skydelio, iš CSV įkėlimo masiniams apdovanojimams arba per API.
  3. Platforma sukuria patvirtinimą, įkepa jį į PNG ir išsaugo rezultatą kartu su apdovanojimu.
  4. Gavėjas gauna viešą patikrinimo puslapį adresu https://badges.ninja/awards/<awardId>, PDF pažymėjimą, QR kodą ir parinktį „Add to LinkedIn“.

Jei ženklelio dizainas naudoja sujungimo laukus, pavyzdžiui, gavėjo vardą, kiekvienas apdovanojimas gauna personalizuotą paveikslėlį, ir būtent personalizuotas paveikslėlis yra iškepamas.

Kepimas laikomas išdavimo patobulinimu, o ne vartais: jei konkretaus paveikslėlio iškepti nepavyksta (pavyzdžiui, išsigimusio vietos žymeklio paveikslėlio), apdovanojimas vis tiek išduodamas naudojant originalų paveikslėlį, o viešas patikrinimo puslapis ir Open Badge JSON-LD lieka nepaveikti. Įkeliamas paveikslėlis taip pat turi atitikti minimalų dydį, todėl mažytis tuščias drobės gabalas atmetamas dar prieš pasiekdamas kepyklą.

Kadangi viešas puslapis yra autoritetas, bet kas gali patikrinti apdovanojimą be registracijos. Mašininiu būdu skaitomas Open Badge v2.0 JSON-LD apdovanojimui pasiekiamas adresu https://api.badges.ninja/certify-badge/award/<awardId>.

Vieno apdovanojimo išdavimas per API

Dauguma skaitytojų naudos skydelį, bet jei automatizuojate išdavimą, vienas užklausimas sukuria apdovanojimą (kartu gaunamas ir iškeptas paveikslėlis). Pakeiskite raktą ir ženklelio id savo:

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

Iškvietimas grąžina HTTP 200 su { "awardId": "<guid>" }. Iš to id sudarykite patikrinimo URL. Dėl raktų nustatymo ir pilnos užklausų nuorodos žr. Awards API dokumentaciją ir autentifikavimo vadovą.

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

Praktiniai patarimai išdavėjams

Šalia failo visada paskelbkite patikrinimo nuorodą. Įdėkite nuorodą į apdovanojimo el. laišką, pažymėjimą ir bet kurį puslapį, kuriame rodomas ženklelis. Kadangi socialinės platformos pašalina metaduomenis, būtent nuoroda išlaiko kredencialo patikrinamumą po pasidalijimo.

Naudokite švarų, pakankamo dydžio šaltinio paveikslėlį. Pradėkite nuo PNG su realiais matmenimis. Dizainerio sukurtas ženklelis įprasta raiška iškepamas patikimai; 1 pikselio vietos žymeklis – ne.

Nekeiskite pateikto failo. Pasakykite gavėjams dalytis originaliu atsisiuntimu arba patikrinimo nuoroda, o ne apkarpyta ekrano nuotrauka.

Nuspręskite, ką sakysite apie atšaukimą ir galiojimo pabaigą. Kadangi talpinamas įrašas yra autoritetingas, iškeptas failas gali išgyventi kredencialo statusą. Aiškiai tai nurodykite savo programos dokumentacijoje, kad darbdaviai žinotų tikrinti patikrinimo puslapį, o ne pasitikėti vien failu.

Išbandykite vieną ženklelį nuo pradžios iki galo. Išduokite apdovanojimą sau, atsisiųskite PNG, paleiskite jį per aukščiau pateiktą skriptą ar viešą validatorių ir atidarykite patikrinimo nuorodą. Penkios minutės testavimo parodo, ką patirs jūsų gavėjai.

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

Dažniausiai užduodami klausimai

Ar iškeptas ženklelis yra tas pats, kas skaitmeninis pažymėjimas? Ne. Pažymėjimas paprastai yra PDF skaitymui ir spausdinimui. Iškeptas ženklelis yra paveikslėlis, kuris taip pat neša mašininiu būdu skaitomus kredencialo duomenis. https://badges.ninja sukuria abu iš to paties apdovanojimo.

Ar galiu iškepti ženklelį be platformos? Taip. Specifikacija atvira, ir yra bibliotekų keliomis kalbomis. Sunkesnė dalis – patvirtinimo talpinimas stabiliu URL, nes būtent tai suteikia patikrinimui prasmę. Tą dalį už jus atlieka platforma.

Ar kepimas atskleidžia gavėjo el. paštą? Ne, kai tapatybė užhashuota. Patvirtinime saugomas sūdytas hash, todėl failas adreso neatskleidžia.

Ar LinkedIn perskaitys iškeptus duomenis? LinkedIn „Add to Profile“ eiga veikia pagal kredencialo pavadinimą, išdavėją, datą ir URL, o ne pagal failo metaduomenis. Žr. mygtuko „Add to LinkedIn“ pridėjimas.

Santrauka

Iškeptas Open Badge yra PNG (arba SVG), kurio kredencialas įrašytas į teksto bloką, pavadintą openbadges. Tai daro ženklelį perkeliamą ir save aprašantį, tačiau tikrasis pasitikėjimas kyla iš talpinamo patvirtinimo išdavėjo domene. Kepkite dėl perkeliamumo, skelbkite patikrinimo nuorodą dėl pasitikėjimo ir tikėkitės, kad socialiniai tinklai pašalins metaduomenis.

Pasiruošę išduoti pirmąjį patikrinamą kredencialą? Pradėkite nemokamai badges.ninja — vizualus dizaineris, viešas patikrinimo puslapis, PDF pažymėjimas, Open Badge v2.0 išvestis. Kredito kortelės nereikia.

Nacho Coll

Apie autorių

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.

Grįžti į Tinklaraštį

Susiję straipsniai