Open Badge Baking Açıklaması: JSON, PNG'nin İçinde Nasıl Yaşar?

„Pişirilmiş“ (baked) bir Open Badge, assertion JSON'unun görsel meta verisi olarak gömüldüğü bir PNG'dir. Rozet dosyası kimlik bilgisinin KENDİSİDİR. Baking nasıl çalışır ve pişirilmiş rozet nasıl doğrulanır?

Nacho Coll Yazan Güncellendi 9 dk okuma
„Pişirilmiş“ (baked) bir Open Badge, assertion JSON'unun görsel meta verisi olarak gömüldüğü bir PNG'dir. Rozet dosyası kimlik bilgisinin KENDİSİDİR. Baking nasıl çalışır ve pişirilmiş rozet nasıl doğrulanır?

Neredeyse herhangi bir düzenleyiciden bir Open Badge indirdiğinizde, sıradan görünen bir PNG elde edersiniz. Onu bir sohbete bırakın, e-postaya ekleyin, yazdırın. Diğer görseller gibi görünür. Ancak dosya ikinci, görünmez bir katman taşır: kimlik bilgisinin kendisi, görselin içine meta veri olarak yazılmıştır. Open Badges topluluğu buna pişirilmiş rozet (baked badge) der ve bir rozetin tek dosya olarak dolaşıp yine de kimin, kime, ne için verdiğini kanıtlayabilmesinin nedeni budur.

Bu rehber baking’in ne olduğunu, verinin dosyanın neresinde durduğunu, bir doğrulayıcının onu nasıl geri okuduğunu ve kimlik bilgisi veren biri olarak neye karar vermeniz gerektiğini anlatır. Pişirilmiş rozetleri kullanmak için kod yazmanız gerekmez. https://badges.ninja üzerinden düzenliyorsanız baking sizin yerinize yapılır. Ama mekaniği anlamak, alıcıların ve işverenlerin gerçekten sorduğu soruları yanıtlamanıza yardımcı olur: „Bu görsel gerçek mi?“ ve „Herkes kopyalayamaz mı?“

„Baking“ ne demek?

Bir Open Badge’in karıştırılması kolay iki parçası vardır:

  • Resim. İnsanların profilde, sunumda veya sertifikada gördüğü PNG ya da SVG.
  • Assertion. Gerçekleri belirten küçük bir JSON belgesi: alıcının kim olduğu (karma bir tanımlayıcı olarak), hangi rozet sınıfının kazanıldığı, kimin verdiği, ne zaman verildiği ve nerede doğrulanacağı.

Baking, assertion’ı resmin içine, ikisi ayrılamayacak biçimde yazma eylemidir. Sonuç tek bir dosyadır. Birine PNG’yi verdiğinizde, hem görseli hem de arkasındaki iddiayı vermiş olursunuz.

Fikir, aslen Mozilla tarafından geliştirilen ve şimdi 1EdTech tarafından sürdürülen Open Badges belirtiminden gelir. Tasarımın amacı taşınabilirliktir. Başlarda rozetler tek bir platformun içinde yaşıyordu ve yeni bir yere taşımak, yeniden yüklemek ve meta verinin sağ kalmasını ummak demekti. Pişirilmiş bir dosya meta verisini gittiği her yere taşır.

JSON, PNG’nin neresinde durur?

Bir PNG dosyası, kısa bir imzayı izleyen chunk (parça) dizisinden oluşur. Her chunk’ın bir uzunluğu, dört harfli bir türü, verisi ve bir sağlama toplamı vardır. Görüntüleyiciler pikselleri IDAT chunk’larından çizer ve anlamadıkları chunk türlerini yok sayar. Baking’i mümkün kılan bu hoşgörüdür: metin dolu bir chunk ekleyebilirsiniz ve dünyadaki her görüntüleyici resmi yine normal biçimde gösterir.

Open Badges 2.0’da assertion, openbadges anahtar sözcüğüne sahip bir metin chunk’ına girer. Onu tutabilen metin chunk türleri şunlardır:

ChunkKodlamaNotlar
tEXtLatin-1Basit, ancak Latin-1 karakterleriyle sınırlı.
iTXtUTF-8Tercih edilen; çünkü adlar ve açıklamalar çoğu zaman ASCII değildir.

Hangi chunk kullanılırsa kullanılsın düzen aynıdır: openbadges anahtar sözcüğü, bir ayırıcı, ardından yük (payload). Yük, düzenleyicinin nasıl pişirdiğine bağlı olarak iki şeyden biridir:

  1. Assertion JSON’unun kendisi. Dosya kendini tanımlar. Doğrulayıcı iddiayı hiçbir ağ çağrısı yapmadan okuyabilir.
  2. Barındırılan assertion’ı gösteren bir URL. Dosya daha küçüktür ve düzenleyici, canlı kaydı yetkili tutabilir; örneğin bir rozetin sonradan iptal edildiğini veya süresinin dolduğunu göstermek için.

İmzalı rozetler için üçüncü bir varyant vardır: yük, düz JSON yerine imzalı bir belirteçtir. Kullanım durumunuzda imzalar önemliyse bir Open Badge imzasının nasıl doğrulanacağını okuyun.

Peki ya SVG?

SVG rozetleri de pişirilebilir, çünkü SVG bir XML’dir. Assertion, dosyanın içinde openbadges XML ad alanındaki bir öğeye yerleştirilir ve verify niteliği barındırılan assertion’ın URL’sini taşır. İlke PNG ile aynıdır: meta veri görsel dosyasının içinde yolculuk eder. Pratikte çoğu platform PNG pişirir, çünkü PNG insanların rozet yüklemek istediği hemen her yerde kabul edilir.

Gömülü assertion neye benzer?

2.0 biçiminde barındırılan bir assertion; alıcıyı, rozet sınıfını ve doğrulama yöntemini birbirine bağlayan bir JSON-LD’dir. Kısaltılmış bir örnek:

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

Alıcıya dikkat edin. E-posta açık metin olarak saklanmaz; tuzlanmış bir SHA-256 karmasıdır. Elden ele dolaşması amaçlanan bir dosya için bu önemlidir. PNG’ye sahip herkes assertion’ı okuyabilir, bu yüzden assertion alıcının adresini sızdırmamalıdır. E-postayı zaten bilen bir doğrulayıcı onu aynı tuzla karmalayıp eşleşip eşleşmediğini kontrol edebilir. Bu belgenin alan alan gezintisi için Open Badge JSON-LD incelemesine bakın.

Doğrulayıcı pişirilmiş rozeti nasıl okur?

Pişirilmiş bir rozetin doğrulanması kısa ve mekanik bir süreçtir:

  1. PNG’yi açın ve chunk’larını dolaşın.

  2. openbadges anahtar sözcüklü metin chunk’ını bulun.

  3. Yükü okuyun. JSON ise ayrıştırın. URL ise getirin.

  4. Assertion’ın beklediğiniz rozet sınıfına ve düzenleyiciye atıfta bulunduğunu ve alıcı kimliğinin rozeti sunan kişiyle eşleştiğini kontrol edin.

  5. Doğrulama türü hosted ise, barındırılan assertion’ın id URL’sinde hâlâ var olduğunu ve iptal edilmediğini ya da süresinin dolmadığını doğrulayın.

  6. adım insanların atladığı adımdır ve bir kimlik bilgisini güvenilir kılan da odur. Gömülü kopya bir anlık görüntüdür. Gerçeğin kaynağı barındırılan kayıttır.

Node ile kendiniz okuyun

Kısa bir betikle herhangi bir PNG’yi inceleyebilirsiniz. Bu betik chunk’ları dolaşır ve hem tEXt hem de iTXt türlerini işleyerek openbadges yükünü yazdırır:

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 komutuyla çalıştırın. Dosya pişirilmişse JSON ya da bir URL görürsünüz. Değilse sade bir „not baked“ iletisi alırsınız. Bu bir öğretim aracıdır, tam bir doğrulayıcı değil: chunk sağlama toplamlarını denetlemez, imzalı yükleri ayrıştırmaz ve barındırılan kaydı getirmez.

Kod yazmak istemiyorsanız, çevrimiçi bir rozet doğrulayıcı veya PNG meta veri görüntüleyici aynı chunk’ı gösterir. Biçim standarttır; dolayısıyla uyumlu her araç uyumlu her rozeti okur.

Baking neden önemli?

Taşınabilirlik. Yalnızca bir PNG olan kimlik bilgisi e-postayla gönderilebilir, bir öğrenme platformuna yüklenebilir ya da kişisel arşivde saklanabilir. Taşımak için hesap gerekmez.

Düzenleyicinin pazarlama sitesinden daha uzun yaşayan bir doğrulama yolu. Gömülü assertion düzenleyiciyi adıyla anar ve barındırılan kayda işaret eder; böylece doğrulayıcı yalnızca dosyadan yola çıkabilir.

Çevrimdışı ve düşük teknolojili iş akışları. Yük tam JSON olduğunda, okuyucu iddiayı ağı olmayan bir makinede denetleyebilir, barındırılan kaydı daha sonra doğrulayabilir.

Gelişigüzel taklit edilmesi zor kanıt. Herkes bir rozetin ekran görüntüsünü alabilir. Ekran görüntüsünün meta verisi yoktur; bu yüzden rozet dosyası olarak doğrulanamaz. Gerçek bir kimlik bilgisini kopyalanmış bir görselden ayıran şey yalnızca bu bile olabilir. Yine de birinin çalınmış bir resme sahte bir assertion pişirmesini engellemez; barındırılan doğrulama adımı bu yüzden vardır.

Baking’in sınırları

Bunlar konusunda alıcılarınıza karşı dürüst olun, çünkü kimlik bilgilerinizi nasıl tanımladığınızı etkilerler.

  • Meta veri silinir. Birçok sosyal ağ, görsel optimize edici ve mesajlaşma uygulaması yüklemeleri yeniden kodlar ve piksel olmayan chunk’ları atar. Sosyal akışa gönderilen pişirilmiş bir rozet genellikle artık pişirilmiş değildir. Bu beklenen bir durumdur ve dosyanın yanında herkese açık bir doğrulama bağlantısının önemli olmasının nedeni budur.
  • Baking tek başına kanıt değildir. Gömülü JSON’u herkes yazabilir. Güven, düzenleyicinin alan adındaki barındırılan assertion’dan veya geçerli bir imzadan gelir.
  • Görsel düzenlemeleri bağı koparır. Bir düzenleyicide yeniden boyutlandırmak veya yeniden kaydetmek chunk’ı kaybettirebilir.
  • Yalnızca PNG ve SVG. JPEG için belirtimde eşdeğer bir chunk kuralı yoktur; bu yüzden JPEG olarak dışa aktarılan fotoğraf tarzı bir rozet standart yolla pişirilemez.

Pratik sonuç: pişirilmiş dosyayı kullanışlı bir taşıyıcı, doğrulama sayfasını ise otorite olarak görün. Programınız için biçimleri tartıyorsanız, Open Badges ve PDF sertifikaları yazısı, makine tarafından okunabilir bir kimlik bilgisinin neden statik bir belgeden üstün olduğunu anlatır.

https://badges.ninja üzerinde baking nasıl çalışır?

https://badges.ninja üzerinde bir rozet verdiğinizde platform, o alıcı için Open Badge assertion’ını oluşturur ve düzenleme işleminin parçası olarak rozet görseline pişirir. Bir araç yapılandırmanız ya da komut çalıştırmanız gerekmez. Akış şöyledir:

  1. Rozeti görsel tasarımcıda tasarlarsınız veya kendi görselinizi yüklersiniz.
  2. Panodan, toplu ödüller için CSV yüklemesinden ya da API üzerinden bir ödül düzenlersiniz.
  3. Platform assertion’ı oluşturur, PNG’ye pişirir ve sonucu ödülle birlikte saklar.
  4. Alıcı https://badges.ninja/awards/<awardId> adresinde herkese açık bir doğrulama sayfası, bir PDF sertifika, bir QR kod ve LinkedIn’e Ekle seçeneği alır.

Rozet tasarımı alıcının adı gibi birleştirme alanları kullanıyorsa her ödül kişiselleştirilmiş bir görsel alır ve pişirilen de bu kişiselleştirilmiş görseldir.

Baking, düzenlemenin bir geçidi değil, ona yapılan bir iyileştirme olarak ele alınır: belirli bir görsel pişirilemiyorsa (örneğin bozuk bir yer tutucu görsel), ödül yine de özgün görselle düzenlenir; herkese açık doğrulama sayfası ve Open Badge JSON-LD etkilenmez. Yüklediğiniz görsel ayrıca asgari bir boyutu da geçmelidir; bu yüzden minicik boş bir tuval fırına ulaşmadan reddedilir.

Otorite herkese açık sayfa olduğu için herkes kayıt olmadan bir ödülü kontrol edebilir. Bir ödülün makine tarafından okunabilir Open Badge v2.0 JSON-LD’si https://api.badges.ninja/certify-badge/award/<awardId> adresinde bulunur.

API ile tek bir ödül düzenleme

Çoğu okuyucu panoyu kullanacaktır, ancak düzenlemeyi otomatikleştiriyorsanız tek bir istek ödülü oluşturur (pişirilmiş görsel de onunla gelir). Anahtarı ve rozet kimliğini kendinizinkilerle değiştirin:

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ğrı HTTP 200 ile { "awardId": "<guid>" } döndürür. Doğrulama URL’sini bu kimlikten oluşturun. Anahtar kurulumu ve tam istek başvurusu için Awards API belgelerine ve kimlik doğrulama rehberine bakın.

Badge detail screen in the https://badges.ninja dashboard

Düzenleyiciler için pratik öneriler

Dosyanın yanında her zaman bir doğrulama bağlantısı yayımlayın. Bağlantıyı ödül e-postasına, sertifikaya ve rozetin görüntülendiği her sayfaya koyun. Sosyal platformlar meta veriyi sildiği için, paylaşımdan sonra kimlik bilgisini doğrulanabilir tutan bağlantıdır.

Temiz ve yeterince büyük bir kaynak görsel kullanın. Gerçek boyutlara sahip bir PNG ile başlayın. Normal çözünürlükte, tasarımcı yapımı bir rozet güvenilir biçimde pişer; 1 piksellik bir yer tutucu pişmez.

Teslim edilen dosyayı düzenlemeyin. Alıcılarınıza kırpılmış ekran görüntüsü değil, özgün indirmeyi ya da doğrulama bağlantısını paylaşmalarını söyleyin.

İptal ve süre dolumu hakkında ne söyleyeceğinize karar verin. Barındırılan kayıt yetkili olduğundan, pişirilmiş bir dosya kimlik bilgisinin durumundan daha uzun yaşayabilir. İşverenlerin yalnızca dosyaya güvenmek yerine doğrulama sayfasına bakmayı bilmesi için bunu program belgelerinizde açıkça belirtin.

Bir rozeti baştan sona test edin. Kendinize bir ödül düzenleyin, PNG’yi indirin, yukarıdaki betikten veya herkese açık bir doğrulayıcıdan geçirin ve doğrulama bağlantısını açın. Beş dakikalık test, alıcılarınızın ne yaşayacağını size gösterir.

List of badges in the https://badges.ninja dashboard

Sık sorulan sorular

Pişirilmiş rozet dijital sertifikayla aynı şey midir? Hayır. Sertifika genellikle okumak ve yazdırmak için bir PDF’tir. Pişirilmiş rozet ise makine tarafından okunabilir kimlik bilgisi verisi de taşıyan bir görseldir. https://badges.ninja ikisini de aynı ödülden üretir.

Platform olmadan rozet pişirebilir miyim? Evet. Belirtim açıktır ve birkaç dil için kütüphaneler vardır. Daha zor olan kısım, assertion’ı sabit bir URL’de barındırmaktır; doğrulamayı anlamlı kılan da budur. Platformun sizin yerinize üstlendiği kısım budur.

Baking alıcının e-postasını açığa çıkarır mı? Kimlik karmalandığında hayır. Assertion tuzlanmış bir karma saklar, dolayısıyla dosya adresi ifşa etmez.

LinkedIn pişirilmiş veriyi okur mu? LinkedIn’in Profile Ekle akışı, dosya meta verisi yerine kimlik bilgisi adı, düzenleyici, tarih ve URL üzerinden çalışır. Bkz. LinkedIn’e Ekle düğmesi eklemek.

Özet

Pişirilmiş bir Open Badge, kimlik bilgisinin openbadges adlı bir metin chunk’ına yazıldığı bir PNG’dir (veya SVG’dir). Rozeti taşınabilir ve kendini tanımlayan hâle getirir; ancak gerçek güven, düzenleyicinin alan adındaki barındırılan assertion’dan gelir. Taşınabilirlik için pişirin, güven için bir doğrulama bağlantısı yayımlayın ve sosyal ağların meta veriyi sileceğini bekleyin.

İlk doğrulanabilir kimlik bilginizi düzenlemeye hazır mısınız? badges.ninja’da ücretsiz başlayın — görsel tasarımcı, herkese açık doğrulama sayfası, PDF sertifika, Open Badge v2.0 çıktısı. Kredi kartı gerekmez.

Nacho Coll

Yazar hakkında

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.

Blog'a Dön

İlgili Yazılar