อธิบาย Open Badge Baking: JSON ฝังอยู่ในไฟล์ PNG ได้อย่างไร

Open Badge แบบ “baked” คือไฟล์ PNG ที่ฝัง JSON ของ assertion ไว้เป็นเมทาดาทาของภาพ ไฟล์ตราสัญลักษณ์ก็คือหลักฐานรับรองนั่นเอง ดูว่า baking ทำงานอย่างไรและตรวจสอบ baked badge ได้อย่างไร

Nacho Coll โดย อัปเดตล่าสุด 5 นาทีอ่าน
Open Badge แบบ “baked” คือไฟล์ PNG ที่ฝัง JSON ของ assertion ไว้เป็นเมทาดาทาของภาพ ไฟล์ตราสัญลักษณ์ก็คือหลักฐานรับรองนั่นเอง ดูว่า baking ทำงานอย่างไรและตรวจสอบ baked badge ได้อย่างไร

ดาวน์โหลด Open Badge จากผู้ออกเกือบทุกรายแล้วคุณจะได้ไฟล์ PNG หน้าตาธรรมดา จะส่งในแชต แนบอีเมล หรือพิมพ์ออกมาก็ได้ ดูเหมือนรูปภาพทั่วไป แต่ไฟล์นี้มีอีกชั้นหนึ่งที่มองไม่เห็น คือตัวหลักฐานรับรองที่เขียนไว้ในภาพเป็นเมทาดาทา ชุมชน Open Badges เรียกสิ่งนี้ว่า baked badge และนี่คือเหตุผลที่ตราสัญลักษณ์เดินทางเป็นไฟล์เดียวได้ โดยยังพิสูจน์ได้ว่าใครเป็นผู้ออก ออกให้ใคร และเพื่ออะไร

คู่มือนี้อธิบายว่า baking คืออะไร ข้อมูลอยู่ตรงไหนในไฟล์ ผู้ตรวจสอบอ่านกลับมาอย่างไร และคุณในฐานะผู้ออกหลักฐานรับรองต้องตัดสินใจเรื่องอะไรบ้าง คุณไม่จำเป็นต้องเขียนโค้ดเพื่อใช้ baked badge หากออกผ่าน https://badges.ninja ระบบ baking ให้คุณโดยอัตโนมัติ แต่การเข้าใจกลไกจะช่วยให้คุณตอบคำถามที่ผู้รับและนายจ้างถามจริงๆ ได้ คือ “รูปนี้ของจริงไหม” และ “ใครจะคัดลอกไปก็ได้ใช่ไหม”

“Baking” หมายถึงอะไร

Open Badge ประกอบด้วยสองส่วนที่มักสับสนกัน

  • ภาพ ไฟล์ PNG หรือ SVG ที่ผู้คนเห็นบนโปรไฟล์ สไลด์ หรือใบรับรอง
  • Assertion เอกสาร JSON ขนาดเล็กที่ระบุข้อเท็จจริง ได้แก่ผู้รับคือใคร (ในรูปตัวระบุที่แฮชแล้ว) ได้รับ badge class ใด ใครเป็นผู้ออก ออกเมื่อไร และตรวจสอบได้ที่ไหน

Baking คือการเขียน assertion ลงในภาพเพื่อไม่ให้สองส่วนนี้แยกจากกันได้ ผลลัพธ์คือไฟล์เดียว ส่งไฟล์ PNG ให้ใครสักคนก็เท่ากับส่งทั้งภาพและข้อกล่าวอ้างที่อยู่เบื้องหลังให้เขา

แนวคิดนี้มาจากข้อกำหนด Open Badges ซึ่ง Mozilla พัฒนาขึ้นแต่แรกและปัจจุบัน 1EdTech ดูแลต่อ หัวใจของการออกแบบคือการพกพาได้ ในยุคแรกตราสัญลักษณ์อยู่ภายในแพลตฟอร์มเดียว การย้ายไปที่ใหม่ต้องอัปโหลดซ้ำแล้วภาวนาให้เมทาดาทารอดมาได้ ไฟล์ที่ baked แล้วพกเมทาดาทาของตัวเองไปได้ทุกที่

JSON อยู่ตรงไหนในไฟล์ PNG

ไฟล์ PNG คือลายเซ็นสั้นๆ ตามด้วยลำดับของ chunk แต่ละ chunk มีความยาว ชนิดสี่ตัวอักษร ข้อมูล และค่าตรวจสอบ โปรแกรมดูภาพวาดพิกเซลจาก chunk IDAT และข้าม chunk ชนิดที่ไม่เข้าใจ ความยืดหยุ่นนี้เองที่ทำให้ baking เป็นไปได้ คุณเพิ่ม chunk ที่เต็มไปด้วยข้อความได้ และโปรแกรมดูภาพทั่วโลกก็ยังแสดงภาพตามปกติ

สำหรับ Open Badges 2.0 assertion จะอยู่ใน text chunk ที่มีคีย์เวิร์ด openbadges ชนิดของ text chunk ที่ใช้เก็บได้มีดังนี้

Chunkการเข้ารหัสหมายเหตุ
tEXtLatin-1เรียบง่าย แต่จำกัดเฉพาะอักขระ Latin-1
iTXtUTF-8แนะนำ เพราะชื่อและคำอธิบายมักไม่ใช่ ASCII

ไม่ว่าจะใช้ chunk ใด โครงสร้างก็เหมือนกัน คือคีย์เวิร์ด openbadges ตัวคั่น แล้วจึงเป็นเพย์โหลด เพย์โหลดมีสองแบบ ขึ้นอยู่กับวิธีที่ผู้ออกเลือก bake

  1. ตัว assertion JSON เอง ไฟล์อธิบายตัวเองได้ ผู้ตรวจสอบอ่านข้อกล่าวอ้างได้โดยไม่ต้องเรียกเครือข่าย
  2. URL ที่ชี้ไปยัง assertion ที่โฮสต์ไว้ ไฟล์เล็กลง และผู้ออกยังคงให้ระเบียนจริงเป็นฉบับที่เชื่อถือได้ เช่น เพื่อแสดงว่า badge ถูกเพิกถอนหรือหมดอายุภายหลัง

มีแบบที่สามสำหรับ badge ที่ลงลายเซ็น ซึ่งเพย์โหลดเป็นโทเค็นที่ลงลายเซ็นแทน JSON ธรรมดา หากลายเซ็นสำคัญต่อกรณีใช้งานของคุณ อ่าน how to verify an Open Badge signature

แล้ว SVG ล่ะ

badge แบบ SVG ก็ bake ได้เช่นกัน เพราะ SVG คือ XML โดย assertion จะอยู่ในองค์ประกอบ namespace openbadges XML ภายในไฟล์ และแอตทริบิวต์ verify เก็บ URL ของ assertion ที่โฮสต์ไว้ หลักการเหมือนกับ PNG คือเมทาดาทาเดินทางอยู่ในไฟล์ภาพ ในทางปฏิบัติแพลตฟอร์มส่วนใหญ่ bake เป็น PNG เพราะ PNG ได้รับการยอมรับเกือบทุกที่ที่ผู้คนต้องการอัปโหลด badge

หน้าตาของ assertion ที่ฝังอยู่

สำหรับรูปแบบ 2.0 assertion ที่โฮสต์ไว้คือ JSON-LD ที่เชื่อมผู้รับ badge class และวิธีตรวจสอบเข้าด้วยกัน ตัวอย่างแบบตัดทอน

{
  "@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 ได้ ดังนั้น assertion ต้องไม่เปิดเผยที่อยู่อีเมลของผู้รับ ผู้ตรวจสอบที่รู้อีเมลอยู่แล้วสามารถแฮชด้วย salt เดียวกันและตรวจว่าตรงกันหรือไม่ หากต้องการดูเอกสารนี้ทีละฟิลด์ ดู Open Badge JSON-LD walkthrough

ผู้ตรวจสอบอ่าน baked badge อย่างไร

การตรวจสอบ baked badge เป็นกระบวนการสั้นๆ ที่ทำตามขั้นตอนได้

  1. เปิดไฟล์ PNG แล้วไล่ดู chunk
  2. หา text chunk ที่มีคีย์เวิร์ด openbadges
  3. อ่านเพย์โหลด ถ้าเป็น JSON ให้แยกวิเคราะห์ ถ้าเป็น URL ให้ดึงข้อมูลมา
  4. ตรวจว่า assertion อ้างถึง badge class และผู้ออกที่คุณคาดหวัง และตัวตนของผู้รับตรงกับบุคคลที่นำมาแสดง
  5. หากชนิดการตรวจสอบคือ hosted ให้ยืนยันว่า assertion ที่โฮสต์ไว้ยังคงอยู่ที่ URL id ของมัน และยังไม่ถูกเพิกถอนหรือหมดอายุ

ขั้นตอนที่ 5 คือขั้นที่คนมักข้าม และเป็นขั้นที่ทำให้หลักฐานรับรองน่าเชื่อถือ สำเนาที่ฝังไว้เป็นเพียงภาพถ่ายชั่วขณะ ระเบียนที่โฮสต์ไว้คือแหล่งความจริง

อ่านเองด้วย Node

คุณตรวจสอบ PNG ใดๆ ได้ด้วยสคริปต์สั้นๆ สคริปต์นี้ไล่ดู chunk และพิมพ์เพย์โหลด 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 หากไฟล์ถูก bake ไว้ คุณจะเห็น JSON หรือ URL หากไม่ ก็จะได้ข้อความ “not baked” ธรรมดา นี่เป็นเครื่องมือสำหรับการเรียนรู้ ไม่ใช่ตัวตรวจสอบเต็มรูปแบบ เพราะไม่ได้ตรวจค่าตรวจสอบของ chunk ไม่ได้แยกวิเคราะห์เพย์โหลดที่ลงลายเซ็น และไม่ได้ดึงระเบียนที่โฮสต์ไว้

หากไม่อยากเขียนโค้ด ตัวตรวจสอบ badge ออนไลน์หรือโปรแกรมดูเมทาดาทา PNG ก็แสดง chunk เดียวกันได้ รูปแบบนี้เป็นมาตรฐาน เครื่องมือที่ปฏิบัติตามมาตรฐานทุกตัวจึงอ่าน badge ที่ปฏิบัติตามมาตรฐานได้ทุกอัน

ทำไม baking จึงสำคัญ

พกพาได้ หลักฐานรับรองที่เป็นเพียงไฟล์ PNG ส่งทางอีเมล อัปโหลดขึ้นแพลตฟอร์มการเรียนรู้ หรือเก็บในคลังส่วนตัวได้ ไม่ต้องมีบัญชีเพื่อพกพามัน

เส้นทางการตรวจสอบที่อยู่รอดแม้เว็บไซต์การตลาดของผู้ออกหายไป assertion ที่ฝังไว้ระบุผู้ออกและชี้ไปยังระเบียนที่โฮสต์ไว้ ผู้ตรวจสอบจึงเริ่มจากไฟล์เพียงอย่างเดียวได้

เวิร์กโฟลว์ออฟไลน์และเทคโนโลยีต่ำ เมื่อเพย์โหลดเป็น JSON เต็ม ผู้อ่านตรวจข้อกล่าวอ้างบนเครื่องที่ไม่มีเครือข่ายได้ แล้วค่อยตรวจระเบียนที่โฮสต์ไว้ภายหลัง

หลักฐานที่ปลอมแบบง่ายๆ ได้ยาก ใครๆ ก็แคปหน้าจอ badge ได้ แต่ภาพแคปหน้าจอไม่มีเมทาดาทา จึงตรวจสอบเป็นไฟล์ badge ไม่ได้ เพียงเท่านี้ก็แยกหลักฐานรับรองจริงออกจากภาพที่ถูกคัดลอกแล้ว แต่ไม่ได้หยุดคนที่ bake assertion ปลอมลงในภาพที่ขโมยมา นั่นคือเหตุผลที่มีขั้นตอนตรวจสอบกับระเบียนที่โฮสต์ไว้

ข้อจำกัดของ baking

พูดตรงๆ กับผู้รับของคุณเรื่องเหล่านี้ เพราะมีผลต่อวิธีที่คุณอธิบายหลักฐานรับรองของคุณ

  • เมทาดาทาถูกลบ โซเชียลเน็ตเวิร์ก เครื่องมือบีบอัดภาพ และแอปส่งข้อความจำนวนมากเข้ารหัสไฟล์ที่อัปโหลดใหม่และทิ้ง chunk ที่ไม่ใช่พิกเซล baked badge ที่โพสต์บนฟีดโซเชียลมักไม่ได้ถูก bake อีกต่อไป นี่เป็นเรื่องที่คาดไว้ และเป็นเหตุผลที่ลิงก์ตรวจสอบสาธารณะสำคัญควบคู่กับไฟล์
  • Baking ไม่ใช่หลักฐานในตัวเอง ใครก็เขียน JSON ที่ฝังได้ ความน่าเชื่อถือมาจาก assertion ที่โฮสต์บนโดเมนของผู้ออก หรือจากลายเซ็นที่ถูกต้อง
  • การแก้ไขภาพทำให้ลิงก์ขาด การปรับขนาดหรือบันทึกใหม่ในโปรแกรมแก้ไขอาจทำให้ chunk หายไป
  • เฉพาะ PNG และ SVG JPEG ไม่มีข้อตกลงเรื่อง chunk ที่เทียบเท่าในข้อกำหนด badge สไตล์ภาพถ่ายที่ส่งออกเป็น JPEG จึง bake ตามวิธีมาตรฐานไม่ได้

ข้อสรุปเชิงปฏิบัติ ให้ถือไฟล์ที่ bake เป็นพาหะที่สะดวก และถือหน้าตรวจสอบเป็นผู้มีอำนาจตัดสิน หากคุณกำลังชั่งน้ำหนักรูปแบบสำหรับโปรแกรมของคุณ Open Badges vs PDF certificates อธิบายว่าทำไมหลักฐานรับรองที่เครื่องอ่านได้จึงดีกว่าเอกสารนิ่งๆ

baking ทำงานอย่างไรบน https://badges.ninja

เมื่อคุณมอบ badge บน https://badges.ninja แพลตฟอร์มจะสร้าง assertion ของ Open Badge สำหรับผู้รับรายนั้นและ bake ลงในภาพ badge เป็นส่วนหนึ่งของการออก คุณไม่ต้องตั้งค่าเครื่องมือหรือรันคำสั่งใดๆ ขั้นตอนมีดังนี้

  1. คุณออกแบบ badge ในตัวออกแบบแบบภาพ หรืออัปโหลดภาพของคุณเอง
  2. คุณออกรางวัลจากแดชบอร์ด จากการอัปโหลด CSV สำหรับรางวัลจำนวนมาก หรือผ่าน API
  3. แพลตฟอร์มสร้าง assertion bake ลงใน PNG และเก็บผลลัพธ์ไว้กับรางวัล
  4. ผู้รับได้หน้าตรวจสอบสาธารณะที่ https://badges.ninja/awards/<awardId> ใบรับรอง PDF คิวอาร์โค้ด และตัวเลือก Add to LinkedIn

หากการออกแบบ badge ใช้ฟิลด์ผสาน เช่นชื่อของผู้รับ รางวัลแต่ละรายการจะได้ภาพเฉพาะบุคคล และภาพเฉพาะบุคคลนั้นคือภาพที่ถูก bake

Baking ถือเป็นส่วนเสริมของการออก ไม่ใช่ด่านกั้น หากภาพใดภาพหนึ่ง bake ไม่ได้ (เช่นภาพตัวแทนที่เสียรูป) รางวัลก็ยังออกโดยใช้ภาพต้นฉบับ และหน้าตรวจสอบสาธารณะกับ Open Badge JSON-LD ไม่ได้รับผลกระทบ ภาพที่คุณอัปโหลดต้องผ่านขนาดขั้นต่ำด้วย ผืนผ้าใบเปล่าขนาดจิ๋วจึงถูกปฏิเสธก่อนไปถึงขั้นตอน bake

เพราะหน้าสาธารณะคือผู้มีอำนาจตัดสิน ใครๆ ก็ตรวจรางวัลได้โดยไม่ต้องสมัคร Open Badge v2.0 JSON-LD ที่เครื่องอ่านได้ของรางวัลมีให้ที่ https://api.badges.ninja/certify-badge/award/<awardId>

ออกรางวัลหนึ่งรายการผ่าน API

ผู้อ่านส่วนใหญ่จะใช้แดชบอร์ด แต่หากคุณทำการออกแบบอัตโนมัติ คำขอเดียวก็สร้างรางวัลได้ (และภาพที่ bake แล้วมาพร้อมกัน) แทนที่คีย์และ badge 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 docs และ authentication guide

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

คำแนะนำเชิงปฏิบัติสำหรับผู้ออก

เผยแพร่ลิงก์ตรวจสอบไว้ข้างไฟล์เสมอ ใส่ลิงก์ในอีเมลรางวัล บนใบรับรอง และบนทุกหน้าที่แสดง badge เพราะแพลตฟอร์มโซเชียลลบเมทาดาทา ลิงก์จึงเป็นสิ่งที่ทำให้หลักฐานรับรองตรวจสอบได้หลังการแชร์

ใช้ภาพต้นฉบับที่สะอาดและมีขนาดพอ เริ่มจาก PNG ที่มีมิติจริง badge ที่นักออกแบบทำด้วยความละเอียดปกติ bake ได้อย่างเชื่อถือได้ ภาพตัวแทนขนาด 1 พิกเซลทำไม่ได้

อย่าแก้ไขไฟล์ที่ส่งมอบ บอกผู้รับให้แชร์ไฟล์ที่ดาวน์โหลดมาต้นฉบับหรือลิงก์ตรวจสอบ ไม่ใช่ภาพแคปหน้าจอที่ครอบตัดแล้ว

ตัดสินใจว่าจะพูดอย่างไรเรื่องการเพิกถอนและการหมดอายุ เพราะระเบียนที่โฮสต์ไว้เป็นฉบับที่เชื่อถือได้ ไฟล์ที่ bake จึงอาจอยู่นานกว่าสถานะของหลักฐานรับรอง ระบุเรื่องนี้ให้ชัดในเอกสารของโปรแกรมเพื่อให้นายจ้างรู้ว่าต้องตรวจหน้าตรวจสอบ แทนที่จะเชื่อไฟล์เพียงอย่างเดียว

ทดสอบ badge หนึ่งอันตั้งแต่ต้นจนจบ ออกรางวัลให้ตัวเอง ดาวน์โหลด PNG รันผ่านสคริปต์ข้างต้นหรือตัวตรวจสอบสาธารณะ แล้วเปิดลิงก์ตรวจสอบ ห้านาทีของการทดสอบบอกคุณว่าผู้รับของคุณจะได้รับประสบการณ์แบบไหน

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

คำถามที่พบบ่อย

baked badge เหมือนกับใบรับรองดิจิทัลไหม ไม่ ใบรับรองมักเป็น PDF สำหรับอ่านและพิมพ์ ส่วน baked badge เป็นภาพที่พกข้อมูลหลักฐานรับรองที่เครื่องอ่านได้ด้วย https://badges.ninja สร้างได้ทั้งสองอย่างจากรางวัลเดียวกัน

bake badge โดยไม่ใช้แพลตฟอร์มได้ไหม ได้ ข้อกำหนดเปิดเผยและมีไลบรารีสำหรับหลายภาษา ส่วนที่ยากกว่าคือการโฮสต์ assertion ที่ URL ที่คงที่ ซึ่งทำให้การตรวจสอบมีความหมาย นั่นคือส่วนที่แพลตฟอร์มจัดการให้คุณ

baking เปิดเผยอีเมลของผู้รับไหม ไม่ เมื่อตัวตนถูกแฮช assertion เก็บแฮชที่มี salt ไฟล์จึงไม่เผยที่อยู่อีเมล

LinkedIn อ่านข้อมูลที่ bake ไว้ไหม ขั้นตอน Add to Profile ของ LinkedIn ทำงานจากชื่อหลักฐานรับรอง ผู้ออก วันที่ และ URL ไม่ใช่จากเมทาดาทาของไฟล์ ดู adding an Add to LinkedIn button

สรุป

Open Badge ที่ bake คือ PNG (หรือ SVG) ที่เขียนหลักฐานรับรองไว้ใน text chunk ชื่อ openbadges ทำให้ badge พกพาได้และอธิบายตัวเองได้ แต่ความน่าเชื่อถือจริงมาจาก assertion ที่โฮสต์บนโดเมนของผู้ออก Bake เพื่อการพกพา เผยแพร่ลิงก์ตรวจสอบเพื่อความน่าเชื่อถือ และคาดไว้ได้เลยว่าโซเชียลเน็ตเวิร์กจะลบเมทาดาทา

พร้อมออกหลักฐานรับรองที่ตรวจสอบได้ชิ้นแรกของคุณหรือยัง เริ่มฟรีที่ badges.ninja — ตัวออกแบบแบบภาพ หน้าตรวจสอบสาธารณะ ใบรับรอง PDF เอาต์พุต Open Badge v2.0 ไม่ต้องใช้บัตรเครดิต

กลับไปที่บล็อก

บทความที่เกี่ยวข้อง