Open Badge のベイキングを解説:PNG の中に JSON が入る仕組み

「ベイク済み」の Open Badge は、アサーション JSON を画像メタデータとして埋め込んだ PNG です。バッジのファイルそのものが資格情報になります。ベイキングの仕組みと、ベイク済みバッジの検証方法を解説します。

Nacho Coll 著者: 更新日 22 分で読了
「ベイク済み」の Open Badge は、アサーション JSON を画像メタデータとして埋め込んだ PNG です。バッジのファイルそのものが資格情報になります。ベイキングの仕組みと、ベイク済みバッジの検証方法を解説します。

ほとんどの発行者から Open Badge をダウンロードすると、見た目は普通の PNG が手に入ります。チャットに貼っても、メールに添付しても、印刷しても、他の画像と変わりません。ところがこのファイルには、目に見えないもう一つの層があります。資格情報そのものが、メタデータとして画像の中に書き込まれているのです。これが Open Badges コミュニティで「ベイク済みバッジ」と呼ばれるもので、バッジが 1 つのファイルとして持ち運べるうえ、誰が、誰に、何のために発行したのかを証明できる理由でもあります。

このガイドでは、ベイキングとは何か、データがファイルのどこにあるのか、検証者がどのように読み出すのか、そして資格情報を発行する側として何を決めておくべきかを説明します。ベイク済みバッジを使うのに、コードを書く必要はありません。https://badges.ninja で発行すれば、ベイキングは自動で行われます。それでも仕組みを理解しておくと、受け取る人や雇用主が実際によく尋ねる「この画像は本物ですか?」「誰でもコピーできるのでは?」という質問に答えられるようになります。

「ベイキング」とは

Open Badge には、混同しやすい 2 つの要素があります。

  • 画像。 プロフィールやスライド、証明書の上で人の目に触れる PNG または SVG。
  • アサーション。 事実を述べる小さな JSON ドキュメント。受領者が誰か(ハッシュ化された識別子として)、どのバッジクラスを取得したか、誰が発行したか、いつ発行されたか、どこで検証できるかが書かれています。

ベイキングとは、アサーションを画像の中に書き込み、両者を切り離せなくすることです。結果は 1 つのファイルになります。PNG を誰かに渡せば、画像とその裏付けとなる主張の両方を渡したことになります。

この考え方は、もともと Mozilla が開発し、現在は 1EdTech が管理している Open Badges 仕様に由来します。設計の狙いは可搬性です。初期のバッジは 1 つのプラットフォーム内に閉じていて、別の場所へ移すには再アップロードが必要で、メタデータが無事に残ることを祈るしかありませんでした。ベイク済みのファイルは、どこへ行っても自分のメタデータを携えています。

PNG の中で JSON はどこにあるのか

PNG ファイルは、短いシグネチャと、それに続く一連のチャンクで構成されています。各チャンクには、長さ、4 文字のタイプ、データ、チェックサムがあります。ビューアは IDAT チャンクからピクセルを描画し、理解できないチャンクタイプは無視します。この寛容さがベイキングを可能にしています。テキストが詰まったチャンクを追加しても、世界中のどの画像ビューアでも画像は普通に表示されるのです。

Open Badges 2.0 では、アサーションはキーワード openbadges を持つテキストチャンクに入ります。これを格納できるテキストチャンクのタイプは次のとおりです。

チャンクエンコーディング備考
tEXtLatin-1シンプルですが、Latin-1 の文字に限られます。
iTXtUTF-8名前や説明は ASCII ではないことが多いため、こちらが推奨されます。

どちらのチャンクを使っても、構造の考え方は同じです。キーワード openbadges、区切り文字、そしてペイロードが続きます。ペイロードは、発行者がどうベイクするかによって、次の 2 つのうちどちらかになります。

  1. アサーション JSON そのもの。 ファイルが自己完結しています。検証者はネットワークに接続しなくても主張を読み取れます。
  2. ホストされたアサーションを指す URL。 ファイルは小さくなり、発行者は常に最新のレコードを正とすることができます。たとえば、バッジが後から失効した、あるいは期限切れになったことを示せます。

署名付きバッジ向けには 3 つ目のバリエーションがあり、ペイロードはプレーンな 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 であれば、ネットワークのないマシンでも主張を確認でき、ホストされたレコードの検証は後から行えます。

簡単には偽造しにくい証拠。 バッジのスクリーンショットは誰でも撮れますが、スクリーンショットにはメタデータがないため、バッジファイルとしては検証できません。これだけでも、本物の資格情報とコピーされた画像を区別できます。ただし、盗んだ画像に偽造したアサーションをベイクされる可能性は防げません。ホストされたレコードによる検証の手順があるのは、そのためです。

ベイキングの限界

資格情報の説明の仕方に影響するため、受け取る人にはこれらを正直に伝えましょう。

  • メタデータは削除されることがあります。 多くの SNS、画像最適化ツール、メッセージアプリは、アップロードされた画像を再エンコードし、ピクセル以外のチャンクを捨てます。SNS のフィードに投稿されたベイク済みバッジは、たいていもうベイクされていません。これは想定内のことであり、ファイルと並んで公開の検証リンクが重要になる理由です。
  • ベイキングだけでは証明になりません。 埋め込まれた 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 で 1 件の授与を発行する

ほとんどの方はダッシュボードを使いますが、発行を自動化する場合は、1 回のリクエストで授与が作成されます(ベイク済みの画像もセットです)。キーとバッジ 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 ダッシュボードのバッジ詳細画面

発行者向けの実践的なアドバイス

ファイルの隣には必ず検証リンクを公開しましょう。 授与メール、証明書、バッジを表示するあらゆるページにリンクを載せてください。SNS はメタデータを削除するため、共有後も資格情報を検証可能に保つのはこのリンクです。

きれいで十分な大きさの元画像を使いましょう。 実際のサイズがある PNG から始めてください。デザイナーが通常の解像度で作ったバッジは確実にベイクできますが、1 ピクセルのプレースホルダーはできません。

配布したファイルは編集しないでください。 受領者には、切り抜いたスクリーンショットではなく、ダウンロードした元のファイルか検証リンクを共有するよう伝えましょう。

失効と有効期限について、何を伝えるかを決めましょう。 ホストされたレコードが正なので、ベイク済みのファイルは資格情報の状態よりも長く残り得ます。雇用主がファイルだけを信用せず検証ページを確認できるよう、プログラムのドキュメントではこの点をはっきり書いておきましょう。

バッジ 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)です。バッジを持ち運びやすく自己完結したものにしますが、本当の信頼は発行者のドメイン上にあるホストされたアサーションから生まれます。可搬性のためにベイクし、信頼のために検証リンクを公開し、SNS ではメタデータが削除されることを前提にしましょう。

最初の検証可能な資格情報を発行する準備はできましたか? 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.

ブログに戻る

関連記事