Open Badge cepšana: kā JSON dzīvo PNG iekšienē

„Izcepta“ Open Badge ir PNG ar iegultu apliecinājuma JSON kā attēla metadatiem. Nozīmes fails IR akreditācijas dati. Kā cepšana darbojas un kā pārbaudīt izceptu nozīmi.

Nacho Coll Autors Atjaunināts 9 min lasīšanai
„Izcepta“ Open Badge ir PNG ar iegultu apliecinājuma JSON kā attēla metadatiem. Nozīmes fails IR akreditācijas dati. Kā cepšana darbojas un kā pārbaudīt izceptu nozīmi.

Lejupielādējiet Open Badge no gandrīz jebkura izdevēja, un jūs saņemsiet parasta izskata PNG. Ievietojiet to tērzēšanā, pievienojiet e-pastam, izdrukājiet. Tas izskatās kā jebkurš cits attēls. Taču failam ir otrs, neredzams slānis: pati akreditācija, ierakstīta attēlā kā metadati. Open Badges kopiena to sauc par izceptu nozīmi (baked badge), un tieši tāpēc nozīme var ceļot kā viens fails un tomēr pierādīt, kas to izdevis, kam un par ko.

Šajā ceļvedī paskaidrots, kas ir cepšana, kur failā atrodas dati, kā verificētājs tos nolasa atpakaļ un par ko jums jālemj kā akreditāciju izdevējam. Lai izmantotu izceptas nozīmes, nav jāraksta kods. Ja izdodat, izmantojot https://badges.ninja, cepšana notiek jūsu vietā. Taču mehānikas izpratne palīdz atbildēt uz jautājumiem, ko saņēmēji un darba devēji patiešām uzdod: „Vai šis attēls ir īsts?“ un „Vai kāds var to vienkārši nokopēt?“

Ko nozīmē „cepšana“

Open Badge sastāv no divām daļām, kuras viegli sajaukt:

  • Attēls. PNG vai SVG, ko cilvēki redz profilā, slaidā vai sertifikātā.
  • Apliecinājums (assertion). Neliels JSON dokuments, kas norāda faktus: kas ir saņēmējs (kā jaukts identifikators), kāda nozīmes klase iegūta, kas to izdevis, kad un kur to var pārbaudīt.

Cepšana ir apliecinājuma ierakstīšana attēlā, lai abus nevarētu atdalīt. Rezultāts ir viens fails. Ja kādam nododat PNG, esat nodevis gan attēlu, gan tam pamatā esošo apgalvojumu.

Ideja nāk no Open Badges specifikācijas, ko sākotnēji izstrādāja Mozilla un tagad uztur 1EdTech. Dizaina jēga ir pārnesamība. Sākumā nozīmes dzīvoja vienas platformas iekšienē, un pārcelšana uz jaunu vietu nozīmēja atkārtotu augšupielādi un cerību, ka metadati saglabāsies. Izcepts fails metadatus nes līdzi, kur vien tas nonāk.

Kur PNG iekšienē dzīvo JSON

PNG fails ir īss paraksts, kam seko bloku (chunks) secība. Katram blokam ir garums, četru burtu tips, daži dati un kontrolsumma. Skatītāji zīmē pikseļus no IDAT blokiem un ignorē bloku tipus, kurus nesaprot. Tieši šī iecietība padara cepšanu iespējamu: varat pievienot teksta pilnu bloku, un katrs attēlu skatītājs pasaulē tāpat attēlu parādīs normāli.

Open Badges 2.0 gadījumā apliecinājums tiek ievietots teksta blokā ar atslēgvārdu openbadges. Teksta bloku tipi, kas to var glabāt:

BloksKodējumsPiezīmes
tEXtLatin-1Vienkāršs, bet ierobežots ar Latin-1 rakstzīmēm.
iTXtUTF-8Vēlams, jo vārdi un apraksti bieži nav ASCII.

Neatkarīgi no izmantotā bloka struktūra ir tāda pati: atslēgvārds openbadges, atdalītājs, tad lietderīgā slodze. Slodze ir viena no divām lietām atkarībā no tā, kā izdevējs izvēlējies cept:

  1. Pats apliecinājuma JSON. Fails ir pašaprakstošs. Verificētājs var nolasīt apgalvojumu bez jebkāda tīkla izsaukuma.
  2. URL, kas norāda uz mitināto apliecinājumu. Fails ir mazāks, un izdevējs var saglabāt dzīvo ierakstu kā autoritatīvu, piemēram, lai parādītu, ka nozīme vēlāk atsaukta vai tai beidzies derīgums.

Parakstītām nozīmēm pastāv trešais variants, kur slodze ir parakstīts žetons parastā JSON vietā. Ja paraksti ir svarīgi jūsu lietošanas gadījumam, izlasiet kā pārbaudīt Open Badge parakstu.

Kā ar SVG?

SVG nozīmes var arī cept, jo SVG ir XML. Apliecinājums tiek ievietots failā openbadges XML nosaukumvietas elementā, un atribūts verify satur mitinātā apliecinājuma URL. Princips ir tāds pats kā ar PNG: metadati ceļo attēla faila iekšpusē. Praksē lielākā daļa platformu cep PNG, jo PNG tiek pieņemts gandrīz visur, kur cilvēki vēlas augšupielādēt nozīmi.

Kā izskatās iegultais apliecinājums

2.0 formātā mitinātais apliecinājums ir JSON-LD, kas saista saņēmēju, nozīmes klasi un verifikācijas metodi. Saīsināts piemērs:

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

Pievērsiet uzmanību saņēmējam. E-pasts nav glabāts atklātā tekstā; tas ir sālīts SHA-256 jaucējkods. Tas ir svarīgi failam, kas paredzēts apritei. Ikviens, kam ir PNG, var nolasīt apliecinājumu, tāpēc tas nedrīkst noplūdināt saņēmēja adresi. Verificētājs, kurš e-pastu jau zina, var to jaukt ar to pašu sāli un pārbaudīt sakritību. Šī dokumenta apskatam lauks pa laukam skatiet Open Badge JSON-LD pārskatu.

Kā verificētājs nolasa izceptu nozīmi

Izceptas nozīmes verifikācija ir īss, mehānisks process:

  1. Atveriet PNG un izejiet cauri tā blokiem.

  2. Atrodiet teksta bloku ar atslēgvārdu openbadges.

  3. Nolasiet slodzi. Ja tas ir JSON, parsējiet to. Ja tas ir URL, ielādējiet to.

  4. Pārbaudiet, vai apliecinājums attiecas uz jūsu gaidīto nozīmes klasi un izdevēju un vai saņēmēja identitāte atbilst personai, kas to uzrāda.

  5. Ja verifikācijas tips ir hosted, pārliecinieties, ka mitinātais apliecinājums joprojām pastāv savā id URL un nav atsaukts vai beidzies.

  6. soli cilvēki izlaiž, bet tieši tas padara akreditāciju uzticamu. Iegultā kopija ir momentuzņēmums. Mitinātais ieraksts ir patiesības avots.

Nolasīšana pašiem Node vidē

Jebkuru PNG var pārbaudīt ar īsu skriptu. Šis iet cauri blokiem un izdrukā openbadges slodzi, apstrādājot gan tEXt, gan 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);

Palaidiet to ar node extract-badge.mjs my-badge.png. Ja fails ir izcepts, redzēsiet JSON vai URL. Ja nē, saņemsiet vienkāršu ziņojumu „not baked“. Tas ir mācību rīks, nevis pilnvērtīgs validators: tas nepārbauda bloku kontrolsummas, neparsē parakstītas slodzes un neielādē mitināto ierakstu.

Ja nevēlaties rakstīt kodu, tiešsaistes nozīmju validators vai PNG metadatu skatītājs parādīs to pašu bloku. Formāts ir standarts, tāpēc jebkurš atbilstošs rīks nolasa jebkuru atbilstošu nozīmi.

Kāpēc cepšana ir svarīga

Pārnesamība. Akreditāciju, kas ir tikai PNG, var nosūtīt e-pastā, augšupielādēt mācību platformā vai glabāt personīgajā arhīvā. Tās nēsāšanai nav vajadzīgs konts.

Verifikācijas ceļš, kas pārdzīvo izdevēja mārketinga vietni. Iegultais apliecinājums nosauc izdevēju un norāda uz mitināto ierakstu, tāpēc verificētājs var sākt tikai ar failu.

Bezsaistes un vienkāršas tehnoloģijas darbplūsmas. Kad slodze ir pilns JSON, lasītājs var pārbaudīt apgalvojumu ierīcē bez tīkla un mitināto ierakstu pārbaudīt vēlāk.

Pierādījums, ko ir grūti nejauši viltot. Ekrānuzņēmumu nozīmei var uztaisīt ikviens. Ekrānuzņēmumam nav metadatu, tāpēc to nevar pārbaudīt kā nozīmes failu. Jau tas atšķir īstu akreditāciju no nokopēta attēla. Tas neliedz kādam nozagtā attēlā izcept viltotu apliecinājumu, tāpēc eksistē mitinātās verifikācijas solis.

Cepšanas ierobežojumi

Esiet godīgi pret saņēmējiem par tiem, jo tie ietekmē to, kā aprakstāt savas akreditācijas.

  • Metadati tiek noņemti. Daudzi sociālie tīkli, attēlu optimizētāji un ziņojumapmaiņas lietotnes pārkodē augšupielādes un izmet blokus, kas nav pikseļi. Sociālajā plūsmā ievietota izcepta nozīme parasti vairs nav izcepta. Tas ir sagaidāms, un tieši tāpēc blakus failam ir svarīga publiska verifikācijas saite.
  • Cepšana pati par sevi nav pierādījums. Iegulto JSON var uzrakstīt ikviens. Uzticība nāk no mitinātā apliecinājuma izdevēja domēnā vai derīga paraksta.
  • Attēla rediģēšana pārtrauc saikni. Izmēra maiņa vai atkārtota saglabāšana redaktorā var zaudēt bloku.
  • Tikai PNG un SVG. JPEG specifikācijā nav līdzvērtīgas bloku konvencijas, tāpēc fotogrāfijas stila nozīmi, kas eksportēta kā JPEG, nevar cept standarta veidā.

Praktisks secinājums: uzskatiet izcepto failu par ērtu nesēju, bet verifikācijas lapu par autoritāti. Ja izvērtējat formātus savai programmai, Open Badges pret PDF sertifikātiem izskaidro, kāpēc mašīnlasāma akreditācija pārspēj statisku dokumentu.

Kā cepšana darbojas platformā https://badges.ninja

Kad piešķirat nozīmi platformā https://badges.ninja, platforma izveido Open Badge apliecinājumu šim saņēmējam un izdošanas laikā iecep to nozīmes attēlā. Jums nav jākonfigurē rīki un jāpalaiž komandas. Plūsma:

  1. Jūs veidojat nozīmi vizuālajā dizainerī vai augšupielādējat savu attēlu.
  2. Jūs izdodat apbalvojumu: no informācijas paneļa, no CSV augšupielādes masveida apbalvojumiem vai ar API.
  3. Platforma izveido apliecinājumu, iecep to PNG un saglabā rezultātu kopā ar apbalvojumu.
  4. Saņēmējs saņem publisku verifikācijas lapu adresē https://badges.ninja/awards/<awardId>, PDF sertifikātu, QR kodu un opciju Add to LinkedIn.

Ja nozīmes dizains izmanto sapludināšanas laukus, piemēram, saņēmēja vārdu, katrs apbalvojums saņem personalizētu attēlu, un tieši šis personalizētais attēls tiek izcepts.

Cepšana tiek uzskatīta par izdošanas uzlabojumu, nevis vārtiem: ja konkrētu attēlu nevar izcept (piemēram, deģenerētu vietturi), apbalvojums tomēr tiek izdots ar oriģinālo attēlu, un publiskā verifikācijas lapa un Open Badge JSON-LD paliek neskarti. Augšupielādētajam attēlam arī jāsasniedz minimālais izmērs, tāpēc sīks tukšs audekls tiek noraidīts, pirms tas nonāk ceptuvē.

Tā kā publiskā lapa ir autoritāte, ikviens var pārbaudīt apbalvojumu bez reģistrēšanās. Apbalvojuma mašīnlasāmais Open Badge v2.0 JSON-LD ir pieejams adresē https://api.badges.ninja/certify-badge/award/<awardId>.

Viena apbalvojuma izdošana ar API

Lielākā daļa lasītāju izmantos informācijas paneli, taču, ja automatizējat izdošanu, viens pieprasījums izveido apbalvojumu (un izceptais attēls nāk komplektā). Aizstājiet atslēgu un nozīmes id ar savējiem:

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

Izsaukums atgriež HTTP 200 ar { "awardId": "<guid>" }. Izveidojiet verifikācijas URL no šī id. Atslēgas iestatīšanai un pilnai pieprasījumu atsaucei skatiet Awards API dokumentāciju un autentifikācijas ceļvedi.

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

Praktiski padomi izdevējiem

Blakus failam vienmēr publicējiet verifikācijas saiti. Ievietojiet saiti apbalvojuma e-pastā, sertifikātā un jebkurā lapā, kur nozīme tiek rādīta. Tā kā sociālās platformas noņem metadatus, tieši saite uztur akreditāciju verificējamu pēc kopīgošanas.

Izmantojiet tīru, pietiekami lielu avota attēlu. Sāciet ar PNG ar reāliem izmēriem. Dizainera veidota nozīme parastā izšķirtspējā tiek cepta uzticami; 1 pikseļa vietturis nē.

Nerediģējiet piegādāto failu. Sakiet saņēmējiem, lai kopīgo oriģinālo lejupielādi vai verifikācijas saiti, nevis apgrieztu ekrānuzņēmumu.

Izlemiet, ko vēlaties teikt par atsaukšanu un derīguma termiņu. Tā kā mitinātais ieraksts ir autoritatīvs, izcepts fails var pārdzīvot akreditācijas statusu. Skaidri to norādiet savas programmas dokumentācijā, lai darba devēji zinātu, ka jāpārbauda verifikācijas lapa, nevis jāuzticas tikai failam.

Pārbaudiet vienu nozīmi no sākuma līdz beigām. Izdodiet apbalvojumu sev, lejupielādējiet PNG, palaidiet to caur iepriekšējo skriptu vai publisku validatoru un atveriet verifikācijas saiti. Piecas minūtes testēšanas parāda, ko piedzīvos jūsu saņēmēji.

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

Biežāk uzdotie jautājumi

Vai izcepta nozīme ir tas pats, kas digitālais sertifikāts? Nē. Sertifikāts parasti ir PDF lasīšanai un drukāšanai. Izcepta nozīme ir attēls, kas nes arī mašīnlasāmus akreditācijas datus. https://badges.ninja izveido abus no viena apbalvojuma.

Vai varu izcept nozīmi bez platformas? Jā. Specifikācija ir atvērta, un bibliotēkas pastāv vairākām valodām. Grūtākā daļa ir apliecinājuma mitināšana stabilā URL, kas verifikācijai piešķir jēgu. Šo daļu platforma paveic jūsu vietā.

Vai cepšana atklāj saņēmēja e-pastu? Nē, ja identitāte ir jaukta. Apliecinājums glabā sālītu jaucējkodu, tāpēc fails adresi neatklāj.

Vai LinkedIn nolasīs izceptos datus? LinkedIn Add to Profile plūsma darbojas pēc akreditācijas nosaukuma, izdevēja, datuma un URL, nevis pēc faila metadatiem. Skatiet Add to LinkedIn pogas pievienošanu.

Kopsavilkums

Izcepta Open Badge ir PNG (vai SVG) ar akreditāciju, ierakstītu teksta blokā ar nosaukumu openbadges. Tā nozīmi padara pārnesamu un pašaprakstošu, taču īstā uzticība nāk no mitinātā apliecinājuma izdevēja domēnā. Cepiet pārnesamības dēļ, publicējiet verifikācijas saiti uzticības dēļ un sagaidiet, ka sociālie tīkli metadatus noņems.

Gatavi izdot savu pirmo verificējamo akreditāciju? Sāciet bez maksas platformā badges.ninja — vizuālais dizainers, publiska verifikācijas lapa, PDF sertifikāts, Open Badge v2.0 izvade. Kredītkarte nav vajadzīga.

Nacho Coll

Par autoru

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.

Atpakaļ uz Blogu

Saistītie raksti