Baking w Open Badge po ludzku: jak JSON mieszka w pliku PNG

„Upieczona” odznaka Open Badge to plik PNG z JSON-em asercji osadzonym jako metadane obrazu. Plik odznaki JEST poświadczeniem. Jak działa baking i jak zweryfikować upieczoną odznakę.

Nacho Coll Autor Zaktualizowano 10 min czytania
„Upieczona” odznaka Open Badge to plik PNG z JSON-em asercji osadzonym jako metadane obrazu. Plik odznaki JEST poświadczeniem. Jak działa baking i jak zweryfikować upieczoną odznakę.

Pobierz odznakę Open Badge od niemal dowolnego wystawcy, a dostaniesz zwykły z wyglądu plik PNG. Wrzucisz go na czat, dołączysz do e-maila, wydrukujesz. Wygląda jak każdy inny obrazek. Ale plik niesie drugą, niewidoczną warstwę: samo poświadczenie, zapisane w obrazie jako metadane. Społeczność Open Badges nazywa to upieczoną odznaką (baked badge) i właśnie dzięki temu odznaka może podróżować jako pojedynczy plik, a mimo to dowodzić, kto ją wystawił, komu i za co.

Ten przewodnik wyjaśnia, czym jest baking, gdzie w pliku leżą dane, jak weryfikator odczytuje je z powrotem i co musisz rozstrzygnąć jako wystawca poświadczeń. Nie musisz pisać kodu, żeby korzystać z upieczonych odznak. Jeśli wystawiasz je przez https://badges.ninja, baking dzieje się za ciebie. Ale zrozumienie mechaniki pomaga odpowiadać na pytania, które naprawdę zadają odbiorcy i pracodawcy: „Czy ten obrazek jest prawdziwy?” i „Czy ktoś może go po prostu skopiować?”

Co oznacza „baking”

Odznaka Open Badge składa się z dwóch części, które łatwo pomylić:

  • Obrazek. PNG lub SVG, który ludzie widzą na profilu, slajdzie czy certyfikacie.
  • Asercja. Mały dokument JSON, który podaje fakty: kim jest odbiorca (jako zahaszowany identyfikator), jaką klasę odznaki zdobył, kto ją wystawił, kiedy i gdzie ją zweryfikować.

Baking to wpisanie asercji do obrazka tak, by nie dało się ich rozdzielić. Wynikiem jest jeden plik. Przekazujesz komuś PNG, a razem z nim obraz i stojące za nim twierdzenie.

Pomysł wywodzi się ze specyfikacji Open Badges, opracowanej pierwotnie przez Mozillę, a obecnie rozwijanej przez 1EdTech. Sens tego rozwiązania to przenośność. Na początku odznaki żyły wewnątrz jednej platformy, a przeniesienie ich gdzie indziej oznaczało ponowne wgrywanie i nadzieję, że metadane przetrwają. Upieczony plik zabiera swoje metadane wszędzie ze sobą.

Gdzie w PNG leży JSON

Plik PNG to krótka sygnatura, po której następuje ciąg chunków. Każdy chunk ma długość, czteroliterowy typ, dane i sumę kontrolną. Przeglądarki obrazów rysują piksele z chunków IDAT i ignorują typy chunków, których nie rozumieją. Ta tolerancja umożliwia baking: możesz dodać chunk pełen tekstu, a każdy przeglądarkowy podgląd na świecie nadal wyświetli obrazek normalnie.

W Open Badges 2.0 asercja trafia do chunku tekstowego ze słowem kluczowym openbadges. Typy chunków tekstowych, które mogą ją pomieścić:

ChunkKodowanieUwagi
tEXtLatin-1Proste, ale ograniczone do znaków Latin-1.
iTXtUTF-8Preferowane, bo imiona i opisy często nie są ASCII.

Niezależnie od użytego chunku układ jest ten sam: słowo kluczowe openbadges, separator, potem ładunek. Ładunek to jedna z dwóch rzeczy, zależnie od tego, jak wystawca zdecydował się upiec odznakę:

  1. Sam JSON asercji. Plik opisuje się sam. Weryfikator może odczytać twierdzenie bez żadnego połączenia sieciowego.
  2. Adres URL wskazujący na hostowaną asercję. Plik jest mniejszy, a wystawca może utrzymać żywy rekord jako wiążący, na przykład aby pokazać, że odznaka została później unieważniona lub wygasła.

Istnieje też trzeci wariant dla odznak podpisanych, w którym ładunkiem jest podpisany token zamiast zwykłego JSON-a. Jeśli podpisy mają znaczenie w twoim przypadku, przeczytaj jak zweryfikować podpis Open Badge.

A co z SVG?

Odznaki SVG także można upiec, bo SVG to XML. Asercja trafia do pliku jako element w przestrzeni nazw XML openbadges, a atrybut verify zawiera adres URL hostowanej asercji. Zasada jest taka sama jak przy PNG: metadane jadą wewnątrz pliku obrazu. W praktyce większość platform piecze PNG, bo PNG jest akceptowany niemal wszędzie, gdzie ludzie chcą wgrać odznakę.

Jak wygląda osadzona asercja

W formacie 2.0 hostowana asercja to JSON-LD łączący odbiorcę, klasę odznaki i metodę weryfikacji. Skrócony przykład:

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

Zwróć uwagę na odbiorcę. E-mail nie jest zapisany jawnie; to zasolony hasz SHA-256. Ma to znaczenie dla pliku, który ma krążyć. Każdy, kto trzyma PNG, może odczytać asercję, więc asercja nie może zdradzać adresu odbiorcy. Weryfikator, który zna e-mail, może zahaszować go tą samą solą i sprawdzić zgodność. Pole po polu ten dokument omawia przewodnik po JSON-LD w Open Badge.

Jak weryfikator czyta upieczoną odznakę

Weryfikacja upieczonej odznaki to krótki, mechaniczny proces:

  1. Otwórz PNG i przejdź po jego chunkach.
  2. Znajdź chunk tekstowy ze słowem kluczowym openbadges.
  3. Odczytaj ładunek. Jeśli to JSON, sparsuj go. Jeśli to URL, pobierz go.
  4. Sprawdź, czy asercja odnosi się do klasy odznaki i wystawcy, których oczekujesz, oraz czy tożsamość odbiorcy zgadza się z osobą, która ją przedstawia.
  5. Jeśli typ weryfikacji to hosted, potwierdź, że hostowana asercja nadal istnieje pod adresem URL w polu id i nie została unieważniona ani nie wygasła.

Krok 5 to ten, który ludzie pomijają, a to właśnie on czyni poświadczenie wiarygodnym. Osadzona kopia to migawka. Źródłem prawdy jest hostowany rekord.

Odczyt samodzielnie w Node

Dowolny PNG możesz sprawdzić krótkim skryptem. Ten przechodzi po chunkach i wypisuje ładunek openbadges, obsługując zarówno tEXt, jak 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);

Uruchom go poleceniem node extract-badge.mjs my-badge.png. Jeśli plik jest upieczony, zobaczysz JSON lub URL. Jeśli nie, dostaniesz zwykły komunikat „not baked”. To narzędzie dydaktyczne, a nie pełny walidator: nie sprawdza sum kontrolnych chunków, nie parsuje podpisanych ładunków ani nie pobiera hostowanego rekordu.

Jeśli wolisz nie pisać kodu, internetowy walidator odznak lub przeglądarka metadanych PNG pokaże ten sam chunk. Format jest standardem, więc każde zgodne narzędzie odczyta każdą zgodną odznakę.

Dlaczego baking ma znaczenie

Przenośność. Poświadczenie, które jest zwykłym PNG, można wysłać e-mailem, wgrać na platformę edukacyjną lub zachować w osobistym archiwum. Do jego przenoszenia nie jest potrzebne żadne konto.

Ścieżka weryfikacji, która przetrwa stronę marketingową wystawcy. Osadzona asercja wskazuje wystawcę i prowadzi do hostowanego rekordu, więc weryfikator może zacząć od samego pliku.

Przepływy offline i low-tech. Gdy ładunkiem jest pełny JSON, czytelnik może sprawdzić twierdzenie na maszynie bez sieci, a hostowany rekord zweryfikować później.

Dowód trudny do podrobienia na szybko. Każdy może zrobić zrzut ekranu odznaki. Zrzut nie ma metadanych, więc nie da się go zweryfikować jako pliku odznaki. Samo to odróżnia prawdziwe poświadczenie od skopiowanego obrazka. Nie powstrzyma to jednak kogoś przed upieczeniem sfałszowanej asercji w skradzionym obrazku, i dlatego istnieje krok weryfikacji hostowanej.

Ograniczenia bakingu

Bądź szczery wobec odbiorców co do tych kwestii, bo wpływają na to, jak opisujesz swoje poświadczenia.

  • Metadane bywają usuwane. Wiele sieci społecznościowych, optymalizatorów obrazów i komunikatorów ponownie koduje wgrywane pliki i odrzuca chunki niebędące pikselami. Upieczona odznaka opublikowana w mediach społecznościowych zwykle przestaje być upieczona. To oczekiwane i dlatego obok pliku liczy się publiczny link weryfikacyjny.
  • Baking sam w sobie nie jest dowodem. Osadzony JSON może napisać każdy. Zaufanie bierze się z hostowanej asercji w domenie wystawcy lub z prawidłowego podpisu.
  • Edycje obrazu zrywają powiązanie. Zmiana rozmiaru lub ponowny zapis w edytorze może zgubić chunk.
  • Tylko PNG i SVG. JPEG nie ma w specyfikacji odpowiednika konwencji chunków, więc odznaki w stylu zdjęcia wyeksportowanej do JPEG nie da się upiec standardową metodą.

Praktyczny wniosek: traktuj upieczony plik jako wygodny nośnik, a stronę weryfikacji jako autorytet. Jeśli wybierasz formaty dla swojego programu, Open Badges kontra certyfikaty PDF wyjaśnia, dlaczego poświadczenie czytelne maszynowo bije statyczny dokument.

Jak działa baking na https://badges.ninja

Gdy przyznajesz odznakę na https://badges.ninja, platforma buduje asercję Open Badge dla danego odbiorcy i piecze ją w obrazie odznaki w ramach wystawiania. Nie konfigurujesz żadnego narzędzia ani nie uruchamiasz poleceń. Przebieg:

  1. Projektujesz odznakę w wizualnym projektancie albo wgrywasz własny obraz.
  2. Wystawiasz nagrodę: z panelu, z wgranego pliku CSV przy nagrodach zbiorczych albo przez API.
  3. Platforma tworzy asercję, piecze ją w PNG i zapisuje wynik razem z nagrodą.
  4. Odbiorca otrzymuje publiczną stronę weryfikacji pod adresem https://badges.ninja/awards/<awardId>, certyfikat PDF, kod QR i opcję Dodaj do LinkedIn.

Jeśli projekt odznaki używa pól scalających, takich jak imię odbiorcy, każda nagroda dostaje spersonalizowany obraz i to właśnie ten spersonalizowany obraz jest pieczony.

Baking jest traktowany jako usprawnienie wystawiania, a nie bramka: jeśli konkretnego obrazu nie da się upiec (na przykład zdegenerowanego obrazu zastępczego), nagroda i tak zostanie wystawiona z oryginalnym obrazem, a publiczna strona weryfikacji i JSON-LD Open Badge pozostają nienaruszone. Wgrywany obraz musi też spełniać minimalny rozmiar, więc malutkie puste płótno zostaje odrzucone, zanim trafi do piekarni.

Ponieważ autorytetem jest strona publiczna, każdy może sprawdzić nagrodę bez zakładania konta. Czytelny maszynowo JSON-LD Open Badge v2.0 dla nagrody jest dostępny pod adresem https://api.badges.ninja/certify-badge/award/<awardId>.

Wystawienie jednej nagrody przez API

Większość czytelników skorzysta z panelu, ale jeśli automatyzujesz wystawianie, jedno żądanie tworzy nagrodę (a upieczony obraz dostajesz w pakiecie). Podmień klucz i identyfikator odznaki na własne:

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

Wywołanie zwraca HTTP 200 z { "awardId": "<guid>" }. Z tego identyfikatora zbuduj adres URL weryfikacji. Konfigurację klucza i pełną dokumentację żądań znajdziesz w dokumentacji API nagród i przewodniku po uwierzytelnianiu.

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

Praktyczne rady dla wystawców

Zawsze publikuj link weryfikacyjny obok pliku. Umieść link w e-mailu z nagrodą, na certyfikacie i na każdej stronie, na której odznaka jest wyświetlana. Skoro platformy społecznościowe usuwają metadane, to link utrzymuje weryfikowalność poświadczenia po udostępnieniu.

Użyj czystego obrazu źródłowego o sensownym rozmiarze. Zacznij od PNG o realnych wymiarach. Odznaka zaprojektowana przez grafika w normalnej rozdzielczości piecze się niezawodnie; jednopikselowy placeholder nie.

Nie edytuj dostarczonego pliku. Powiedz odbiorcom, żeby udostępniali oryginalny pobrany plik lub link weryfikacyjny, a nie przycięty zrzut ekranu.

Zdecyduj, co chcesz powiedzieć o unieważnieniu i wygaśnięciu. Ponieważ hostowany rekord jest wiążący, upieczony plik może przeżyć status poświadczenia. Napisz o tym jasno w dokumentacji programu, aby pracodawcy wiedzieli, że mają sprawdzić stronę weryfikacji, a nie ufać samemu plikowi.

Przetestuj jedną odznakę od początku do końca. Wystaw nagrodę samemu sobie, pobierz PNG, przepuść go przez powyższy skrypt lub publiczny walidator i otwórz link weryfikacyjny. Pięć minut testów pokaże ci, czego doświadczą twoi odbiorcy.

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

Najczęściej zadawane pytania

Czy upieczona odznaka to to samo co certyfikat cyfrowy? Nie. Certyfikat to zwykle PDF do czytania i drukowania. Upieczona odznaka to obraz, który niesie także czytelne maszynowo dane poświadczenia. https://badges.ninja tworzy oba z tej samej nagrody.

Czy mogę upiec odznakę bez platformy? Tak. Specyfikacja jest otwarta, a biblioteki istnieją dla kilku języków. Trudniejsza jest hostowana asercja pod stabilnym adresem URL, bo to ona nadaje weryfikacji sens. Tą częścią zajmuje się za ciebie platforma.

Czy baking ujawnia e-mail odbiorcy? Nie, gdy tożsamość jest zahaszowana. Asercja przechowuje zasolony hasz, więc plik nie zdradza adresu.

Czy LinkedIn odczyta upieczone dane? Przepływ Dodaj do profilu na LinkedIn opiera się na nazwie poświadczenia, wystawcy, dacie i URL, a nie na metadanych pliku. Zobacz dodawanie przycisku Dodaj do LinkedIn.

Podsumowanie

Upieczona odznaka Open Badge to PNG (lub SVG) z poświadczeniem wpisanym w chunk tekstowy o nazwie openbadges. Dzięki temu odznaka jest przenośna i samoopisująca się, ale prawdziwe zaufanie bierze się z hostowanej asercji w domenie wystawcy. Piecz dla przenośności, publikuj link weryfikacyjny dla zaufania i licz się z tym, że sieci społecznościowe usuną metadane.

Gotowy wystawić pierwsze weryfikowalne poświadczenie? Zacznij za darmo na badges.ninja — wizualny projektant, publiczna strona weryfikacji, certyfikat PDF, wyjście Open Badge v2.0. Karta kredytowa nie jest potrzebna.

Nacho Coll

O autorze

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.

Powrót do bloga

Powiązane artykuły