Open Badge Baking erklärt: Wie das JSON im PNG steckt

Ein „gebackenes“ Open Badge ist ein PNG mit der Assertion-JSON als Bild-Metadaten. Die Badge-Datei IST das Credential. So funktioniert Baking und so prüfst du ein gebackenes Badge.

Nacho Coll Von Aktualisiert 11 Min. Lesezeit
Ein „gebackenes“ Open Badge ist ein PNG mit der Assertion-JSON als Bild-Metadaten. Die Badge-Datei IST das Credential. So funktioniert Baking und so prüfst du ein gebackenes Badge.

Lädst du ein Open Badge von fast jedem Aussteller herunter, bekommst du ein ganz normal aussehendes PNG. Wirf es in einen Chat, häng es an eine E-Mail, drucke es aus. Es sieht aus wie jedes andere Bild. Doch die Datei trägt eine zweite, unsichtbare Ebene: das Credential selbst, als Metadaten ins Bild geschrieben. Die Open-Badges-Community nennt das ein gebackenes Badge (baked badge). Genau deshalb kann ein Badge als einzelne Datei reisen und trotzdem belegen, wer es ausgestellt hat, für wen und wofür.

Dieser Leitfaden erklärt, was Baking ist, wo die Daten in der Datei liegen, wie ein Prüfer sie wieder ausliest und was du als Aussteller von Credentials entscheiden musst. Zum Nutzen gebackener Badges musst du keinen Code schreiben. Stellst du über https://badges.ninja aus, übernimmt das Baking die Plattform. Aber wer die Mechanik versteht, kann die Fragen beantworten, die Empfänger und Arbeitgeber tatsächlich stellen: „Ist dieses Bild echt?“ und „Kann das nicht einfach jeder kopieren?“

Was „Baking“ bedeutet

Ein Open Badge besteht aus zwei Teilen, die man leicht verwechselt:

  • Das Bild. Das PNG oder SVG, das Leute in einem Profil, auf einer Folie oder auf einem Zertifikat sehen.
  • Die Assertion. Ein kleines JSON-Dokument mit den Fakten: wer der Empfänger ist (als gehashte Kennung), welche Badge-Klasse erworben wurde, wer sie ausgestellt hat, wann und wo man sie verifizieren kann.

Baking bedeutet, die Assertion so ins Bild zu schreiben, dass sich beides nicht mehr trennen lässt. Das Ergebnis ist eine einzige Datei. Gibst du jemandem das PNG, gibst du ihm Bild und Aussage dahinter zugleich.

Die Idee stammt aus der Open-Badges-Spezifikation, die ursprünglich von Mozilla entwickelt wurde und heute von 1EdTech gepflegt wird. Ziel des Designs ist Portabilität. Anfangs lebten Badges innerhalb einer einzelnen Plattform, und ein Umzug bedeutete erneutes Hochladen und die Hoffnung, dass die Metadaten überleben. Eine gebackene Datei trägt ihre Metadaten überallhin mit.

Wo das JSON im PNG liegt

Eine PNG-Datei besteht aus einer kurzen Signatur, gefolgt von einer Folge von Chunks. Jeder Chunk hat eine Länge, einen vierbuchstabigen Typ, Daten und eine Prüfsumme. Viewer zeichnen die Pixel aus den IDAT-Chunks und ignorieren Chunk-Typen, die sie nicht kennen. Diese Toleranz macht Baking möglich: Du kannst einen Chunk voller Text hinzufügen, und jeder Bildbetrachter der Welt zeigt das Bild trotzdem normal an.

Bei Open Badges 2.0 landet die Assertion in einem Text-Chunk mit dem Schlüsselwort openbadges. Diese Text-Chunk-Typen können sie aufnehmen:

ChunkKodierungHinweise
tEXtLatin-1Einfach, aber auf Latin-1-Zeichen beschränkt.
iTXtUTF-8Bevorzugt, weil Namen und Beschreibungen oft nicht ASCII sind.

Welcher Chunk auch genutzt wird, der Aufbau ist derselbe: das Schlüsselwort openbadges, ein Trennzeichen, dann die Nutzlast. Die Nutzlast ist eines von zwei Dingen, je nachdem, wie der Aussteller gebacken hat:

  1. Die Assertion-JSON selbst. Die Datei beschreibt sich selbst. Ein Prüfer kann die Aussage ohne Netzwerkzugriff lesen.
  2. Eine URL, die auf die gehostete Assertion zeigt. Die Datei ist kleiner, und der Aussteller kann den Live-Eintrag maßgeblich halten, etwa um zu zeigen, dass ein Badge später widerrufen wurde oder abgelaufen ist.

Für signierte Badges gibt es eine dritte Variante, bei der die Nutzlast ein signiertes Token statt einfachem JSON ist. Wenn Signaturen für deinen Fall wichtig sind, lies wie man die Signatur eines Open Badge prüft.

Und SVG?

SVG-Badges lassen sich ebenfalls backen, da SVG XML ist. Die Assertion steht in der Datei in einem Element des XML-Namensraums openbadges, und das Attribut verify trägt die URL der gehosteten Assertion. Das Prinzip ist dasselbe wie bei PNG: Die Metadaten reisen in der Bilddatei mit. In der Praxis backen die meisten Plattformen PNG, weil PNG fast überall akzeptiert wird, wo Leute ein Badge hochladen wollen.

So sieht die eingebettete Assertion aus

Im 2.0-Format ist eine gehostete Assertion JSON-LD, das Empfänger, Badge-Klasse und Verifikationsmethode verknüpft. Ein gekürztes Beispiel:

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

Achte auf den Empfänger. Die E-Mail-Adresse steht nicht im Klartext, sondern als gesalzener SHA-256-Hash. Das ist wichtig bei einer Datei, die herumgereicht werden soll. Jeder, der das PNG besitzt, kann die Assertion lesen, also darf sie die Adresse des Empfängers nicht preisgeben. Wer die E-Mail bereits kennt, kann sie mit demselben Salt hashen und prüfen, ob sie übereinstimmt. Eine Tour durch dieses Dokument Feld für Feld findest du in der Open-Badge-JSON-LD-Erklärung.

Wie ein Prüfer ein gebackenes Badge liest

Die Verifikation eines gebackenen Badges ist ein kurzer, mechanischer Ablauf:

  1. Öffne das PNG und gehe seine Chunks durch.
  2. Finde den Text-Chunk mit dem Schlüsselwort openbadges.
  3. Lies die Nutzlast. Ist es JSON, parse es. Ist es eine URL, rufe sie ab.
  4. Prüfe, ob die Assertion auf die erwartete Badge-Klasse und den erwarteten Aussteller verweist und ob die Empfängerkennung zur Person passt, die das Badge vorzeigt.
  5. Ist der Verifikationstyp hosted, bestätige, dass die gehostete Assertion unter ihrer id-URL noch existiert und weder widerrufen noch abgelaufen ist.

Schritt 5 überspringen die meisten, und er macht ein Credential erst vertrauenswürdig. Eine eingebettete Kopie ist eine Momentaufnahme. Der gehostete Eintrag ist die Quelle der Wahrheit.

Selbst auslesen mit Node

Mit einem kurzen Skript kannst du jedes PNG untersuchen. Dieses geht die Chunks durch und gibt die openbadges-Nutzlast aus, für tEXt und 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);

Starte es mit node extract-badge.mjs my-badge.png. Ist die Datei gebacken, siehst du JSON oder eine URL. Andernfalls erscheint die schlichte Meldung „not baked“. Das ist ein Lernwerkzeug, kein vollständiger Validator: Es prüft weder Chunk-Prüfsummen noch signierte Nutzlasten und ruft auch den gehosteten Eintrag nicht ab.

Wenn du lieber keinen Code schreibst, zeigen dir ein Online-Badge-Validator oder ein PNG-Metadaten-Viewer denselben Chunk. Das Format ist der Standard, also liest jedes konforme Tool jedes konforme Badge.

Warum Baking wichtig ist

Portabilität. Ein Credential, das nur ein PNG ist, lässt sich per E-Mail verschicken, auf eine Lernplattform hochladen oder im privaten Archiv ablegen. Zum Transport braucht es kein Konto.

Ein Verifikationsweg, der die Marketing-Seite des Ausstellers überlebt. Die eingebettete Assertion nennt den Aussteller und verweist auf den gehosteten Eintrag, sodass ein Prüfer allein von der Datei aus starten kann.

Offline und Low-Tech-Abläufe. Ist die Nutzlast die vollständige JSON, kann man die Aussage auf einem Rechner ohne Netzwerk prüfen und den gehosteten Eintrag später verifizieren.

Belege, die sich nicht nebenbei fälschen lassen. Einen Screenshot kann jeder machen. Ein Screenshot hat keine Metadaten und lässt sich daher nicht als Badge-Datei verifizieren. Allein das trennt ein echtes Credential von einem kopierten Bild. Es hindert aber niemanden daran, eine gefälschte Assertion in ein gestohlenes Bild zu backen, und genau dafür gibt es den Verifikationsschritt über den gehosteten Eintrag.

Die Grenzen des Bakings

Sei gegenüber deinen Empfängern ehrlich darüber, denn es beeinflusst, wie du deine Credentials beschreibst.

  • Metadaten werden entfernt. Viele soziale Netzwerke, Bildoptimierer und Messenger kodieren Uploads neu und werfen Chunks ohne Pixeldaten weg. Ein in einen Social-Feed gepostetes gebackenes Badge ist meist nicht mehr gebacken. Das ist zu erwarten, und deshalb ist neben der Datei ein öffentlicher Verifikationslink wichtig.
  • Baking allein ist kein Beweis. Eingebettetes JSON kann jeder schreiben. Vertrauen entsteht durch die gehostete Assertion auf der Domain des Ausstellers oder durch eine gültige Signatur.
  • Bildbearbeitung bricht die Verbindung. Skalieren oder erneutes Speichern in einem Editor kann den Chunk verlieren.
  • Nur PNG und SVG. JPEG hat in der Spezifikation keine entsprechende Chunk-Konvention, ein als JPEG exportiertes foto-artiges Badge lässt sich also nicht auf dem Standardweg backen.

Die praktische Schlussfolgerung: Betrachte die gebackene Datei als bequemen Träger und die Verifikationsseite als die Autorität. Wenn du Formate für dein Programm abwägst, erklärt Open Badges vs. PDF-Zertifikate, warum ein maschinenlesbares Credential ein statisches Dokument schlägt.

So funktioniert Baking bei https://badges.ninja

Wenn du auf https://badges.ninja ein Badge vergibst, baut die Plattform die Open-Badge-Assertion für diesen Empfänger und backt sie beim Ausstellen ins Badge-Bild. Du musst weder ein Tool konfigurieren noch einen Befehl ausführen. Der Ablauf:

  1. Du gestaltest das Badge im visuellen Designer oder lädst dein eigenes Bild hoch.
  2. Du stellst eine Auszeichnung aus: über das Dashboard, per CSV-Upload für Massenvergaben oder über die API.
  3. Die Plattform erstellt die Assertion, backt sie ins PNG und speichert das Ergebnis bei der Auszeichnung.
  4. Der Empfänger erhält eine öffentliche Verifikationsseite unter https://badges.ninja/awards/<awardId>, ein PDF-Zertifikat, einen QR-Code und eine Option „Zu LinkedIn hinzufügen“.

Nutzt das Badge-Design Merge-Felder wie den Namen des Empfängers, erhält jede Auszeichnung ein personalisiertes Bild, und dieses personalisierte Bild wird gebacken.

Baking gilt als Zusatz beim Ausstellen, nicht als Hürde: Lässt sich ein bestimmtes Bild nicht backen (etwa ein degeneriertes Platzhalterbild), wird die Auszeichnung trotzdem mit dem Originalbild ausgestellt, und die öffentliche Verifikationsseite sowie das Open-Badge-JSON-LD bleiben unberührt. Das hochgeladene Bild muss außerdem eine Mindestgröße erreichen, damit eine winzige leere Fläche abgelehnt wird, bevor sie die Bäckerei erreicht.

Weil die öffentliche Seite die Autorität ist, kann jeder eine Auszeichnung ohne Anmeldung prüfen. Das maschinenlesbare Open-Badge-v2.0-JSON-LD einer Auszeichnung ist unter https://api.badges.ninja/certify-badge/award/<awardId> abrufbar.

Eine Auszeichnung per API ausstellen

Die meisten nutzen das Dashboard, aber wenn du das Ausstellen automatisierst, erzeugt eine einzige Anfrage die Auszeichnung (das gebackene Bild kommt gleich mit). Ersetze Schlüssel und Badge-ID durch deine eigenen:

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

Der Aufruf liefert HTTP 200 mit { "awardId": "<guid>" }. Bilde die Verifikations-URL aus dieser ID. Zur Schlüsseleinrichtung und zur vollständigen Anfragereferenz siehe die Awards-API-Dokumentation und den Authentifizierungsleitfaden.

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

Praktische Tipps für Aussteller

Veröffentliche immer einen Verifikationslink neben der Datei. Setze den Link in die Auszeichnungs-E-Mail, aufs Zertifikat und auf jede Seite, auf der das Badge angezeigt wird. Da soziale Plattformen Metadaten entfernen, hält der Link das Credential nach dem Teilen verifizierbar.

Nimm ein sauberes Quellbild in ordentlicher Größe. Beginne mit einem PNG mit echten Abmessungen. Ein von einem Designer erstelltes Badge in normaler Auflösung lässt sich zuverlässig backen, ein 1-Pixel-Platzhalter nicht.

Bearbeite die ausgelieferte Datei nicht. Sag deinen Empfängern, dass sie den Original-Download oder den Verifikationslink teilen sollen, keinen zugeschnittenen Screenshot.

Entscheide, was du zu Widerruf und Ablauf sagen willst. Weil der gehostete Eintrag maßgeblich ist, kann eine gebackene Datei den Status des Credentials überdauern. Schreib das klar in deine Programmdokumentation, damit Arbeitgeber wissen, dass sie die Verifikationsseite prüfen sollen, statt der Datei allein zu vertrauen.

Teste ein Badge von Anfang bis Ende. Stell dir selbst eine Auszeichnung aus, lade das PNG herunter, lass es durch das Skript oben oder einen öffentlichen Validator laufen und öffne den Verifikationslink. Fünf Minuten Testen zeigen dir, was deine Empfänger erleben werden.

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

Häufig gestellte Fragen

Ist ein gebackenes Badge dasselbe wie ein digitales Zertifikat? Nein. Ein Zertifikat ist meist ein PDF zum Lesen und Drucken. Ein gebackenes Badge ist ein Bild, das zusätzlich maschinenlesbare Credential-Daten trägt. https://badges.ninja erzeugt beides aus derselben Auszeichnung.

Kann ich ein Badge ohne Plattform backen? Ja. Die Spezifikation ist offen, und für mehrere Sprachen gibt es Bibliotheken. Der schwierigere Teil ist, die Assertion unter einer stabilen URL zu hosten, denn das macht die Verifikation aussagekräftig. Genau das übernimmt eine Plattform für dich.

Gibt Baking die E-Mail-Adresse des Empfängers preis? Nicht, wenn die Kennung gehasht ist. Die Assertion speichert einen gesalzenen Hash, die Datei verrät die Adresse also nicht.

Liest LinkedIn die gebackenen Daten? Der Ablauf „Zum Profil hinzufügen“ von LinkedIn arbeitet mit Credential-Name, Aussteller, Datum und URL, nicht mit den Datei-Metadaten. Siehe einen „Zu LinkedIn hinzufügen“-Button einbauen.

Zusammenfassung

Ein gebackenes Open Badge ist ein PNG (oder SVG), in das das Credential in einen Text-Chunk namens openbadges geschrieben wurde. Es macht ein Badge portabel und selbstbeschreibend, aber das eigentliche Vertrauen kommt von der gehosteten Assertion auf der Domain des Ausstellers. Back für die Portabilität, veröffentliche einen Verifikationslink fürs Vertrauen und rechne damit, dass soziale Netzwerke die Metadaten entfernen.

Bereit, dein erstes verifizierbares Credential auszustellen? Kostenlos starten auf badges.ninja — visueller Designer, öffentliche Verifikationsseite, PDF-Zertifikat, Open-Badge-v2.0-Ausgabe. Keine Kreditkarte nötig.

Nacho Coll

Über den 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.

Zurück zum Blog

Verwandte Artikel