Baking de Open Badges explicado: como o JSON vive dentro do PNG
Um Open Badge «baked» é um PNG com o JSON da asserção embutido como metadados da imagem. O ficheiro do emblema É a credencial. Como funciona o baking e como verificar um emblema 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.
Descarrega um Open Badge de quase qualquer emissor e obtens um PNG com aspeto normal. Larga-o numa conversa, anexa-o a um e-mail, imprime-o. Parece uma imagem como outra qualquer. Mas o ficheiro leva uma segunda camada, invisível: a própria credencial, escrita na imagem como metadados. É isso que a comunidade Open Badges chama um emblema baked, e é a razão pela qual um emblema pode circular como um único ficheiro e, ainda assim, provar quem o emitiu, a quem e para quê.
Este guia explica o que é o baking, onde os dados vivem dentro do ficheiro, como um verificador os lê de volta e o que tens de decidir enquanto emissor de credenciais. Não precisas de escrever código para usar emblemas baked. Se emites através de https://badges.ninja, o baking é feito por ti. Mas perceber a mecânica ajuda-te a responder às perguntas que destinatários e empregadores realmente fazem: «Esta imagem é verdadeira?» e «Qualquer pessoa pode simplesmente copiá-la?»
O que significa «baking»
Um Open Badge tem duas partes fáceis de confundir:
- A imagem. O PNG ou SVG que as pessoas veem num perfil, num diapositivo ou num certificado.
- A asserção. Um pequeno documento JSON que enuncia os factos: quem é o destinatário (como identificador com hash), que classe de emblema foi conquistada, quem a emitiu, quando e onde a verificar.
Fazer baking é escrever a asserção dentro da imagem, de modo a que as duas não possam ser separadas. O resultado é um só ficheiro. Entrega o PNG a alguém e entregaste-lhe a imagem e a declaração que está por trás dela.
A ideia vem da especificação Open Badges, desenvolvida originalmente pela Mozilla e hoje mantida pela 1EdTech. O objetivo do desenho é a portabilidade. No início, os emblemas viviam dentro de uma única plataforma, e mudar um para outro sítio implicava voltar a carregá-lo e esperar que os metadados sobrevivessem. Um ficheiro baked leva os seus próprios metadados para onde quer que vá.
Onde vive o JSON dentro de um PNG
Um ficheiro PNG é uma curta assinatura seguida de uma sequência de chunks. Cada chunk tem um comprimento, um tipo de quatro letras, alguns dados e uma soma de verificação. Os visualizadores desenham os píxeis a partir dos chunks IDAT e ignoram os tipos de chunk que não compreendem. Essa tolerância é o que torna o baking possível: podes adicionar um chunk cheio de texto e todos os visualizadores de imagens do mundo continuam a mostrar a imagem normalmente.
Nos Open Badges 2.0, a asserção vai para um chunk de texto com a palavra-chave openbadges. Os tipos de chunk de texto que a podem conter são:
| Chunk | Codificação | Notas |
|---|---|---|
tEXt | Latin-1 | Simples, mas limitado a caracteres Latin-1. |
iTXt | UTF-8 | Preferível, porque nomes e descrições muitas vezes não são ASCII. |
Seja qual for o chunk usado, a estrutura é a mesma: a palavra-chave openbadges, um separador e depois a carga. A carga é uma de duas coisas, consoante a forma como o emissor escolheu fazer o baking:
- O próprio JSON da asserção. O ficheiro é autodescritivo. Um verificador consegue ler a declaração sem qualquer chamada de rede.
- Um URL que aponta para a asserção alojada. O ficheiro é mais pequeno e o emissor pode manter o registo em direto como fonte de autoridade, por exemplo para mostrar que um emblema foi entretanto revogado ou expirou.
Existe uma terceira variante para emblemas assinados, em que a carga é um token assinado em vez de JSON simples. Se as assinaturas são importantes no teu caso, lê como verificar a assinatura de um Open Badge.
E o SVG?
Os emblemas SVG também podem ser baked, uma vez que o SVG é XML. A asserção é colocada dentro do ficheiro num elemento do espaço de nomes XML openbadges, e o atributo verify contém o URL da asserção alojada. O princípio é o mesmo do PNG: os metadados viajam dentro do ficheiro de imagem. Na prática, a maioria das plataformas faz baking de PNG, porque o PNG é aceite em quase todo o lado onde as pessoas querem carregar um emblema.
Como é a asserção embutida
No formato 2.0, uma asserção alojada é JSON-LD que liga o destinatário, a classe do emblema e o método de verificação. Um exemplo reduzido:
{
"@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" }
}
Repara no destinatário. O e-mail não é guardado em claro; é um hash SHA-256 com salt. Isto é importante para um ficheiro pensado para circular. Quem tiver o PNG pode ler a asserção, pelo que esta não pode revelar o endereço do destinatário. Um verificador que já conheça o e-mail pode fazer o hash com o mesmo salt e confirmar que coincide. Para uma visita campo a campo a este documento, consulta o guia do JSON-LD de um Open Badge.
Como um verificador lê um emblema baked
A verificação de um emblema baked é um processo curto e mecânico:
- Abre o PNG e percorre os seus chunks.
- Encontra o chunk de texto com a palavra-chave
openbadges. - Lê a carga. Se for JSON, faz o parse. Se for um URL, vai buscá-lo.
- Confirma que a asserção se refere à classe de emblema e ao emissor que esperas, e que a identidade do destinatário corresponde à pessoa que o apresenta.
- Se o tipo de verificação for
hosted, confirma que a asserção alojada ainda existe no URL do seuide que não foi revogada nem expirou.
O passo 5 é o que as pessoas saltam, e é o que torna uma credencial credível. Uma cópia embutida é um retrato do momento. O registo alojado é a fonte de verdade.
Lê-lo tu próprio em Node
Podes inspecionar qualquer PNG com um pequeno script. Este percorre os chunks e imprime a carga openbadges, tratando 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);
Executa-o com node extract-badge.mjs my-badge.png. Se o ficheiro for baked, verás JSON ou um URL. Caso contrário, recebes uma simples mensagem de «não baked». Isto é uma ferramenta de ensino, não um validador completo: não verifica somas de verificação dos chunks, não analisa cargas assinadas nem vai buscar o registo alojado.
Se preferires não escrever código, um validador de emblemas online ou um visualizador de metadados PNG mostra o mesmo chunk. O formato é o standard, por isso qualquer ferramenta compatível lê qualquer emblema compatível.
Porque é que o baking importa
Portabilidade. Uma credencial que é apenas um PNG pode ser enviada por e-mail, carregada numa plataforma de aprendizagem ou guardada num arquivo pessoal. Não é preciso nenhuma conta para a transportar.
Um caminho de verificação que sobrevive ao site de marketing do emissor. A asserção embutida identifica o emissor e aponta para o registo alojado, pelo que um verificador pode partir apenas do ficheiro.
Fluxos offline e de baixa tecnologia. Quando a carga é o JSON completo, é possível verificar a declaração numa máquina sem rede e confirmar o registo alojado mais tarde.
Uma prova difícil de falsificar casualmente. Qualquer pessoa pode fazer uma captura de ecrã de um emblema. Uma captura de ecrã não tem metadados, por isso não pode ser verificada como ficheiro de emblema. Só isso separa uma credencial real de uma imagem copiada. Não impede que alguém faça o baking de uma asserção falsificada numa imagem roubada, e é por isso que existe o passo de verificação alojada.
Os limites do baking
Sê honesto com os teus destinatários sobre estes pontos, porque afetam a forma como descreves as tuas credenciais.
- Os metadados são removidos. Muitas redes sociais, otimizadores de imagem e aplicações de mensagens recodificam os carregamentos e descartam os chunks que não são píxeis. Um emblema baked publicado num feed social normalmente já não está baked. É o esperado, e é por isso que uma ligação de verificação pública é importante junto do ficheiro.
- O baking, por si só, não é prova. O JSON embutido pode ser escrito por qualquer pessoa. A confiança vem da asserção alojada no domínio do emissor, ou de uma assinatura válida.
- Editar a imagem quebra a ligação. Redimensionar ou voltar a guardar num editor pode perder o chunk.
- Apenas PNG e SVG. O JPEG não tem uma convenção de chunk equivalente na especificação, pelo que um emblema em estilo fotografia exportado como JPEG não pode ser baked da forma standard.
A conclusão prática: trata o ficheiro baked como um transportador conveniente e a página de verificação como a autoridade. Se estás a ponderar formatos para o teu programa, Open Badges vs certificados em PDF explica porque é que uma credencial legível por máquina vence um documento estático.
Como funciona o baking em https://badges.ninja
Quando atribuis um emblema em https://badges.ninja, a plataforma constrói a asserção Open Badge para esse destinatário e faz o baking na imagem do emblema como parte da emissão. Não configuras nenhuma ferramenta nem executas nenhum comando. O fluxo:
- Crias o emblema no designer visual, ou carregas a tua própria imagem.
- Emites uma atribuição, a partir do painel, de um carregamento CSV para atribuições em massa, ou através da API.
- A plataforma cria a asserção, faz o baking no PNG e guarda o resultado com a atribuição.
- O destinatário recebe uma página de verificação pública em
https://badges.ninja/awards/<awardId>, um certificado em PDF, um código QR e uma opção Add to LinkedIn.
Se o desenho do emblema usar campos de mesclagem, como o nome do destinatário, cada atribuição recebe uma imagem personalizada, e é essa imagem personalizada que é baked.
O baking é tratado como um complemento da emissão, não como uma barreira: se uma determinada imagem não puder ser baked (por exemplo, uma imagem de marcador degenerada), a atribuição é emitida na mesma com a imagem original, e a página de verificação pública e o JSON-LD do Open Badge não são afetados. A imagem que carregas tem também de cumprir um tamanho mínimo, pelo que uma pequena tela em branco é rejeitada antes de chegar à «padaria».
Como a página pública é a autoridade, qualquer pessoa pode verificar uma atribuição sem criar conta. O JSON-LD Open Badge v2.0, legível por máquina, de uma atribuição está disponível em https://api.badges.ninja/certify-badge/award/<awardId>.
Emitir uma atribuição por API
A maioria dos leitores usará o painel, mas se automatizares a emissão, um único pedido cria a atribuição (e a imagem baked vem com ela). Substitui a chave e o id do emblema pelos teus:
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}`;
A chamada devolve HTTP 200 com { "awardId": "<guid>" }. Constrói o URL de verificação a partir desse id. Para a configuração de chaves e a referência completa dos pedidos, consulta a documentação da API de Awards e o guia de autenticação.

Conselhos práticos para emissores
Publica sempre uma ligação de verificação junto do ficheiro. Coloca a ligação no e-mail da atribuição, no certificado e em qualquer página onde o emblema seja apresentado. Como as plataformas sociais removem os metadados, a ligação é o que mantém a credencial verificável depois de partilhada.
Usa uma imagem de origem limpa e com tamanho adequado. Parte de um PNG com dimensões reais. Um emblema criado por um designer, em resolução normal, faz baking de forma fiável; um marcador de 1 píxel não.
Não edites o ficheiro entregue. Diz aos destinatários para partilharem o download original ou a ligação de verificação, não uma captura de ecrã recortada.
Decide o que queres dizer sobre revogação e expiração. Como o registo alojado é a autoridade, um ficheiro baked pode sobreviver ao estado da credencial. Di-lo com clareza na documentação do teu programa, para que os empregadores saibam que devem consultar a página de verificação em vez de confiar apenas no ficheiro.
Testa um emblema de ponta a ponta. Emite uma atribuição para ti, descarrega o PNG, passa-o pelo script acima ou por um validador público e abre a ligação de verificação. Cinco minutos de testes mostram-te o que os teus destinatários vão viver.

Perguntas frequentes
Um emblema baked é o mesmo que um certificado digital? Não. Um certificado é normalmente um PDF para ler e imprimir. Um emblema baked é uma imagem que também transporta dados de credencial legíveis por máquina. https://badges.ninja produz ambos a partir da mesma atribuição.
Posso fazer baking de um emblema sem uma plataforma? Sim. A especificação é aberta e existem bibliotecas para várias linguagens. O mais difícil é alojar a asserção num URL estável, que é o que torna a verificação significativa. É essa a parte que uma plataforma trata por ti.
O baking expõe o e-mail do destinatário? Não, quando a identidade tem hash. A asserção guarda um hash com salt, por isso o ficheiro não revela o endereço.
O LinkedIn lê os dados baked? O fluxo Add to Profile do LinkedIn funciona a partir do nome da credencial, do emissor, da data e do URL, e não dos metadados do ficheiro. Consulta como adicionar um botão Add to LinkedIn.
Resumo
Um Open Badge baked é um PNG (ou SVG) com a credencial escrita num chunk de texto chamado openbadges. Torna um emblema portátil e autodescritivo, mas a verdadeira confiança vem da asserção alojada no domínio do emissor. Faz baking pela portabilidade, publica uma ligação de verificação pela confiança e conta que as redes sociais removam os metadados.
Pronto para emitir a tua primeira credencial verificável? Começa grátis em badges.ninja — designer visual, página de verificação pública, certificado em PDF, saída Open Badge v2.0. Sem cartão de crédito.
Como este artigo foi feito
Alguns artigos deste blog são redigidos com a ajuda de um assistente de IA e depois revistos, verificados e editados pela equipa da Badges Ninja antes da publicação. Todos os exemplos de código e preços são verificados no produto em produção. Saiba mais sobre o nosso processo editorial e de IA na nossa página do processo editorial .

Sobre o autor
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.
Mais de Nacho Coll
- Open Badges para bootcamps de programação: emitir credenciais verificáveis à escala de uma turma19/11/2026 · 12min de leitura
- Configurar webhooks para eventos de emblemas: integração em tempo real com o teu backend16/11/2026 · 10min de leitura
- Expiração e renovação de Open Badges: gestão do ciclo de vida de credenciais com prazo de validade12/11/2026 · 12min de leitura


