Baking на Open Badge: как JSON живее вътре в PNG
„Изпечената“ (baked) Open Badge е PNG с вграден като метаданни JSON на удостоверението. Файлът на значката Е самото удостоверение. Как работи baking и как да верифицирате изпечена значка.
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.
Изтеглете Open Badge от почти всеки издател и ще получите обикновено изглеждащ PNG. Пуснете го в чат, прикачете го към имейл, разпечатайте го. Изглежда като всяко друго изображение. Но файлът носи втори, невидим слой: самото удостоверение, записано в изображението като метаданни. Общността около Open Badges го нарича изпечена значка (baked badge) и именно затова значката може да пътува като един-единствен файл и въпреки това да доказва кой я е издал, на кого и за какво.
Това ръководство обяснява какво е baking, къде в файла се съхраняват данните, как верификаторът ги прочита и какво трябва да решите вие като издател на удостоверения. Не е нужно да пишете код, за да използвате изпечени значки. Ако издавате през https://badges.ninja, baking се случва автоматично. Но разбирането на механиката ви помага да отговаряте на въпросите, които получателите и работодателите наистина задават: „Това изображение истинско ли е?“ и „Може ли някой просто да го копира?“
Какво означава „baking“
Open Badge има две части, които лесно се бъркат:
- Картинката. PNG или SVG, което хората виждат в профил, на слайд или върху сертификат.
- Твърдението (assertion). Малък JSON документ, който излага фактите: кой е получателят (като хеширан идентификатор), кой клас значка е спечелен, кой я е издал, кога и къде може да се верифицира.
Baking е действието по записване на assertion в картинката, така че двете да не могат да бъдат разделени. Резултатът е един файл. Подадете на някого PNG-то и сте му подали и изображението, и твърдението зад него.
Идеята идва от спецификацията Open Badges, първоначално разработена от Mozilla и днес поддържана от 1EdTech. Смисълът на дизайна е преносимостта. В началото значките живееха в една-единствена платформа, а преместването на значка другаде означаваше ново качване и надежда метаданните да оцелеят. Изпеченият файл носи собствените си метаданни навсякъде, където отиде.
Къде живее JSON в PNG
PNG файлът е кратка сигнатура, следвана от последователност от chunk-ове. Всеки chunk има дължина, четирибуквен тип, някакви данни и контролна сума. Програмите за преглед рисуват пикселите от chunk-овете IDAT и игнорират типове chunk-ове, които не разбират. Именно тази толерантност прави baking възможен: можете да добавите chunk, пълен с текст, и всеки визуализатор на изображения в света пак ще покаже картинката нормално.
За Open Badges 2.0 assertion се записва в текстов chunk с ключова дума openbadges. Типовете текстови chunk-ове, които могат да го съдържат, са:
| Chunk | Кодиране | Бележки |
|---|---|---|
tEXt | Latin-1 | Просто, но ограничено до символи от Latin-1. |
iTXt | UTF-8 | Предпочитано, защото имената и описанията често не са ASCII. |
Какъвто и chunk да се използва, подредбата е една и съща: ключовата дума openbadges, разделител, после полезният товар (payload). Payload е едно от две неща, в зависимост от избора на издателя при baking:
- Самият assertion JSON. Файлът е самоописващ се. Верификаторът може да прочете твърдението без никакво мрежово извикване.
- URL, който сочи към хостнатия assertion. Файлът е по-малък, а издателят може да запази живия запис като авторитетен, например за да покаже, че значката по-късно е била отнета или е изтекла.
Съществува и трети вариант за подписани значки, при който payload е подписан токен вместо обикновен JSON. Ако подписите са важни за вашия случай, прочетете как да верифицирате подпис на Open Badge.
Ами SVG?
SVG значките също могат да се изпекат, тъй като SVG е XML. Assertion се поставя във файла в елемент от XML пространството на имената openbadges, а атрибутът verify носи URL на хостнатия assertion. Принципът е същият както при PNG: метаданните пътуват вътре в файла на изображението. На практика повечето платформи пекат PNG, защото PNG се приема почти навсякъде, където хората искат да качат значка.
Как изглежда вграденият assertion
За формат 2.0 хостнатият assertion е JSON-LD, който свързва получателя, класа на значката и метода за верификация. Съкратен пример:
{
"@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" }
}
Обърнете внимание на получателя. Имейлът не се съхранява в чист вид; това е хеш SHA-256 със salt. Това е важно за файл, предназначен да се разпространява. Всеки, който държи PNG-то, може да прочете assertion, затова той не бива да издава адреса на получателя. Верификатор, който вече знае имейла, може да го хешира със същия salt и да провери дали съвпада. За разглеждане поле по поле на този документ вижте разбора на Open Badge JSON-LD.
Как верификаторът чете изпечена значка
Верификацията на изпечена значка е кратък, механичен процес:
- Отворете PNG-то и обходете chunk-овете му.
- Намерете текстовия chunk с ключова дума
openbadges. - Прочетете payload. Ако е JSON, парсирайте го. Ако е URL, изтеглете го.
- Проверете дали assertion се отнася до класа значка и издателя, които очаквате, и дали идентичността на получателя съвпада с човека, който я представя.
- Ако типът верификация е
hosted, потвърдете, че хостнатият assertion все още съществува на свояidURL и не е бил отнет или изтекъл.
Стъпка 5 е тази, която хората пропускат, и именно тя прави удостоверението достоверно. Вграденото копие е моментна снимка. Хостнатият запис е източникът на истината.
Прочитане сами с Node
Можете да инспектирате всяко PNG с кратък скрипт. Този обхожда chunk-овете и отпечатва payload на openbadges, като обработва и tEXt, и 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);
Стартирайте го с node extract-badge.mjs my-badge.png. Ако файлът е изпечен, ще видите JSON или URL. Ако не, получавате обикновено съобщение „not baked“. Това е учебен инструмент, а не пълен валидатор: той не проверява контролните суми на chunk-овете, не парсира подписани payload-и и не изтегля хостнатия запис.
Ако предпочитате да не пишете код, онлайн валидатор на значки или програма за преглед на метаданни на PNG ще покаже същия chunk. Форматът е стандарт, така че всеки съвместим инструмент чете всяка съвместима значка.
Защо baking има значение
Преносимост. Удостоверение, което е просто PNG, може да се изпрати по имейл, да се качи в платформа за обучение или да се съхрани в личен архив. Не е нужен акаунт, за да го носите.
Път към верификация, който надживява маркетинговия сайт на издателя. Вграденият assertion назовава издателя и сочи към хостнатия запис, така че верификаторът може да започне само от файла.
Офлайн и нискотехнологични процеси. Когато payload е пълният JSON, четящият може да провери твърдението на машина без мрежа, а хостнатия запис да верифицира по-късно.
Доказателство, което трудно се фалшифицира между другото. Всеки може да направи screenshot на значка. Screenshot-ът няма метаданни, така че не може да бъде верифициран като файл на значка. Само това отделя истинското удостоверение от копирано изображение. То не пречи на някого да изпече фалшив assertion в открадната картинка, и затова съществува стъпката за верификация на хостнатия запис.
Ограниченията на baking
Бъдете честни с получателите си за тях, защото те влияят на начина, по който описвате удостоверенията си.
- Метаданните се изтриват. Много социални мрежи, оптимизатори на изображения и приложения за съобщения прекодират качените файлове и изхвърлят chunk-овете, които не са пиксели. Изпечена значка, публикувана в социален поток, обикновено вече не е изпечена. Това е очаквано и затова публичната връзка за верификация е важна заедно с файла.
- Baking сам по себе си не е доказателство. Вграден JSON може да бъде написан от всеки. Доверието идва от хостнатия assertion в домейна на издателя или от валиден подпис.
- Редакциите на изображението късат връзката. Преоразмеряването или повторното запазване в редактор може да загуби chunk-а.
- Само PNG и SVG. JPEG няма еквивалентна конвенция за chunk-ове в спецификацията, така че значка в стил снимка, експортирана като JPEG, не може да бъде изпечена по стандартния начин.
Практичният извод: третирайте изпечения файл като удобен носител, а страницата за верификация като авторитета. Ако преценявате формати за вашата програма, Open Badges срещу PDF сертификати обяснява защо машинночетимото удостоверение превъзхожда статичния документ.
Как работи baking в https://badges.ninja
Когато присъдите значка в https://badges.ninja, платформата изгражда assertion на Open Badge за този получател и го пече в изображението на значката като част от издаването. Не конфигурирате инструмент и не изпълнявате команда. Процесът:
- Проектирате значката във визуалния дизайнер или качвате собствено изображение.
- Издавате награда от таблото, от качване на CSV за масови награди или през API.
- Платформата създава assertion, пече го в PNG и съхранява резултата заедно с наградата.
- Получателят получава публична страница за верификация на
https://badges.ninja/awards/<awardId>, PDF сертификат, QR код и опция Add to LinkedIn.
Ако дизайнът на значката използва полета за сливане (merge fields), като името на получателя, всяка награда получава персонализирано изображение, а именно персонализираното изображение е това, което се пече.
Baking се третира като подобрение на издаването, а не като бариера: ако конкретно изображение не може да бъде изпечено (например дегенерирано изображение-заместител), наградата пак се издава с оригиналното изображение, а публичната страница за верификация и Open Badge JSON-LD не са засегнати. Качваното изображение трябва също да надхвърля минимален размер, така че мъничък празен canvas се отхвърля още преди да стигне до „пекарната“.
Тъй като публичната страница е авторитетът, всеки може да провери награда без да се регистрира. Машинночетимият Open Badge v2.0 JSON-LD за дадена награда е достъпен на https://api.badges.ninja/certify-badge/award/<awardId>.
Издаване на една награда през API
Повечето читатели ще използват таблото, но ако автоматизирате издаването, една заявка създава наградата (а изпеченото изображение идва с нея). Заменете ключа и id на значката с вашите:
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}`;
Извикването връща HTTP 200 с { "awardId": "<guid>" }. Изградете URL за верификация от това id. За настройка на ключ и пълната справка за заявките вижте документацията на Awards API и ръководството за удостоверяване.

Практически съвети за издатели
Винаги публикувайте връзка за верификация до файла. Сложете връзката в имейла за наградата, върху сертификата и на всяка страница, където се показва значката. Тъй като социалните платформи изтриват метаданните, връзката е това, което запазва удостоверението верифицируемо след споделяне.
Използвайте чисто изображение с прилична големина. Започнете от PNG с реални размери. Значка, направена от дизайнер при нормална резолюция, се пече надеждно; заместител от 1 пиксел – не.
Не редактирайте доставения файл. Кажете на получателите да споделят оригиналното изтегляне или връзката за верификация, а не изрязан screenshot.
Решете какво искате да кажете за отнемането и изтичането. Тъй като хостнатият запис е авторитетен, изпеченият файл може да надживее статуса на удостоверението. Кажете го ясно в документацията на програмата си, за да знаят работодателите да проверяват страницата за верификация, вместо да се доверяват само на файла.
Тествайте една значка от край до край. Издайте награда на себе си, изтеглете PNG, прекарайте го през скрипта по-горе или през публичен валидатор и отворете връзката за верификация. Пет минути тестване ви показват какво ще изживеят получателите ви.

Често задавани въпроси
Изпечената значка същото ли е като цифров сертификат? Не. Сертификатът обикновено е PDF за четене и печат. Изпечената значка е изображение, което носи и машинночетими данни за удостоверението. https://badges.ninja създава и двете от една и съща награда.
Мога ли да изпека значка без платформа? Да. Спецификацията е отворена и има библиотеки за няколко езика. По-трудната част е хостването на assertion на стабилен URL, което прави верификацията смислена. Именно тази част платформата поема вместо вас.
Разкрива ли baking имейла на получателя? Не, когато идентичността е хеширана. Assertion съхранява хеш със salt, така че файлът не разкрива адреса.
LinkedIn чете ли изпечените данни? Потокът Add to Profile на LinkedIn работи с име на удостоверението, издател, дата и URL, а не с метаданните на файла. Вижте добавяне на бутон Add to LinkedIn.
Обобщение
Изпечената Open Badge е PNG (или SVG) с удостоверението, записано в текстов chunk с име openbadges. Тя прави значката преносима и самоописваща се, но истинското доверие идва от хостнатия assertion в домейна на издателя. Пекете за преносимост, публикувайте връзка за верификация за доверие и очаквайте социалните мрежи да изтриват метаданните.
Готови ли сте да издадете първото си верифицируемо удостоверение? Започнете безплатно в badges.ninja — визуален дизайнер, публична страница за верификация, PDF сертификат, изход Open Badge v2.0. Без кредитна карта.
Как беше създадена тази статия
Някои публикации в този блог се изготвят с помощта на AI асистент, след което се преглеждат, проверяват и редактират от екипа на Badges Ninja преди публикуване. Всеки примерен код и цена се проверяват спрямо реалния продукт. Прочетете повече за нашия редакционен и AI процес на нашата страница за редакционния процес .

За автора
Nacho Coll
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.
Още от Nacho Coll
- Open Badges за кодинг бууткампове: верифицируеми удостоверения в мащаба на цял випуск19.11.2026 г. · 11мин четене
- Настройване на уебхукове за събития със значки: интеграция в реално време с вашия бекенд16.11.2026 г. · 9мин четене
- Срок на валидност и подновяване на Open Badge: управление на жизнения цикъл на времево ограничени удостоверения12.11.2026 г. · 11мин четене


