Open Badge 베이킹 완벽 해설: PNG 안에 JSON이 들어 있는 방식

'베이킹된' Open Badge는 어서션 JSON이 이미지 메타데이터로 삽입된 PNG입니다. 배지 파일 자체가 곧 자격 증명이에요. 베이킹이 어떻게 동작하는지, 베이킹된 배지를 어떻게 검증하는지 알아봅니다.

Nacho Coll 작성자 업데이트됨 24 분 읽기
'베이킹된' Open Badge는 어서션 JSON이 이미지 메타데이터로 삽입된 PNG입니다. 배지 파일 자체가 곧 자격 증명이에요. 베이킹이 어떻게 동작하는지, 베이킹된 배지를 어떻게 검증하는지 알아봅니다.

거의 모든 발급자에게서 Open Badge를 내려받으면 평범해 보이는 PNG 파일이 생깁니다. 채팅창에 올려도, 이메일에 첨부해도, 인쇄해도 다른 이미지와 똑같아 보여요. 하지만 이 파일에는 눈에 보이지 않는 두 번째 층이 있습니다. 자격 증명 자체가 메타데이터로 이미지 안에 기록되어 있거든요. 이것을 Open Badges 커뮤니티에서는 **베이킹된 배지(baked badge)**라고 부르며, 배지가 파일 하나로 이동하면서도 누가, 누구에게, 무엇을 이유로 발급했는지 증명할 수 있는 이유이기도 합니다.

이 가이드에서는 베이킹이 무엇인지, 데이터가 파일 어디에 들어 있는지, 검증자가 어떻게 다시 읽어 내는지, 그리고 자격 증명을 발급하는 입장에서 무엇을 결정해야 하는지 설명합니다. 베이킹된 배지를 쓰려고 코드를 작성할 필요는 없어요. https://badges.ninja로 발급하면 베이킹은 자동으로 처리됩니다. 그래도 원리를 알아 두면 수령자와 고용주가 실제로 자주 묻는 질문, 즉 “이 이미지는 진짜인가요?”와 “누구나 그냥 복사할 수 있지 않나요?”에 답할 수 있습니다.

”베이킹”이란 무엇인가

Open Badge에는 헷갈리기 쉬운 두 가지 요소가 있습니다.

  • 그림. 프로필, 슬라이드, 증명서에서 사람들이 보게 되는 PNG 또는 SVG.
  • 어서션. 사실을 서술하는 작은 JSON 문서. 수령자가 누구인지(해시된 식별자로), 어떤 배지 클래스를 획득했는지, 누가 언제 발급했는지, 어디에서 검증할 수 있는지가 담겨 있습니다.

베이킹은 어서션을 그림 안에 써 넣어 둘을 분리할 수 없게 만드는 일입니다. 결과물은 파일 하나예요. PNG를 건네면 이미지와 그 뒷받침이 되는 주장을 함께 건넨 셈입니다.

이 아이디어는 원래 Mozilla가 개발했고 지금은 1EdTech가 관리하는 Open Badges 사양에서 나왔습니다. 설계의 핵심은 이식성입니다. 초기에는 배지가 하나의 플랫폼 안에만 있었고, 다른 곳으로 옮기려면 다시 업로드하면서 메타데이터가 무사하기를 바라야 했습니다. 베이킹된 파일은 어디로 가든 자신의 메타데이터를 함께 가져갑니다.

PNG 안에서 JSON은 어디에 있을까

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는 XML이라서 SVG 배지도 베이킹할 수 있습니다. 어서션은 파일 안의 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든 살펴볼 수 있습니다. 이 스크립트는 청크를 따라가며 tEXt와 iTXt를 모두 처리해서 openbadges 페이로드를 출력합니다.

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 코드, 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를 내려받아 위 스크립트나 공개 검증기에 돌려 본 다음, 검증 링크를 열어 보세요. 5분의 테스트로 수령자가 겪게 될 경험을 알 수 있습니다.

https://badges.ninja 대시보드의 배지 목록

자주 묻는 질문

베이킹된 배지는 디지털 증명서와 같은가요? 아니요. 증명서는 보통 읽고 인쇄하기 위한 PDF입니다. 베이킹된 배지는 기계가 읽을 수 있는 자격 증명 데이터도 함께 담은 이미지예요. https://badges.ninja는 같은 수여에서 둘 다 만들어 줍니다.

플랫폼 없이도 배지를 베이킹할 수 있나요? 네. 사양은 공개되어 있고 여러 언어용 라이브러리도 있습니다. 더 어려운 부분은 어서션을 안정적인 URL에 호스팅하는 일인데, 검증이 의미를 갖는 것은 바로 이 부분 덕분입니다. 플랫폼이 대신 처리해 주는 것도 이 부분이고요.

베이킹하면 수령자의 이메일이 노출되나요? 식별자가 해시되어 있으면 노출되지 않습니다. 어서션에는 솔트가 적용된 해시가 저장되므로 파일만으로는 주소를 알 수 없어요.

LinkedIn이 베이킹된 데이터를 읽나요? LinkedIn의 Add to Profile 흐름은 파일 메타데이터가 아니라 자격 증명 이름, 발급자, 날짜, URL로 동작합니다. Add to LinkedIn 버튼 추가하기를 참고하세요.

요약

베이킹된 Open Badge는 openbadges라는 이름의 텍스트 청크에 자격 증명을 기록한 PNG(또는 SVG)입니다. 배지를 이식 가능하고 스스로 설명이 되게 만들어 주지만, 진짜 신뢰는 발급자 도메인에 있는 호스팅된 어서션에서 나옵니다. 이식성을 위해 베이킹하고, 신뢰를 위해 검증 링크를 공개하며, 소셜 네트워크가 메타데이터를 제거할 것을 예상하세요.

첫 번째 검증 가능한 자격 증명을 발급할 준비가 되셨나요? 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.

블로그로 돌아가기

관련 글