Open Badge Baking explicado: cómo vive el JSON dentro del PNG

Una insignia Open Badge «baked» es un PNG con el JSON de la aserción incrustado como metadatos de la imagen. El archivo de la insignia ES la credencial. Cómo funciona el baking y cómo verificar una insignia baked.

Nacho Coll Por Actualizado 12 min de lectura
Una insignia Open Badge «baked» es un PNG con el JSON de la aserción incrustado como metadatos de la imagen. El archivo de la insignia ES la credencial. Cómo funciona el baking y cómo verificar una insignia baked.

Descarga una insignia Open Badge de casi cualquier emisor y obtendrás un PNG de aspecto normal. Suéltalo en un chat, adjúntalo a un correo, imprímelo. Parece una imagen más. Pero el archivo lleva una segunda capa invisible: la propia credencial, escrita dentro de la imagen como metadatos. Eso es lo que la comunidad de Open Badges llama una insignia baked (horneada), y es la razón por la que una insignia puede viajar como un único archivo y aun así demostrar quién la emitió, a quién y por qué.

Esta guía explica qué es el baking, dónde viven los datos dentro del archivo, cómo los lee un verificador y qué debes decidir como emisor de credenciales. No necesitas escribir código para usar insignias baked. Si emites con https://badges.ninja, el baking se hace por ti. Pero entender la mecánica te ayuda a responder las preguntas que realmente hacen los destinatarios y los empleadores: «¿Es real esta imagen?» y «¿Puede cualquiera simplemente copiarla?»

Qué significa «baking»

Una insignia Open Badge tiene dos partes fáciles de confundir:

  • La imagen. El PNG o SVG que la gente ve en un perfil, una diapositiva o un certificado.
  • La aserción. Un pequeño documento JSON que declara los hechos: quién es el destinatario (como identificador con hash), qué clase de insignia se obtuvo, quién la emitió, cuándo y dónde verificarla.

Hacer baking es escribir la aserción dentro de la imagen para que ambas no puedan separarse. El resultado es un solo archivo. Si le das a alguien el PNG, le has dado tanto la imagen como la afirmación que hay detrás.

La idea viene de la especificación Open Badges, desarrollada originalmente por Mozilla y mantenida hoy por 1EdTech. El objetivo del diseño es la portabilidad. Al principio, las insignias vivían dentro de una sola plataforma, y moverlas a otro lugar significaba volver a subirlas y esperar que los metadatos sobrevivieran. Un archivo baked lleva sus propios metadatos a donde vaya.

Dónde vive el JSON dentro de un PNG

Un archivo PNG es una firma corta seguida de una secuencia de chunks (fragmentos). Cada chunk tiene una longitud, un tipo de cuatro letras, unos datos y una suma de verificación. Los visores dibujan los píxeles a partir de los chunks IDAT e ignoran los tipos de chunk que no entienden. Esa tolerancia es lo que hace posible el baking: puedes añadir un chunk lleno de texto y todos los visores de imágenes del mundo seguirán mostrando la imagen con normalidad.

En Open Badges 2.0, la aserción va en un chunk de texto con la palabra clave openbadges. Los tipos de chunk de texto que pueden contenerla son:

ChunkCodificaciónNotas
tEXtLatin-1Sencillo, pero limitado a caracteres Latin-1.
iTXtUTF-8Preferido, porque los nombres y las descripciones a menudo no son ASCII.

Sea cual sea el chunk usado, la estructura es la misma: la palabra clave openbadges, un separador y luego la carga útil. La carga útil es una de dos cosas, según cómo haya decidido hacer el baking el emisor:

  1. El propio JSON de la aserción. El archivo se describe a sí mismo. Un verificador puede leer la afirmación sin ninguna llamada de red.
  2. Una URL que apunta a la aserción alojada. El archivo es más pequeño y el emisor puede mantener el registro vivo como autoridad, por ejemplo para mostrar que una insignia fue revocada o ha caducado.

Existe una tercera variante para insignias firmadas, donde la carga útil es un token firmado en lugar de JSON plano. Si las firmas importan en tu caso, lee cómo verificar la firma de un Open Badge.

¿Y el SVG?

Las insignias SVG también pueden hornearse, ya que SVG es XML. La aserción se coloca dentro del archivo en un elemento del espacio de nombres XML openbadges, y el atributo verify contiene la URL de la aserción alojada. El principio es el mismo que con PNG: los metadatos viajan dentro del archivo de imagen. En la práctica, la mayoría de las plataformas hacen baking en PNG, porque PNG se acepta casi en todas partes donde la gente quiere subir una insignia.

Cómo es la aserción incrustada

Para el formato 2.0, una aserción alojada es JSON-LD que enlaza al destinatario, la clase de insignia y el método de verificación. Un ejemplo recortado:

{
  "@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" }
}

Fíjate en el destinatario. El correo no se guarda en claro; es un hash SHA-256 con sal. Eso importa en un archivo pensado para circular. Cualquiera que tenga el PNG puede leer la aserción, así que esta no debe filtrar la dirección del destinatario. Un verificador que ya conozca el correo puede aplicarle el hash con la misma sal y comprobar que coincide. Para un recorrido campo por campo de este documento, consulta el recorrido por el JSON-LD de Open Badge.

Cómo lee un verificador una insignia baked

La verificación de una insignia baked es un proceso breve y mecánico:

  1. Abre el PNG y recorre sus chunks.
  2. Busca el chunk de texto con la palabra clave openbadges.
  3. Lee la carga útil. Si es JSON, analízalo. Si es una URL, descárgala.
  4. Comprueba que la aserción se refiere a la clase de insignia y al emisor que esperas, y que la identidad del destinatario coincide con la persona que la presenta.
  5. Si el tipo de verificación es hosted, confirma que la aserción alojada sigue existiendo en su URL id y que no ha sido revocada ni ha caducado.

El paso 5 es el que la gente se salta, y es el que hace confiable una credencial. Una copia incrustada es una instantánea. El registro alojado es la fuente de verdad.

Léelo tú mismo en Node

Puedes inspeccionar cualquier PNG con un script corto. Este recorre los chunks e imprime la carga útil openbadges, manejando tanto tEXt como 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);

Ejecútalo con node extract-badge.mjs my-badge.png. Si el archivo es baked verás JSON o una URL. Si no, obtendrás un simple mensaje de «not baked». Es una herramienta didáctica, no un validador completo: no comprueba las sumas de verificación de los chunks, no analiza cargas útiles firmadas ni descarga el registro alojado.

Si prefieres no escribir código, un validador de insignias en línea o un visor de metadatos PNG mostrará el mismo chunk. El formato es el estándar, así que cualquier herramienta compatible lee cualquier insignia compatible.

Por qué importa el baking

Portabilidad. Una credencial que es solo un PNG se puede enviar por correo, subir a una plataforma de aprendizaje o guardar en un archivo personal. No hace falta una cuenta para llevarla encima.

Una vía de verificación que sobrevive al sitio de marketing del emisor. La aserción incrustada nombra al emisor y apunta al registro alojado, así que un verificador puede empezar solo con el archivo.

Flujos sin conexión y de baja tecnología. Cuando la carga útil es el JSON completo, un lector puede comprobar la afirmación en una máquina sin red y verificar el registro alojado más tarde.

Evidencia difícil de falsificar a la ligera. Cualquiera puede hacer una captura de pantalla de una insignia. Una captura no tiene metadatos, así que no se puede verificar como archivo de insignia. Eso por sí solo distingue una credencial real de una imagen copiada. No impide que alguien incruste una aserción falsificada en una imagen robada, y por eso existe el paso de verificación alojada.

Los límites del baking

Sé honesto con tus destinatarios sobre esto, porque afecta a cómo describes tus credenciales.

  • Los metadatos se eliminan. Muchas redes sociales, optimizadores de imágenes y apps de mensajería recodifican las subidas y descartan los chunks que no son píxeles. Una insignia baked publicada en un feed social normalmente deja de estar baked. Es lo esperado, y por eso un enlace de verificación público importa junto al archivo.
  • El baking no es una prueba por sí solo. Cualquiera puede escribir JSON incrustado. La confianza viene de la aserción alojada en el dominio del emisor, o de una firma válida.
  • Editar la imagen rompe el vínculo. Cambiar el tamaño o volver a guardar en un editor puede perder el chunk.
  • Solo PNG y SVG. JPEG no tiene una convención de chunk equivalente en la especificación, así que una insignia estilo foto exportada como JPEG no puede hornearse de la forma estándar.

La conclusión práctica: trata el archivo baked como un transportista cómodo y la página de verificación como la autoridad. Si estás comparando formatos para tu programa, Open Badges vs certificados en PDF explica por qué una credencial legible por máquinas supera a un documento estático.

Cómo funciona el baking en https://badges.ninja

Cuando concedes una insignia en https://badges.ninja, la plataforma construye la aserción Open Badge para ese destinatario y la hornea en la imagen de la insignia como parte de la emisión. No configuras ninguna herramienta ni ejecutas ningún comando. El flujo:

  1. Diseñas la insignia en el diseñador visual, o subes tu propia imagen.
  2. Emites un premio, desde el panel, desde una subida de CSV para premios en lote, o a través de la API.
  3. La plataforma crea la aserción, la hornea en el PNG y guarda el resultado con el premio.
  4. El destinatario recibe una página de verificación pública en https://badges.ninja/awards/<awardId>, un certificado en PDF, un código QR y una opción Add to LinkedIn.

Si el diseño de la insignia usa campos de combinación como el nombre del destinatario, cada premio obtiene una imagen personalizada, y esa imagen personalizada es la que se hornea.

El baking se trata como una mejora de la emisión, no como una barrera: si una imagen concreta no puede hornearse (por ejemplo, una imagen de marcador degenerada), el premio se emite igualmente con la imagen original, y la página de verificación pública y el JSON-LD de Open Badge no se ven afectados. La imagen que subas también debe superar un tamaño mínimo, así que un lienzo diminuto en blanco se rechaza antes de llegar a la panadería.

Como la página pública es la autoridad, cualquiera puede comprobar un premio sin registrarse. El JSON-LD legible por máquinas de Open Badge v2.0 de un premio está disponible en https://api.badges.ninja/certify-badge/award/<awardId>.

Emitir un premio por API

La mayoría usará el panel, pero si automatizas la emisión, una sola petición crea el premio (y la imagen baked viene con él). Sustituye la clave y el id de la insignia por los tuyos:

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}`;

La llamada devuelve HTTP 200 con { "awardId": "<guid>" }. Construye la URL de verificación a partir de ese id. Para la configuración de claves y la referencia completa de peticiones, consulta la documentación de la API de Awards y la guía de autenticación.

Pantalla de detalle de una insignia en el panel de https://badges.ninja

Consejos prácticos para emisores

Publica siempre un enlace de verificación junto al archivo. Pon el enlace en el correo del premio, en el certificado y en cualquier página donde se muestre la insignia. Como las plataformas sociales eliminan los metadatos, el enlace es lo que mantiene la credencial verificable tras compartirla.

Usa una imagen de origen limpia y de buen tamaño. Parte de un PNG con dimensiones reales. Una insignia hecha por un diseñador a resolución normal se hornea sin problemas; un marcador de 1 píxel, no.

No edites el archivo entregado. Dile a los destinatarios que compartan la descarga original o el enlace de verificación, no una captura recortada.

Decide qué quieres decir sobre revocación y caducidad. Como el registro alojado es la autoridad, un archivo baked puede sobrevivir al estado de la credencial. Dilo claramente en la documentación de tu programa para que los empleadores sepan que deben consultar la página de verificación en lugar de fiarse solo del archivo.

Prueba una insignia de principio a fin. Emítete un premio a ti mismo, descarga el PNG, pásalo por el script de arriba o por un validador público y abre el enlace de verificación. Cinco minutos de pruebas te dicen lo que experimentarán tus destinatarios.

Lista de insignias en el panel de https://badges.ninja

Preguntas frecuentes

¿Es una insignia baked lo mismo que un certificado digital? No. Un certificado suele ser un PDF para leer e imprimir. Una insignia baked es una imagen que además lleva datos de credencial legibles por máquinas. https://badges.ninja produce ambos a partir del mismo premio.

¿Puedo hacer baking de una insignia sin una plataforma? Sí. La especificación es abierta y existen librerías para varios lenguajes. Lo difícil es alojar la aserción en una URL estable, que es lo que da sentido a la verificación. Esa es la parte que una plataforma resuelve por ti.

¿El baking expone el correo del destinatario? No cuando la identidad lleva hash. La aserción guarda un hash con sal, así que el archivo no revela la dirección.

¿Leerá LinkedIn los datos baked? El flujo Add to Profile de LinkedIn funciona con el nombre de la credencial, el emisor, la fecha y la URL, no con los metadatos del archivo. Consulta cómo añadir un botón Add to LinkedIn.

Resumen

Una insignia Open Badge baked es un PNG (o SVG) con la credencial escrita en un chunk de texto llamado openbadges. Hace que una insignia sea portable y se describa a sí misma, pero la verdadera confianza viene de la aserción alojada en el dominio del emisor. Haz baking por la portabilidad, publica un enlace de verificación por la confianza y espera que las redes sociales eliminen los metadatos.

¿Listo para emitir tu primera credencial verificable? Empieza gratis en badges.ninja — diseñador visual, página de verificación pública, certificado en PDF, salida Open Badge v2.0. Sin tarjeta de crédito.

Nacho Coll

Sobre el autor

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.

Volver al Blog

Artículos relacionados