Запікання Open Badge: як JSON живе всередині PNG

«Запечений» Open Badge — це PNG із JSON-асерцією, вбудованим як метадані зображення. Файл значка І Є посвідченням. Як працює запікання і як верифікувати запечений значок.

Nacho Coll Автор Оновлено 10 хв читання
«Запечений» Open Badge — це PNG із JSON-асерцією, вбудованим як метадані зображення. Файл значка І Є посвідченням. Як працює запікання і як верифікувати запечений значок.

Завантажте Open Badge майже від будь-якого емітента — і ви отримаєте звичайний на вигляд PNG. Киньте його в чат, додайте до листа, роздрукуйте. Він виглядає як будь-яке інше зображення. Але файл несе другий, невидимий шар: саме посвідчення, записане в зображення як метадані. Спільнота Open Badges називає це запеченим значком (baked badge), і саме завдяки цьому значок може подорожувати одним файлом і все одно доводити, хто його видав, кому і за що.

Цей посібник пояснює, що таке запікання, де всередині файлу лежать дані, як верифікатор зчитує їх назад і що вам потрібно вирішити як тому, хто видає посвідчення. Вам не потрібно писати код, щоб користуватися запеченими значками. Якщо ви видаєте їх через https://badges.ninja, запікання відбувається за вас. Але розуміння механіки допомагає відповідати на запитання, які насправді ставлять отримувачі та роботодавці: «Це зображення справжнє?» і «Хіба його не можна просто скопіювати?»

Що означає «запікання»

Open Badge має дві частини, які легко сплутати:

  • Зображення. PNG або SVG, яке люди бачать у профілі, на слайді чи сертифікаті.
  • Асерція. Невеликий JSON-документ, що фіксує факти: хто отримувач (як хешований ідентифікатор), який клас значка здобуто, хто видав, коли і де це верифікувати.

Запікання — це запис асерції в зображення так, щоб їх не можна було розділити. Результат — один файл. Передаючи комусь PNG, ви передаєте і зображення, і твердження, що за ним стоїть.

Ідея походить зі специфікації Open Badges, яку спочатку розробила Mozilla, а нині підтримує 1EdTech. Суть задуму — переносимість. Спочатку значки жили всередині однієї платформи, і перенесення в інше місце означало повторне завантаження та надію, що метадані вціліють. Запечений файл несе свої метадані з собою куди завгодно.

Де в PNG лежить JSON

Файл PNG — це короткий підпис, за яким іде послідовність чанків. Кожен чанк має довжину, чотирилітерний тип, дані та контрольну суму. Програми перегляду малюють пікселі з чанків IDAT і ігнорують типи чанків, яких не розуміють. Саме ця толерантність робить запікання можливим: ви можете додати чанк, повний тексту, і кожна програма перегляду у світі все одно покаже зображення як звичайно.

Для Open Badges 2.0 асерція потрапляє в текстовий чанк із ключовим словом openbadges. Типи текстових чанків, які можуть її вмістити:

ChunkКодуванняПримітки
tEXtLatin-1Простий, але обмежений символами Latin-1.
iTXtUTF-8Кращий, бо імена й описи часто не є ASCII.

Який би чанк не використовувався, структура та сама: ключове слово openbadges, роздільник, потім вміст. Вміст буває одним із двох видів, залежно від того, як емітент вирішив запекти:

  1. Сам JSON асерції. Файл самодостатній. Верифікатор може прочитати твердження без жодного мережевого виклику.
  2. URL, що вказує на розміщену асерцію. Файл менший, а емітент може залишити живий запис авторитетним, наприклад щоб показати, що значок пізніше було відкликано або його термін минув.

Існує й третій варіант для підписаних значків, де вмістом є підписаний токен замість звичайного JSON. Якщо підписи важливі у вашому випадку, прочитайте як верифікувати підпис Open Badge.

А як щодо SVG?

SVG-значки теж можна запікати, адже SVG — це XML. Асерцію розміщують усередині файлу в елементі простору імен XML openbadges, а атрибут verify містить URL розміщеної асерції. Принцип той самий, що й для PNG: метадані їдуть усередині файлу зображення. На практиці більшість платформ запікає PNG, бо PNG приймають майже всюди, де люди хочуть завантажити значок.

Як виглядає вбудована асерція

Для формату 2.0 розміщена асерція — це 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 із сіллю. Це важливо для файлу, призначеного для розповсюдження. Будь-хто, хто має PNG, може прочитати асерцію, тож вона не повинна розкривати адресу отримувача. Верифікатор, який уже знає адресу, може захешувати її з тією самою сіллю й перевірити збіг. Покрокове знайомство з кожним полем цього документа — в розборі JSON-LD для Open Badge.

Як верифікатор зчитує запечений значок

Верифікація запеченого значка — це короткий механічний процес:

  1. Відкрийте PNG і пройдіться по його чанках.
  2. Знайдіть текстовий чанк із ключовим словом openbadges.
  3. Прочитайте вміст. Якщо це JSON — розберіть його. Якщо це URL — завантажте його.
  4. Перевірте, що асерція посилається на очікуваний вами клас значка й емітента, а ідентичність отримувача збігається з особою, яка його пред’являє.
  5. Якщо тип верифікації — hosted, переконайтеся, що розміщена асерція все ще існує за URL у полі id і не була відкликана чи не прострочена.

Крок 5 люди пропускають, а саме він робить посвідчення вартим довіри. Вбудована копія — це знімок. Джерело істини — розміщений запис.

Зчитування самостійно в 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 покаже той самий чанк. Формат є стандартом, тож будь-який сумісний інструмент прочитає будь-який сумісний значок.

Чому запікання важливе

Переносимість. Посвідчення, що є просто PNG, можна надіслати поштою, завантажити на навчальну платформу або зберегти в особистому архіві. Для його перенесення не потрібен акаунт.

Шлях верифікації, що переживе маркетинговий сайт емітента. Вбудована асерція називає емітента й вказує на розміщений запис, тож верифікатор може почати лише з файлу.

Офлайн і низькотехнологічні процеси. Коли вмістом є повний JSON, читач може перевірити твердження на машині без мережі, а розміщений запис верифікувати пізніше.

Докази, які важко підробити нашвидкуруч. Будь-хто може зробити скриншот значка. У скриншота немає метаданих, тож його не можна верифікувати як файл значка. Уже це відрізняє справжнє посвідчення від скопійованого зображення. Але це не заважає запекти підроблену асерцію в украдене зображення, і саме тому існує крок верифікації розміщеного запису.

Обмеження запікання

Будьте чесними з отримувачами щодо цього, бо це впливає на те, як ви описуєте свої посвідчення.

  • Метадані видаляються. Багато соціальних мереж, оптимізаторів зображень і месенджерів перекодовують завантажені файли й відкидають чанки, що не є пікселями. Запечений значок, опублікований у стрічці соцмережі, зазвичай більше не запечений. Це очікувано, і саме тому поряд із файлом важливе публічне посилання для верифікації.
  • Запікання саме по собі не є доказом. Вбудований JSON може написати будь-хто. Довіра походить від розміщеної асерції на домені емітента або від чинного підпису.
  • Редагування зображення розриває зв’язок. Зміна розміру чи повторне збереження в редакторі може втратити чанк.
  • Лише PNG і SVG. У JPEG у специфікації немає еквівалентної конвенції чанків, тож значок у стилі фото, експортований у JPEG, не можна запекти стандартним способом.

Практичний висновок: сприймайте запечений файл як зручний носій, а сторінку верифікації — як авторитет. Якщо ви обираєте формати для своєї програми, Open Badges проти сертифікатів PDF пояснює, чому машиночитне посвідчення краще за статичний документ.

Як працює запікання на https://badges.ninja

Коли ви нагороджуєте значком на https://badges.ninja, платформа будує асерцію Open Badge для цього отримувача й запікає її в зображення значка під час видачі. Вам не потрібно налаштовувати інструмент чи запускати команду. Процес:

  1. Ви створюєте дизайн значка у візуальному дизайнері або завантажуєте власне зображення.
  2. Ви видаєте нагороду: з панелі, із завантаженого CSV для масових нагород або через API.
  3. Платформа створює асерцію, запікає її в PNG і зберігає результат разом із нагородою.
  4. Отримувач отримує публічну сторінку верифікації за адресою https://badges.ninja/awards/<awardId>, сертифікат PDF, QR-код і опцію «Додати до LinkedIn».

Якщо дизайн значка використовує поля злиття, як-от ім’я отримувача, кожна нагорода отримує персоналізоване зображення, і саме це персоналізоване зображення запікається.

Запікання вважається покращенням видачі, а не бар’єром: якщо певне зображення не вдається запекти (наприклад, вироджене зображення-заглушку), нагороду все одно буде видано з оригінальним зображенням, а публічна сторінка верифікації та JSON-LD Open Badge не постраждають. Завантажуване зображення також має відповідати мінімальному розміру, тож крихітне порожнє полотно відхиляється ще до потрапляння в пекарню.

Оскільки авторитетом є публічна сторінка, будь-хто може перевірити нагороду без реєстрації. Машиночитний JSON-LD Open Badge v2.0 для нагороди доступний за адресою 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 для верифікації. Про налаштування ключа та повний довідник запитів дивіться в документації API нагород і посібнику з автентифікації.

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

Практичні поради для емітентів

Завжди публікуйте посилання для верифікації поруч із файлом. Розмістіть посилання в листі про нагороду, на сертифікаті й на будь-якій сторінці, де показано значок. Оскільки соціальні платформи видаляють метадані, саме посилання зберігає верифікованість посвідчення після поширення.

Використовуйте чисте вихідне зображення пристойного розміру. Починайте з PNG зі справжніми розмірами. Значок, зроблений дизайнером у звичайній роздільності, запікається надійно; заглушка в 1 піксель — ні.

Не редагуйте виданий файл. Скажіть отримувачам ділитися оригінальним завантаженням або посиланням для верифікації, а не обрізаним скриншотом.

Вирішіть, що ви хочете сказати про відкликання й термін дії. Оскільки розміщений запис є авторитетним, запечений файл може пережити статус посвідчення. Чітко напишіть про це в документації програми, щоб роботодавці знали: слід перевіряти сторінку верифікації, а не довіряти самому лише файлу.

Протестуйте один значок від початку до кінця. Видайте нагороду собі, завантажте PNG, прогоніть його через скрипт вище або публічний валідатор і відкрийте посилання для верифікації. П’ять хвилин тестування покажуть, що побачать ваші отримувачі.

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

Поширені запитання

Чи запечений значок — це те саме, що цифровий сертифікат? Ні. Сертифікат — це зазвичай PDF для читання й друку. Запечений значок — це зображення, що несе ще й машиночитні дані посвідчення. https://badges.ninja створює обидва з однієї нагороди.

Чи можна запекти значок без платформи? Так. Специфікація відкрита, а бібліотеки існують для кількох мов. Складніше — розмістити асерцію за стабільним URL, адже саме це робить верифікацію змістовною. Цю частину платформа бере на себе.

Чи розкриває запікання електронну адресу отримувача? Ні, коли ідентичність хешована. Асерція зберігає хеш із сіллю, тож файл не розкриває адреси.

Чи прочитає LinkedIn запечені дані? Потік «Додати до профілю» LinkedIn працює з назви посвідчення, емітента, дати й URL, а не з метаданих файлу. Дивіться додавання кнопки «Додати до LinkedIn».

Підсумок

Запечений Open Badge — це PNG (або SVG) із посвідченням, записаним у текстовий чанк openbadges. Це робить значок переносимим і самоописовим, але справжня довіра походить від розміщеної асерції на домені емітента. Запікайте заради переносимості, публікуйте посилання для верифікації заради довіри й очікуйте, що соціальні мережі видалятимуть метадані.

Готові видати своє перше верифіковане посвідчення? Почніть безкоштовно на badges.ninja — візуальний дизайнер, публічна сторінка верифікації, сертифікат PDF, вивід Open Badge v2.0. Кредитна картка не потрібна.

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.

Назад до Блогу

Схожі статті