Open Badge baking forklart: Slik bor JSON inne i PNG-filen

Et «baked» Open Badge er en PNG med assertion-JSON innebygd som bildemetadata. Badge-filen ER legitimasjonen. Slik fungerer baking, og slik verifiserer du et baked badge.

Nacho Coll Av Oppdatert 11 min lesing
Et «baked» Open Badge er en PNG med assertion-JSON innebygd som bildemetadata. Badge-filen ER legitimasjonen. Slik fungerer baking, og slik verifiserer du et baked badge.

Last ned et Open Badge fra nesten hvilken som helst utsteder, og du får en helt vanlig PNG. Slipp den i en chat, legg den ved en e-post, skriv den ut. Den ser ut som alle andre bilder. Men filen har et ekstra, usynlig lag: selve legitimasjonen, skrevet inn i bildet som metadata. Det er dette Open Badges-miljøet kaller et baked badge, og det er grunnen til at et badge kan reise som én enkelt fil og likevel bevise hvem som utstedte det, til hvem og for hva.

Denne guiden forklarer hva baking er, hvor dataene ligger inne i filen, hvordan en verifiserer leser dem tilbake, og hva du må ta stilling til som utsteder av legitimasjoner. Du trenger ikke skrive kode for å bruke baked badges. Hvis du utsteder via https://badges.ninja, skjer baking automatisk. Men det hjelper å forstå mekanikken når du skal svare på spørsmålene mottakere og arbeidsgivere faktisk stiller: “Er dette bildet ekte?” og “Kan hvem som helst bare kopiere det?”

Hva “baking” betyr

Et Open Badge har to deler som er lette å forveksle:

  • Bildet. PNG- eller SVG-filen folk ser på en profil, et lysbilde eller et sertifikat.
  • Assertion. Et lite JSON-dokument som fastslår fakta: hvem mottakeren er (som en hashet identifikator), hvilken badge-klasse som er oppnådd, hvem som har utstedt den, når, og hvor den kan verifiseres.

Baking er det å skrive assertion inn i bildet slik at de to ikke kan skilles. Resultatet er én fil. Gir du noen PNG-filen, har du gitt dem både bildet og påstanden bak det.

Ideen kommer fra Open Badges-spesifikasjonen, som opprinnelig ble utviklet av Mozilla og nå vedlikeholdes av 1EdTech. Poenget med designet er portabilitet. I begynnelsen levde badges inne i én enkelt plattform, og å flytte et badge betydde å laste det opp på nytt og håpe at metadataene overlevde. En baked fil har sine egne metadata med seg uansett hvor den havner.

Hvor JSON-en ligger inne i en PNG

En PNG-fil består av en kort signatur etterfulgt av en rekke chunks. Hver chunk har en lengde, en type på fire bokstaver, noen data og en kontrollsum. Visere tegner pikslene fra IDAT-chunks og ignorerer chunk-typer de ikke forstår. Den toleransen er det som gjør baking mulig: du kan legge til en chunk full av tekst, og alle bildevisere i verden vil fortsatt vise bildet helt normalt.

For Open Badges 2.0 legges assertion i en tekstchunk med nøkkelordet openbadges. Tekstchunk-typene som kan romme den, er:

ChunkKodingMerknader
tEXtLatin-1Enkel, men begrenset til Latin-1-tegn.
iTXtUTF-8Foretrukket, fordi navn og beskrivelser ofte ikke er ASCII.

Uansett hvilken chunk som brukes, er oppbyggingen den samme: nøkkelordet openbadges, et skilletegn og så nyttelasten. Nyttelasten er en av to ting, avhengig av hvordan utstederen valgte å bake:

  1. Selve assertion-JSON-en. Filen er selvbeskrivende. En verifiserer kan lese påstanden uten noe nettverkskall.
  2. En URL som peker til den hostede assertion. Filen er mindre, og utstederen kan beholde den levende posten som autoritativ, for eksempel for å vise at et badge senere er trukket tilbake eller har utløpt.

Det finnes en tredje variant for signerte badges, der nyttelasten er et signert token i stedet for vanlig JSON. Hvis signaturer er viktige for deg, kan du lese slik verifiserer du en Open Badge-signatur.

Hva med SVG?

SVG-badges kan også bakes, siden SVG er XML. Assertion legges inne i filen i et element i navneområdet openbadges, og verify-attributtet inneholder URL-en til den hostede assertion. Prinsippet er det samme som med PNG: metadataene følger med inne i bildefilen. I praksis bruker de fleste plattformer PNG, fordi PNG godtas nesten overalt der folk vil laste opp et badge.

Slik ser den innebygde assertion ut

I 2.0-formatet er en hostet assertion JSON-LD som knytter sammen mottakeren, badge-klassen og verifiseringsmetoden. Et forkortet eksempel:

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

Legg merke til mottakeren. E-posten er ikke lagret i klartekst; den er en saltet SHA-256-hash. Det er viktig for en fil som er laget for å deles videre. Alle som har PNG-filen kan lese assertion, så assertion må ikke lekke mottakerens adresse. En verifiserer som allerede kjenner e-posten, kan hashe den med samme salt og sjekke at den stemmer. For en gjennomgang av dokumentet felt for felt, se gjennomgangen av Open Badge JSON-LD.

Slik leser en verifiserer et baked badge

Verifisering av et baked badge er en kort, mekanisk prosess:

  1. Åpne PNG-filen og gå gjennom chunkene.
  2. Finn tekstchunken med nøkkelordet openbadges.
  3. Les nyttelasten. Er det JSON, parser du den. Er det en URL, henter du den.
  4. Sjekk at assertion viser til badge-klassen og utstederen du forventer, og at mottakerens identitet stemmer med personen som fremviser det.
  5. Hvis verifiseringstypen er hosted, bekreft at den hostede assertion fortsatt finnes på sin id-URL og ikke er trukket tilbake eller utløpt.

Trinn 5 er det folk hopper over, og det er det som gjør en legitimasjon troverdig. En innebygd kopi er et øyeblikksbilde. Den hostede posten er sannhetskilden.

Les den selv i Node

Du kan inspisere en hvilken som helst PNG med et kort skript. Dette går gjennom chunkene og skriver ut openbadges-nyttelasten, og håndterer både tEXt og 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);

Kjør det med node extract-badge.mjs my-badge.png. Hvis filen er baked, ser du JSON eller en URL. Hvis ikke, får du en enkel melding om at den ikke er baked. Dette er et læreverktøy, ikke en full validator: det sjekker ikke chunk-kontrollsummer, parser ikke signerte nyttelaster og henter ikke den hostede posten.

Hvis du heller vil slippe å skrive kode, viser en nettbasert badge-validator eller en PNG-metadataviser den samme chunken. Formatet er standarden, så ethvert kompatibelt verktøy leser ethvert kompatibelt badge.

Hvorfor baking er viktig

Portabilitet. En legitimasjon som bare er en PNG, kan sendes på e-post, lastes opp til en læringsplattform eller lagres i et personlig arkiv. Du trenger ingen konto for å bære den med deg.

En verifiseringsvei som overlever utstederens markedsføringsside. Den innebygde assertion navngir utstederen og peker til den hostede posten, så en verifiserer kan starte fra filen alene.

Offline og lavteknologiske arbeidsflyter. Når nyttelasten er hele JSON-en, kan en leser sjekke påstanden på en maskin uten nettverk og verifisere den hostede posten senere.

Dokumentasjon som er vanskelig å forfalske i det små. Alle kan ta et skjermbilde av et badge. Et skjermbilde har ingen metadata, så det kan ikke verifiseres som en badge-fil. Bare det skiller en ekte legitimasjon fra et kopiert bilde. Det hindrer ikke noen i å bake en forfalsket assertion inn i et stjålet bilde, og derfor finnes verifiseringstrinnet mot den hostede posten.

Bakingens begrensninger

Vær ærlig overfor mottakerne dine om disse, for de påvirker hvordan du beskriver legitimasjonene dine.

  • Metadata blir fjernet. Mange sosiale nettverk, bildeoptimerere og meldingsapper koder om opplastinger og dropper chunks som ikke er pikseldata. Et baked badge som postes i en sosial feed, er som regel ikke lenger baked. Det er forventet, og det er derfor en offentlig verifiseringslenke er viktig ved siden av filen.
  • Baking er ikke bevis i seg selv. Innebygd JSON kan skrives av hvem som helst. Tilliten kommer fra den hostede assertion på utstederens domene, eller fra en gyldig signatur.
  • Bilderedigering bryter koblingen. Å endre størrelse eller lagre på nytt i et redigeringsprogram kan miste chunken.
  • Bare PNG og SVG. JPEG har ingen tilsvarende chunk-konvensjon i spesifikasjonen, så et badge i fotostil eksportert som JPEG kan ikke bakes på standardmåten.

Den praktiske konklusjonen: behandle den bakede filen som en praktisk bærer, og behandle verifiseringssiden som autoriteten. Hvis du vurderer formater for programmet ditt, forklarer Open Badges vs. PDF-sertifikater hvorfor en maskinlesbar legitimasjon slår et statisk dokument.

Slik fungerer baking på https://badges.ninja

Når du tildeler et badge på https://badges.ninja, bygger plattformen Open Badge-assertion for den mottakeren og baker den inn i badge-bildet som en del av utstedelsen. Du konfigurerer ikke noe verktøy og kjører ingen kommando. Forløpet:

  1. Du designer badget i den visuelle designeren, eller laster opp ditt eget bilde.
  2. Du utsteder en tildeling fra dashbordet, fra en CSV-opplasting for masseutstedelse, eller via API-et.
  3. Plattformen oppretter assertion, baker den inn i PNG-filen og lagrer resultatet sammen med tildelingen.
  4. Mottakeren får en offentlig verifiseringsside på https://badges.ninja/awards/<awardId>, et PDF-sertifikat, en QR-kode og et Add to LinkedIn-alternativ.

Hvis badge-designet bruker flettefelt som mottakerens navn, får hver tildeling et personlig bilde, og det personlige bildet er det som blir bakt.

Baking er en forbedring av utstedelsen, ikke en forutsetning: hvis et bestemt bilde ikke kan bakes (for eksempel et degenerert plassholderbilde), utstedes tildelingen likevel med det opprinnelige bildet, og den offentlige verifiseringssiden og Open Badge JSON-LD påvirkes ikke. Bildet du laster opp, må også oppfylle en minimumsstørrelse, så et lite tomt lerret avvises før det når bakeriet.

Fordi den offentlige siden er autoriteten, kan hvem som helst sjekke en tildeling uten å registrere seg. Den maskinlesbare Open Badge v2.0 JSON-LD for en tildeling finnes på https://api.badges.ninja/certify-badge/award/<awardId>.

Utsted én tildeling via API

De fleste bruker dashbordet, men hvis du automatiserer utstedelsen, oppretter ett kall tildelingen (og det bakede bildet følger med). Bytt ut nøkkel og badge-id med dine egne:

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

Kallet returnerer HTTP 200 med { "awardId": "<guid>" }. Bygg verifiserings-URL-en fra den id-en. For oppsett av nøkler og full forespørselsreferanse, se Awards API-dokumentasjonen og autentiseringsguiden.

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

Praktiske råd for utstedere

Publiser alltid en verifiseringslenke ved siden av filen. Legg lenken i tildelings-e-posten, på sertifikatet og på alle sider der badget vises. Siden sosiale plattformer fjerner metadata, er det lenken som holder legitimasjonen verifiserbar etter deling.

Bruk et rent kildebilde i fornuftig størrelse. Start med en PNG med reelle dimensjoner. Et designerlaget badge i vanlig oppløsning bakes pålitelig; en plassholder på 1 piksel gjør ikke det.

Ikke rediger den leverte filen. Be mottakerne dele den opprinnelige nedlastingen eller verifiseringslenken, ikke et beskåret skjermbilde.

Bestem hva du vil si om tilbakekalling og utløp. Fordi den hostede posten er autoritativ, kan en baked fil overleve legitimasjonens status. Skriv det tydelig i programdokumentasjonen, slik at arbeidsgivere vet at de skal sjekke verifiseringssiden i stedet for å stole på filen alene.

Test ett badge fra ende til ende. Utsted en tildeling til deg selv, last ned PNG-filen, kjør den gjennom skriptet ovenfor eller en offentlig validator, og åpne verifiseringslenken. Fem minutters testing viser deg hva mottakerne dine kommer til å oppleve.

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

Ofte stilte spørsmål

Er et baked badge det samme som et digitalt sertifikat? Nei. Et sertifikat er som regel en PDF for lesing og utskrift. Et baked badge er et bilde som også bærer maskinlesbare legitimasjonsdata. https://badges.ninja lager begge deler fra den samme tildelingen.

Kan jeg bake et badge uten en plattform? Ja. Spesifikasjonen er åpen, og det finnes biblioteker for flere språk. Den vanskeligere delen er å hoste assertion på en stabil URL, og det er det som gjør verifisering meningsfull. Det er den delen en plattform tar seg av for deg.

Avslører baking mottakerens e-post? Ikke når identiteten er hashet. Assertion lagrer en saltet hash, så filen avslører ikke adressen.

Vil LinkedIn lese de bakede dataene? LinkedIns Add to Profile-flyt bygger på et legitimasjonsnavn, en utsteder, en dato og en URL i stedet for filens metadata. Se å legge til en Add to LinkedIn-knapp.

Oppsummering

Et baked Open Badge er en PNG (eller SVG) med legitimasjonen skrevet inn i en tekstchunk kalt openbadges. Det gjør et badge portabelt og selvbeskrivende, men den reelle tilliten kommer fra den hostede assertion på utstederens domene. Bak for portabilitetens skyld, publiser en verifiseringslenke for tillitens skyld, og forvent at sosiale nettverk fjerner metadataene.

Klar til å utstede din første verifiserbare legitimasjon? Kom i gang gratis på badges.ninja — visuell designer, offentlig verifiseringsside, PDF-sertifikat, Open Badge v2.0-utdata. Ingen kredittkort nødvendig.

Nacho Coll

Om forfatteren

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.

Tilbake til bloggen

Relaterte artikler