Open Badge 烘焙詳解:JSON 如何藏在 PNG 裡

「烘焙」後的 Open Badge 是一張 PNG 圖片,斷言 JSON 以影像中繼資料的形式嵌入其中。徽章檔案本身就是憑證。本文說明烘焙的原理,以及如何驗證烘焙後的徽章。

Nacho Coll 作者 更新於 18 分鐘閱讀
「烘焙」後的 Open Badge 是一張 PNG 圖片,斷言 JSON 以影像中繼資料的形式嵌入其中。徽章檔案本身就是憑證。本文說明烘焙的原理,以及如何驗證烘焙後的徽章。

從幾乎任何簽發者那裡下載一枚 Open Badge,你得到的都是一張看起來很普通的 PNG。把它丟進聊天視窗、附在電子郵件裡、印出來,它看起來和其他圖片沒有差別。但這個檔案還帶著第二層看不見的內容:憑證本身,以中繼資料的形式寫進了影像裡。這就是 Open Badges 社群所說的 烘焙徽章(baked badge),也正因如此,一枚徽章可以只靠一個檔案流通,同時仍能證明是誰、向誰、因何而簽發。

本指南會說明什麼是烘焙、資料在檔案的哪個位置、驗證方如何把它讀出來,以及身為憑證簽發者你需要做哪些決定。使用烘焙徽章並不需要寫程式。如果你透過 https://badges.ninja 簽發,烘焙會自動完成。但了解其中的機制,能幫你回答接收者和雇主真正會問的問題:「這張圖是真的嗎?」以及「別人能直接複製嗎?」

「烘焙」是什麼意思

一枚 Open Badge 由兩個部分組成,很容易混淆:

  • 圖片。 人們在個人檔案、簡報或證書上看到的 PNG 或 SVG。
  • 斷言。 一份小小的 JSON 文件,陳述事實:接收者是誰(以雜湊識別碼表示)、獲得了哪個徽章類別、由誰簽發、何時簽發,以及在哪裡驗證。

烘焙,就是把斷言寫進圖片裡,讓兩者無法分離。結果是一個檔案。把這張 PNG 交給別人,你就同時交出了圖片和它背後的聲明。

這個理念來自最初由 Mozilla 開發、現由 1EdTech 維護的 Open Badges 規範。其設計目標是可攜性。早期的徽章只存在於單一平台內,想把它搬到別處,就得重新上傳,還得祈禱中繼資料沒有遺失。烘焙後的檔案無論走到哪裡,都自帶中繼資料。

JSON 在 PNG 裡的什麼位置

PNG 檔案由一段簡短的簽章和一連串 資料區塊(chunk)組成。每個資料區塊包含長度、四個字母的類型、若干資料以及檢查碼。檢視器根據 IDAT 資料區塊繪製像素,並忽略它們不認識的資料區塊類型。正是這種寬容讓烘焙成為可能:你可以加入一個裝滿文字的資料區塊,而世界上所有影像檢視器依然會正常顯示這張圖片。

對於 Open Badges 2.0,斷言會寫入關鍵字為 openbadges 的文字資料區塊。可以承載它的文字資料區塊類型如下:

資料區塊編碼說明
tEXtLatin-1簡單,但僅限 Latin-1 字元。
iTXtUTF-8首選,因為姓名和描述往往不是 ASCII。

無論使用哪種資料區塊,結構都是一樣的:關鍵字 openbadges、一個分隔符號,然後是酬載。酬載是以下兩種之一,取決於簽發者選擇的烘焙方式:

  1. 斷言 JSON 本身。 檔案自帶說明。驗證方不需要任何網路請求就能讀取聲明。
  2. 指向託管斷言的 URL。 檔案更小,簽發者可以讓線上紀錄保持權威性,例如用來表明某枚徽章後來被撤銷或已過期。

對於帶簽章的徽章還有第三種變體,酬載是簽章權杖而非純 JSON。如果你的情境需要簽章,請閱讀 如何驗證 Open Badge 簽章。

SVG 呢?

SVG 徽章同樣可以烘焙,因為 SVG 就是 XML。斷言會放在檔案內的 openbadges XML 命名空間元素中,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 的人都能讀取斷言,所以斷言絕不能洩露接收者的電子郵件地址。已經知道電子郵件的驗證方,可以用同樣的鹽對其做雜湊,並檢查是否一致。想逐欄位了解這份文件,請參閱 Open Badge JSON-LD 逐步解析。

驗證方如何讀取烘焙徽章

驗證烘焙徽章是一個簡短而機械的過程:

  1. 開啟 PNG,走訪它的資料區塊。
  2. 找到關鍵字為 openbadges 的文字資料區塊。
  3. 讀取酬載。如果是 JSON,就解析它;如果是 URL,就去擷取它。
  4. 檢查斷言指向的徽章類別和簽發者是否符合預期,以及接收者身分是否與出示徽章的人一致。
  5. 如果驗證類型是 hosted,確認託管斷言在其 id URL 上仍然存在,且沒有被撤銷或過期。

第 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;如果沒有,則會得到一則簡單的「未烘焙」訊息。這是一個教學工具,而不是完整的驗證器:它不會檢查資料區塊檢查碼,不會解析帶簽章的酬載,也不會擷取託管紀錄。

如果你不想寫程式,線上徽章驗證器或 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 code,以及 Add to LinkedIn 選項。

如果徽章設計使用了合併欄位(例如接收者姓名),每次授予都會產生一張個人化圖片,而被烘焙的正是這張個人化圖片。

烘焙被視為簽發的加值功能,而不是門檻:如果某張圖片無法烘焙(例如一張退化的預留圖),授予仍會使用原始圖片簽發,公開驗證頁面和 Open Badge JSON-LD 不受影響。你上傳的圖片也必須達到最小尺寸,因此一塊極小的空白畫布會在到達烘焙環節之前就被拒絕。

由於公開頁面才是權威,任何人不需要註冊就能查驗一次授予。某次授予的機器可讀 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>" }。用這個 id 建構驗證 URL。金鑰設定和完整的請求參考,請參閱 Awards API 文件 和 身分驗證指南。

https://badges.ninja 後台中的徽章詳細資料頁面

給簽發者的實用建議

始終在檔案旁邊發佈驗證連結。 把連結放在授予郵件裡、證書上,以及任何展示該徽章的頁面上。由於社群平台會移除中繼資料,分享之後讓憑證依然可驗證的正是這個連結。

使用乾淨且尺寸足夠的來源圖。 從有真實尺寸的 PNG 開始。設計師製作的正常解析度徽章可以穩定烘焙;1 像素的預留圖則不行。

不要編輯交付的檔案。 告訴接收者分享原始下載檔案或驗證連結,而不是裁切過的截圖。

想清楚你要如何說明撤銷和過期。 因為託管紀錄才是權威,烘焙檔案可能比憑證本身的有效狀態存在得更久。請在專案文件中明確說明,讓雇主知道應當查看驗證頁面,而不是只信任檔案。

端到端測試一枚徽章。 給自己簽發一次授予,下載 PNG,用上面的腳本或公開驗證器檢查,並開啟驗證連結。五分鐘的測試就能讓你知道接收者會有怎樣的體驗。

https://badges.ninja 後台中的徽章列表

常見問題

烘焙徽章和數位證書是一回事嗎? 不是。證書通常是用於閱讀和列印的 PDF。烘焙徽章則是同時帶有機器可讀憑證資料的圖片。https://badges.ninja 能從同一次授予產生這兩者。

不用平台也能烘焙徽章嗎? 可以。規範是開放的,多種語言都有相應的函式庫。更困難的部分是把斷言託管在穩定的 URL 上,而這正是讓驗證有意義的關鍵。這部分由平台替你處理。

烘焙會暴露接收者的電子郵件嗎? 身分經過雜湊時不會。斷言儲存的是加鹽雜湊,因此檔案不會洩露電子郵件地址。

LinkedIn 會讀取烘焙資料嗎? LinkedIn 的 Add to Profile 流程依據的是憑證名稱、簽發者、日期和 URL,而不是檔案中繼資料。請參閱 新增 Add to 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.

返回部落格

相關文章