Giải thích Open Badge Baking: JSON nằm bên trong PNG như thế nào
Một Open Badge «baked» là một tệp PNG có JSON assertion được nhúng làm metadata của ảnh. Chính tệp huy hiệu là chứng chỉ. Cách baking hoạt động + cách xác minh huy hiệu đã baked.
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.
Tải một Open Badge từ gần như bất kỳ tổ chức cấp nào và bạn nhận được một tệp PNG trông rất bình thường. Thả vào cuộc trò chuyện, đính kèm email, in ra. Nó trông như mọi bức ảnh khác. Nhưng tệp này mang theo một lớp thứ hai vô hình: chính chứng chỉ, được ghi vào ảnh dưới dạng metadata. Cộng đồng Open Badges gọi đó là baked badge, và đó là lý do một huy hiệu có thể di chuyển chỉ như một tệp duy nhất mà vẫn chứng minh được ai cấp, cấp cho ai, và vì điều gì.
Hướng dẫn này giải thích baking là gì, dữ liệu nằm ở đâu trong tệp, bên xác minh đọc lại nó ra sao, và bạn cần quyết định điều gì khi là người cấp chứng chỉ. Bạn không cần viết code để dùng huy hiệu đã baked. Nếu bạn cấp qua https://badges.ninja, việc baking diễn ra tự động. Nhưng hiểu cơ chế sẽ giúp bạn trả lời những câu hỏi mà người nhận và nhà tuyển dụng thật sự hay hỏi: “Ảnh này có thật không?” và “Có ai đó chỉ cần sao chép nó là xong không?"
"Baking” nghĩa là gì
Một Open Badge có hai phần dễ bị nhầm lẫn:
- Hình ảnh. Tệp PNG hoặc SVG mà mọi người nhìn thấy trên hồ sơ, slide hoặc chứng chỉ.
- Assertion. Một tài liệu JSON nhỏ nêu các sự kiện: người nhận là ai (dưới dạng định danh đã băm), badge class nào đã đạt được, ai cấp, khi nào, và xác minh ở đâu.
Baking là hành động ghi assertion vào hình ảnh để hai thứ không thể tách rời. Kết quả là một tệp duy nhất. Đưa ai đó tệp PNG là bạn đã đưa cho họ cả hình ảnh lẫn tuyên bố đằng sau nó.
Ý tưởng này đến từ đặc tả Open Badges, ban đầu do Mozilla phát triển và hiện do 1EdTech duy trì. Điểm cốt lõi của thiết kế là tính di động. Thuở đầu, huy hiệu nằm trong một nền tảng duy nhất, và chuyển sang nơi mới nghĩa là tải lên lại và hy vọng metadata còn nguyên. Một tệp đã baked mang theo metadata của chính nó đến bất cứ nơi nào nó đi.
JSON nằm ở đâu bên trong PNG
Một tệp PNG là một chữ ký ngắn theo sau bởi một chuỗi các chunk. Mỗi chunk có độ dài, kiểu gồm bốn chữ cái, dữ liệu và checksum. Các trình xem vẽ điểm ảnh từ các chunk IDAT và bỏ qua những kiểu chunk mà chúng không hiểu. Chính sự khoan dung đó làm cho baking khả thi: bạn có thể thêm một chunk đầy văn bản và mọi trình xem ảnh trên thế giới vẫn hiển thị bức ảnh bình thường.
Với Open Badges 2.0, assertion được đặt vào một chunk văn bản có từ khóa openbadges. Các kiểu chunk văn bản có thể chứa nó là:
| Chunk | Encoding | Ghi chú |
|---|---|---|
tEXt | Latin-1 | Đơn giản, nhưng chỉ giới hạn ở ký tự Latin-1. |
iTXt | UTF-8 | Được ưu tiên, vì tên và mô tả thường không phải ASCII. |
Dù dùng chunk nào, bố cục vẫn cùng một ý: từ khóa openbadges, một dấu phân tách, rồi đến payload. Payload là một trong hai thứ, tùy cách tổ chức cấp chọn bake:
- Chính JSON assertion. Tệp tự mô tả. Bên xác minh có thể đọc tuyên bố mà không cần bất kỳ lệnh gọi mạng nào.
- Một URL trỏ tới assertion được lưu trữ (hosted). Tệp nhỏ hơn và tổ chức cấp có thể giữ bản ghi trực tuyến làm nguồn có thẩm quyền, chẳng hạn để cho thấy huy hiệu sau đó đã bị thu hồi hoặc đã hết hạn.
Có một biến thể thứ ba cho huy hiệu có chữ ký, trong đó payload là một token đã ký thay vì JSON thuần. Nếu chữ ký quan trọng với trường hợp của bạn, hãy đọc cách xác minh chữ ký Open Badge.
Còn SVG thì sao?
Huy hiệu SVG cũng có thể được bake, vì SVG là XML. Assertion được đặt bên trong tệp, trong một phần tử thuộc namespace XML openbadges, và thuộc tính verify mang URL của assertion được lưu trữ. Nguyên tắc giống như với PNG: metadata đi cùng bên trong tệp ảnh. Trên thực tế, hầu hết nền tảng bake PNG, vì PNG được chấp nhận ở hầu hết mọi nơi người ta muốn tải huy hiệu lên.
Assertion được nhúng trông như thế nào
Với định dạng 2.0, assertion được lưu trữ là JSON-LD liên kết người nhận, badge class và phương thức xác minh. Một ví dụ rút gọn:
{
"@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" }
}
Hãy chú ý phần người nhận. Email không được lưu dạng rõ; nó là một mã băm SHA-256 có salt. Điều này quan trọng với một tệp được thiết kế để lưu hành. Bất kỳ ai giữ tệp PNG đều đọc được assertion, nên assertion không được làm lộ địa chỉ của người nhận. Bên xác minh đã biết email có thể băm nó với cùng salt và kiểm tra xem có khớp không. Để xem từng trường của tài liệu này, hãy đọc hướng dẫn chi tiết JSON-LD của Open Badge.
Bên xác minh đọc huy hiệu đã baked như thế nào
Xác minh một huy hiệu đã baked là một quy trình cơ học ngắn gọn:
- Mở tệp PNG và duyệt qua các chunk của nó.
- Tìm chunk văn bản có từ khóa
openbadges. - Đọc payload. Nếu là JSON, hãy phân tích (parse). Nếu là URL, hãy tải về (fetch).
- Kiểm tra assertion tham chiếu đúng badge class và tổ chức cấp mà bạn mong đợi, và định danh người nhận khớp với người đang trình bày nó.
- Nếu loại xác minh là
hosted, hãy xác nhận assertion được lưu trữ vẫn còn tại URLidcủa nó và chưa bị thu hồi hay hết hạn.
Bước 5 là bước mọi người hay bỏ qua, và cũng là bước làm cho chứng chỉ đáng tin cậy. Bản sao được nhúng chỉ là một ảnh chụp nhanh. Bản ghi được lưu trữ mới là nguồn sự thật.
Tự đọc bằng Node
Bạn có thể kiểm tra bất kỳ tệp PNG nào bằng một đoạn script ngắn. Đoạn này duyệt qua các chunk và in payload openbadges, xử lý cả tEXt lẫn 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);
Chạy bằng node extract-badge.mjs my-badge.png. Nếu tệp đã baked, bạn sẽ thấy JSON hoặc một URL. Nếu không, bạn nhận được thông báo đơn giản “not baked”. Đây là công cụ để học, không phải trình xác thực đầy đủ: nó không kiểm tra checksum của chunk, không phân tích payload có chữ ký và không tải bản ghi được lưu trữ.
Nếu không muốn viết code, một trình xác thực huy hiệu trực tuyến hoặc trình xem metadata PNG sẽ hiển thị cùng chunk đó. Định dạng chính là tiêu chuẩn, nên mọi công cụ tuân thủ đều đọc được mọi huy hiệu tuân thủ.
Vì sao baking quan trọng
Tính di động. Một chứng chỉ chỉ là một tệp PNG có thể được gửi email, tải lên nền tảng học tập hoặc lưu trong kho cá nhân. Không cần tài khoản để mang nó đi.
Đường xác minh tồn tại lâu hơn trang tiếp thị của tổ chức cấp. Assertion được nhúng nêu tên tổ chức cấp và trỏ tới bản ghi được lưu trữ, nên bên xác minh có thể bắt đầu chỉ từ tệp.
Quy trình ngoại tuyến và công nghệ thấp. Khi payload là JSON đầy đủ, người đọc có thể kiểm tra tuyên bố trên máy không có mạng, rồi xác minh bản ghi được lưu trữ sau.
Bằng chứng khó làm giả một cách tùy tiện. Ai cũng có thể chụp màn hình một huy hiệu. Ảnh chụp màn hình không có metadata, nên không thể xác minh như một tệp huy hiệu. Chỉ điều đó cũng đủ phân biệt chứng chỉ thật với một bức ảnh sao chép. Nó không ngăn được ai đó bake một assertion giả vào bức ảnh bị đánh cắp, và đó là lý do bước xác minh bản ghi lưu trữ tồn tại.
Giới hạn của baking
Hãy trung thực với người nhận về những điều này, vì chúng ảnh hưởng đến cách bạn mô tả chứng chỉ của mình.
- Metadata bị xóa. Nhiều mạng xã hội, công cụ tối ưu ảnh và ứng dụng nhắn tin mã hóa lại các tệp tải lên và bỏ các chunk không phải điểm ảnh. Một huy hiệu đã baked đăng lên bảng tin mạng xã hội thường không còn baked nữa. Điều đó là bình thường, và vì vậy một liên kết xác minh công khai quan trọng bên cạnh tệp.
- Baking tự nó không phải bằng chứng. JSON được nhúng có thể do bất kỳ ai viết. Niềm tin đến từ assertion được lưu trữ trên tên miền của tổ chức cấp, hoặc từ một chữ ký hợp lệ.
- Chỉnh sửa ảnh làm đứt liên kết. Đổi kích thước hoặc lưu lại trong trình chỉnh sửa có thể làm mất chunk.
- Chỉ PNG và SVG. JPEG không có quy ước chunk tương đương trong đặc tả, nên một huy hiệu kiểu ảnh chụp xuất ra JPEG không thể bake theo cách chuẩn.
Kết luận thực tế: hãy coi tệp đã baked là phương tiện chuyên chở tiện lợi, và coi trang xác minh là nguồn có thẩm quyền. Nếu bạn đang cân nhắc các định dạng cho chương trình của mình, Open Badges so với chứng chỉ PDF giải thích vì sao một chứng chỉ đọc được bằng máy vượt trội hơn một tài liệu tĩnh.
Baking hoạt động như thế nào trên https://badges.ninja
Khi bạn trao một huy hiệu trên https://badges.ninja, nền tảng dựng assertion Open Badge cho người nhận đó và bake nó vào ảnh huy hiệu như một phần của việc cấp. Bạn không cần cấu hình công cụ hay chạy lệnh nào. Quy trình:
- Bạn thiết kế huy hiệu trong trình thiết kế trực quan, hoặc tải ảnh của riêng bạn lên.
- Bạn cấp một award, từ bảng điều khiển, từ tệp CSV tải lên cho award hàng loạt, hoặc qua API.
- Nền tảng tạo assertion, bake nó vào PNG và lưu kết quả cùng với award.
- Người nhận nhận được một trang xác minh công khai tại
https://badges.ninja/awards/<awardId>, một chứng chỉ PDF, một mã QR và tùy chọn Add to LinkedIn.
Nếu thiết kế huy hiệu dùng các trường trộn (merge field) như tên người nhận, mỗi award sẽ có một ảnh được cá nhân hóa, và chính ảnh cá nhân hóa đó được bake.
Baking được coi là một điểm cộng cho việc cấp, không phải cổng chặn: nếu một ảnh cụ thể không thể bake (ví dụ ảnh giữ chỗ suy biến), award vẫn được cấp bằng ảnh gốc, và trang xác minh công khai cùng JSON-LD Open Badge không bị ảnh hưởng. Ảnh bạn tải lên cũng phải đạt kích thước tối thiểu, nên một khung trống tí hon bị từ chối trước khi đến được bakery.
Vì trang công khai là nguồn có thẩm quyền, bất kỳ ai cũng có thể kiểm tra một award mà không cần đăng ký. JSON-LD Open Badge v2.0 đọc được bằng máy cho một award có tại https://api.badges.ninja/certify-badge/award/<awardId>.
Cấp một award bằng API
Hầu hết người đọc sẽ dùng bảng điều khiển, nhưng nếu bạn tự động hóa việc cấp, một request tạo ra award (và ảnh đã baked đi kèm theo). Hãy thay key và badge id bằng của bạn:
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}`;
Lệnh gọi trả về HTTP 200 với { "awardId": "<guid>" }. Hãy dựng URL xác minh từ id đó. Để thiết lập key và xem tham chiếu request đầy đủ, hãy xem tài liệu Awards API và hướng dẫn xác thực.

Lời khuyên thực tế cho tổ chức cấp
Luôn công bố liên kết xác minh bên cạnh tệp. Đặt liên kết trong email award, trên chứng chỉ và trên mọi trang hiển thị huy hiệu. Vì các nền tảng xã hội xóa metadata, chính liên kết giữ cho chứng chỉ có thể xác minh sau khi chia sẻ.
Dùng ảnh nguồn sạch và có kích thước đủ lớn. Hãy bắt đầu từ một PNG có kích thước thật. Một huy hiệu do nhà thiết kế làm ở độ phân giải bình thường bake ổn định; ảnh giữ chỗ 1 điểm ảnh thì không.
Đừng chỉnh sửa tệp đã giao. Hãy bảo người nhận chia sẻ bản tải xuống gốc hoặc liên kết xác minh, không phải ảnh chụp màn hình đã cắt.
Quyết định bạn muốn nói gì về việc thu hồi và hết hạn. Vì bản ghi được lưu trữ là nguồn có thẩm quyền, một tệp đã baked có thể tồn tại lâu hơn trạng thái của chứng chỉ. Hãy nêu rõ điều này trong tài liệu chương trình của bạn để nhà tuyển dụng biết cần kiểm tra trang xác minh thay vì chỉ tin vào tệp.
Kiểm thử một huy hiệu từ đầu đến cuối. Cấp một award cho chính bạn, tải PNG về, chạy nó qua script ở trên hoặc một trình xác thực công khai, và mở liên kết xác minh. Năm phút kiểm thử cho bạn biết người nhận sẽ trải nghiệm điều gì.

Câu hỏi thường gặp
Huy hiệu đã baked có giống chứng chỉ số không? Không. Chứng chỉ thường là tệp PDF để đọc và in. Huy hiệu đã baked là một hình ảnh đồng thời mang dữ liệu chứng chỉ đọc được bằng máy. https://badges.ninja tạo ra cả hai từ cùng một award.
Tôi có thể bake huy hiệu mà không cần nền tảng không? Có. Đặc tả là mã nguồn mở, và có thư viện cho nhiều ngôn ngữ. Phần khó hơn là lưu trữ assertion tại một URL ổn định, thứ làm cho việc xác minh có ý nghĩa. Đó là phần nền tảng xử lý giúp bạn.
Baking có làm lộ email của người nhận không? Không, khi định danh được băm. Assertion lưu một mã băm có salt, nên tệp không tiết lộ địa chỉ.
LinkedIn có đọc dữ liệu đã baked không? Luồng Add to Profile của LinkedIn hoạt động dựa trên tên chứng chỉ, tổ chức cấp, ngày và URL chứ không phải metadata của tệp. Xem thêm nút Add to LinkedIn.
Tóm tắt
Một Open Badge đã baked là một PNG (hoặc SVG) với chứng chỉ được ghi vào một chunk văn bản có tên openbadges. Nó làm cho huy hiệu di động và tự mô tả, nhưng niềm tin thực sự đến từ assertion được lưu trữ trên tên miền của tổ chức cấp. Hãy bake để có tính di động, công bố liên kết xác minh để tạo niềm tin, và hãy chuẩn bị rằng mạng xã hội sẽ xóa metadata.
Sẵn sàng cấp chứng chỉ có thể xác minh đầu tiên của bạn? Bắt đầu miễn phí tại badges.ninja — trình thiết kế trực quan, trang xác minh công khai, chứng chỉ PDF, đầu ra Open Badge v2.0. Không cần thẻ tín dụng.
Bài viết này được thực hiện như thế nào
Một số bài viết trên blog này được soạn với sự hỗ trợ của trợ lý AI, sau đó được đội ngũ Badges Ninja xem xét, kiểm chứng và biên tập trước khi xuất bản. Mọi đoạn code và mức giá đều được đối chiếu với sản phẩm thực tế. Tìm hiểu thêm về quy trình biên tập và AI của chúng tôi tại trang quy trình biên tập .

Về tác giả
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.
Thêm bài viết của Nacho Coll
- Open Badges cho bootcamp lập trình: Cấp chứng chỉ có thể xác minh ở quy mô khóa học19 thg 11, 2026 · 14phút đọc
- Thiết lập Webhook cho sự kiện huy hiệu: Tích hợp thời gian thực với backend của bạn16 thg 11, 2026 · 11phút đọc
- Hết hạn và gia hạn Open Badge: Quản lý vòng đời cho chứng chỉ có thời hạn12 thg 11, 2026 · 14phút đọc


