Open Badge Baking: как JSON оказывается внутри PNG
«Запечённый» Open Badge — это PNG с JSON-утверждением (assertion), встроенным как метаданные изображения. Файл значка И ЕСТЬ credential. Как работает 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. Отправьте его в чат, приложите к письму, распечатайте. Он выглядит как любое другое изображение. Но у файла есть второй, невидимый слой: сам credential, записанный в изображение как метаданные. Сообщество Open Badges называет это запечённым значком (baked badge), и именно поэтому значок может путешествовать как один файл и при этом подтверждать, кто его выдал, кому и за что.
В этом руководстве объясняется, что такое baking, где внутри файла хранятся данные, как верификатор считывает их обратно и какие решения предстоит принять вам как тому, кто выдаёт credentials. Чтобы пользоваться запечёнными значками, писать код не нужно. Если вы выдаёте значки через https://badges.ninja, baking выполняется за вас. Но понимание механики помогает ответить на вопросы, которые действительно задают получатели и работодатели: «Это изображение настоящее?» и «Разве его не может просто скопировать любой?»
Что значит «baking»
Open Badge состоит из двух частей, которые легко перепутать:
- Картинка. PNG или SVG, которые люди видят в профиле, на слайде или в сертификате.
- Утверждение (assertion). Небольшой JSON-документ с фактами: кто получатель (в виде хешированного идентификатора), какой класс значка получен, кто его выдал, когда и где его можно проверить.
Baking — это запись assertion в картинку так, чтобы их нельзя было разделить. В результате получается один файл. Передав кому-то PNG, вы передаёте и изображение, и стоящее за ним утверждение.
Идея пришла из спецификации Open Badges, изначально разработанной Mozilla и ныне поддерживаемой 1EdTech. Смысл дизайна — переносимость. Раньше значки жили внутри одной платформы, а перенос на новое место означал повторную загрузку и надежду, что метаданные уцелеют. Запечённый файл носит свои метаданные с собой.
Где JSON лежит внутри PNG
Файл PNG — это короткая сигнатура и последовательность чанков (chunks). У каждого чанка есть длина, четырёхбуквенный тип, данные и контрольная сумма. Программы просмотра рисуют пиксели из чанков IDAT и игнорируют незнакомые типы чанков. Эта терпимость и делает baking возможным: вы можете добавить чанк с текстом, и любая программа просмотра в мире по-прежнему покажет картинку как обычно.
В Open Badges 2.0 assertion помещается в текстовый чанк с ключевым словом openbadges. Вот типы текстовых чанков, которые могут его содержать:
| Чанк | Кодировка | Примечания |
|---|---|---|
tEXt | Latin-1 | Просто, но ограничено символами Latin-1. |
iTXt | UTF-8 | Предпочтительно, потому что имена и описания часто не ASCII. |
Какой бы чанк ни использовался, схема одна: ключевое слово openbadges, разделитель, затем полезная нагрузка. Нагрузка бывает одного из двух видов — в зависимости от того, как издатель решил запекать:
- Сам assertion в виде JSON. Файл самоописывающийся. Верификатор может прочитать утверждение без сетевых запросов.
- URL, указывающий на размещённый assertion. Файл меньше, а издатель может оставить авторитетной живую запись, например чтобы показать, что значок позже был отозван или срок его действия истёк.
Для подписанных значков существует третий вариант: нагрузкой служит подписанный токен вместо обычного 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" }
}
Обратите внимание на получателя. Email хранится не в открытом виде, а как хеш SHA-256 с солью. Это важно для файла, который предназначен для передачи из рук в руки. Любой, у кого есть PNG, может прочитать assertion, поэтому он не должен раскрывать адрес получателя. Верификатор, который уже знает email, может хешировать его с той же солью и проверить совпадение. Подробный разбор этого документа по полям — в разборе Open Badge JSON-LD.
Как верификатор читает запечённый значок
Верификация запечённого значка — короткий механический процесс:
- Откройте PNG и пройдитесь по его чанкам.
- Найдите текстовый чанк с ключевым словом
openbadges. - Прочитайте нагрузку. Если это JSON — разберите его. Если URL — загрузите по нему данные.
- Убедитесь, что assertion ссылается на ожидаемые класс значка и издателя и что идентификатор получателя совпадает с человеком, который его предъявляет.
- Если тип верификации —
hosted, подтвердите, что размещённый assertion по-прежнему существует по своему URLidи не был отозван и не истёк.
Шаг 5 пропускают чаще всего, и именно он делает credential заслуживающим доверия. Встроенная копия — это снимок. Источник истины — размещённая запись.
Читаем самостоятельно в Node
Любой PNG можно изучить коротким скриптом. Этот проходит по чанкам и выводит нагрузку 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». Это учебный инструмент, а не полноценный валидатор: он не проверяет контрольные суммы чанков, не разбирает подписанные нагрузки и не загружает размещённую запись.
Если не хочется писать код, тот же чанк покажет онлайн-валидатор значков или просмотрщик метаданных PNG. Формат стандартизирован, поэтому любой совместимый инструмент читает любой совместимый значок.
Почему baking важен
Переносимость. Credential, который представляет собой просто PNG, можно отправить по email, загрузить на обучающую платформу или сохранить в личном архиве. Для этого не нужна учётная запись.
Путь верификации, переживающий маркетинговый сайт издателя. Встроенный assertion называет издателя и указывает на размещённую запись, так что верификатор может начать с одного лишь файла.
Офлайн и low-tech сценарии. Когда нагрузка — полный JSON, читатель может проверить утверждение на машине без сети, а размещённую запись верифицировать позже.
Доказательство, которое трудно подделать между делом. Скриншот может сделать кто угодно. У скриншота нет метаданных, поэтому его нельзя верифицировать как файл значка. Уже одно это отличает настоящий credential от скопированной картинки. Но это не мешает запечь поддельный assertion в украденную картинку — вот почему существует шаг проверки размещённой записи.
Ограничения baking
Будьте честны с получателями на этот счёт, ведь это влияет на то, как вы описываете свои credentials.
- Метаданные удаляются. Многие социальные сети, оптимизаторы изображений и мессенджеры перекодируют загрузки и отбрасывают чанки, не содержащие пикселей. Запечённый значок, опубликованный в соцсети, обычно уже не запечён. Это ожидаемо, и поэтому рядом с файлом важна публичная ссылка для верификации.
- Baking сам по себе — не доказательство. Встроенный JSON может написать кто угодно. Доверие даёт размещённый assertion на домене издателя или действительная подпись.
- Правки изображения рвут связь. Изменение размера или пересохранение в редакторе может уничтожить чанк.
- Только PNG и SVG. В спецификации для JPEG нет аналогичного соглашения о чанках, поэтому значок в стиле фотографии, экспортированный в JPEG, нельзя запечь стандартным способом.
Практический вывод: считайте запечённый файл удобным носителем, а страницу верификации — источником авторитета. Если вы выбираете форматы для своей программы, статья Open Badges vs PDF-сертификаты объясняет, почему машиночитаемый credential лучше статичного документа.
Как baking работает на https://badges.ninja
Когда вы награждаете значком на https://badges.ninja, платформа формирует assertion Open Badge для этого получателя и запекает его в изображение значка в процессе выдачи. Вам не нужно настраивать инструмент или запускать команды. Порядок действий:
- Вы создаёте значок в визуальном дизайнере или загружаете собственное изображение.
- Вы выдаёте награду: из панели управления, из загруженного CSV для массовой выдачи или через API.
- Платформа создаёт assertion, запекает его в PNG и сохраняет результат вместе с наградой.
- Получатель получает публичную страницу верификации по адресу
https://badges.ninja/awards/<awardId>, PDF-сертификат, QR-код и опцию «Добавить в LinkedIn».
Если в дизайне значка используются поля слияния, например имя получателя, то каждая награда получает персонализированное изображение — и запекается именно оно.
Baking считается улучшением выдачи, а не обязательным условием: если конкретное изображение запечь нельзя (например, вырожденное изображение-заглушку), награда всё равно выдаётся с исходным изображением, а публичная страница верификации и Open Badge JSON-LD остаются нетронутыми. Загружаемое изображение также должно соответствовать минимальному размеру, поэтому крошечный пустой холст отклоняется ещё до того, как попадёт в «пекарню».
Поскольку авторитетом служит публичная страница, любой может проверить награду без регистрации. Машиночитаемый Open Badge v2.0 JSON-LD награды доступен по адресу https://api.badges.ninja/certify-badge/award/<awardId>.
Выдача одной награды через API
Большинство читателей будут пользоваться панелью управления, но если вы автоматизируете выдачу, один запрос создаёт награду (запечённое изображение прилагается). Подставьте свой ключ и идентификатор значка:
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 верификации из этого идентификатора. О настройке ключа и полном справочнике запросов см. документацию Awards API и руководство по аутентификации.

Практические советы для издателей
Всегда публикуйте ссылку на верификацию рядом с файлом. Помещайте ссылку в письмо о награде, на сертификат и на любую страницу, где отображается значок. Поскольку соцсети удаляют метаданные, именно ссылка сохраняет credential проверяемым после того, как им поделились.
Используйте чистое исходное изображение приличного размера. Начинайте с PNG с реальными размерами. Значок, сделанный дизайнером в обычном разрешении, запекается надёжно; заглушка в 1 пиксель — нет.
Не редактируйте выданный файл. Скажите получателям делиться оригинальным скачанным файлом или ссылкой на верификацию, а не обрезанным скриншотом.
Решите, что вы скажете об отзыве и сроке действия. Поскольку авторитетна размещённая запись, запечённый файл может пережить статус credential. Скажите об этом ясно в документации программы, чтобы работодатели знали: нужно проверять страницу верификации, а не доверять одному файлу.
Протестируйте один значок от начала до конца. Выдайте награду себе, скачайте PNG, прогоните его через скрипт выше или публичный валидатор и откройте ссылку верификации. Пять минут тестирования покажут, с чем столкнутся ваши получатели.

Часто задаваемые вопросы
Запечённый значок — то же самое, что цифровой сертификат? Нет. Сертификат обычно представляет собой PDF для чтения и печати. Запечённый значок — это изображение, которое ещё и несёт машиночитаемые данные credential. https://badges.ninja создаёт оба из одной награды.
Можно ли запечь значок без платформы? Да. Спецификация открыта, и для нескольких языков есть библиотеки. Сложнее разместить assertion по стабильному URL — именно это делает верификацию осмысленной. Эту часть платформа берёт на себя.
Раскрывает ли baking email получателя? Нет, если идентификатор хеширован. Assertion хранит хеш с солью, поэтому файл не раскрывает адрес.
Прочитает ли LinkedIn запечённые данные? Процесс «Добавить в профиль» в LinkedIn работает с названием credential, издателем, датой и URL, а не с метаданными файла. См. добавление кнопки «Добавить в LinkedIn».
Итог
Запечённый Open Badge — это PNG (или SVG), в который credential записан в текстовый чанк с именем openbadges. Он делает значок переносимым и самоописывающимся, но настоящее доверие даёт размещённый assertion на домене издателя. Запекайте ради переносимости, публикуйте ссылку на верификацию ради доверия и ожидайте, что соцсети удалят метаданные.
Готовы выдать свой первый проверяемый credential? Начните бесплатно на badges.ninja — визуальный дизайнер, публичная страница верификации, PDF-сертификат, вывод в формате Open Badge v2.0. Кредитная карта не нужна.
Как создана эта статья
Некоторые статьи в этом блоге готовятся с помощью ИИ-ассистента, а затем проверяются, сверяются с фактами и редактируются командой Badges Ninja перед публикацией. Каждый пример кода и цена проверены на актуальном продукте. Подробнее о нашем редакционном процессе и работе с ИИ читайте на странице редакционного процесса .

Об авторе
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 для буткемпов по программированию: проверяемые credentials в масштабе потока19 нояб. 2026 г. · 10мин чтения
- Настройка вебхуков для событий бейджей: интеграция с вашим бэкендом в реальном времени16 нояб. 2026 г. · 8мин чтения
- Срок действия и продление Open Badges: управление жизненным циклом ограниченных по времени credentials12 нояб. 2026 г. · 10мин чтения


