Open Badge Nasıl İptal Edilir (Ve Alıcının Kopyasına Ne Olur)

Open Badges'te iptal: nasıl çalışır, alıcı için ne değişir ve „yanlışlıkla verildi“, „geçerlilik süresi doldu“ ve „politika ihlali“ durumları nasıl doğru yönetilir.

Nacho Coll Yazan Güncellendi 9 dk okuma
Open Badges'te iptal: nasıl çalışır, alıcı için ne değişir ve „yanlışlıkla verildi“, „geçerlilik süresi doldu“ ve „politika ihlali“ durumları nasıl doğru yönetilir.

Dijital kimlik bilgisi veren her program er ya da geç bir tanesini geri almak zorunda kalır. Bir sertifika yanlış kişiye gitmiştir. Bir öğrencinin final değerlendirmesinde kopya çektiği anlaşılmıştır. Bir ortaklık sözleşmesi sona ermiştir ve „Certified Partner“ yazan rozetler artık geçerli olmamalıdır. Düzenleme mutlu yoldur; iptal ise kimlik bilgilerinize gerçekten güvenilip güvenilemeyeceğini belirleyen kısımdır.

Bu rehber, Open Badges’te iptalin nasıl çalıştığını, alıcının sonrasında neyi görüp neyi görmediğini ve https://badges.ninja’da tek bir kimlik bilgisini ya da birkaç yüzünü panodan veya API’den nasıl iptal edeceğinizi açıklar.

Open Badges’te „iptal“ ne demektir

Open Badges v2.0 şartnamesinde verilen her rozet bir assertion’dır: herkese açık bir URL’de barındırılan ve „bu düzenleyici, bu rozeti bu alıcıya bu tarihte verdi“ diyen küçük bir JSON-LD belgesi. İptal, yalnızca barındırılan bu belgede yapılan bir değişikliktir. Assertion’a "revoked": true eklenir ve isteğe bağlı olarak nedenini açıklayan bir "revocationReason" metni girilir.

Bu tasarımın, birçok program sahibini şaşırtan önemli bir sonucu vardır:

  • Barındırılan assertion doğruluk kaynağıdır. Kimlik bilgisini assertion URL’sini getirerek ya da doğrulama sayfasını açarak doğrulayan herkes iptal durumunu hemen görür.
  • Kopyalar geri çağrılmaz. Alıcı rozet görselini veya JSON’u indirdiyse ya da portfolyosuna sabitlediyse, o dosya değişmez. İçinde hâlâ barındırılan assertion’ınıza bir bağlantı vardır; bu yüzden bağlantıyı izleyen bir doğrulayıcı iptali görür, ancak kayıtlı bir PNG’ye göz atan biri görmez.

Dolayısıyla iptal, doğrulama uç noktasında yapılan bir beyandır, silme değildir. Her fotokopinin peşinden koşmak yerine ana kayda „GEÇERSİZ“ damgası vurmak gibi düşünün.

Belgenin kendisine daha yakından bakmak isterseniz Open Badge JSON-LD incelememiz her alanı tek tek ele alıyor.

İptal, yeniden düzenleme veya silme: doğru eylemi seçin

Herhangi bir şeye tıklamadan önce, üç eylemden hangisinin duruma uyduğuna karar verin. Birbirinin yerine kullanılamazlar.

DurumEn iyi eylemNeden
Kimlik bilgisi yanlış kişiye veya yazım hatasıyla verildiSil (hiç gönderilmediyse) veya İptal et, ardından yeniden düzenleSilme kaydı tamamen kaldırır; iptal denetim izini korur
Öğrenci bir politikayı ihlal etti veya kimlik bilgisi usulsüz elde edildiNedenle birlikte İptal etKayıt iptal edilmiş olarak doğrulanabilir kalır; bir anlaşmazlıkta istediğiniz budur
Kimlik bilgisi yalnızca bitiş tarihine ulaştıHiçbir şey yapmayın; düzenlerken bir son kullanma tarihi belirleyinSüre dolması normal bir yaşam döngüsü olayıdır, iptal değildir
Program iptal edildi, grup geçersiz kılındıToplu iptalTek iş, tek neden, herkese uygulanır
Bilgiler yanlıştı ama kimlik bilgisi aksi hâlde geçerliGöndermeden önce düzenle, ya da gönderdikten sonra iptal edip yeniden düzenleAlıcının deneyimini temiz tutar

İki pratik kural:

  1. Gerçek olan her şey için silmek yerine iptali tercih edin. Silinmiş bir kimlik bilgisinin herkese açık sayfası bulunamadı hatası döndürür. İptal edilmiş olan ise çözümlenmeye devam eder ve iptal edildiğini açıkça belirtir; bu, daha sonra biri ne olduğunu sorarsa çok daha iyi bir kanıttır.
  2. İptali asla süre dolumunun yerine kullanmayın. Bir kimlik bilgisi yalnızca iki yıl geçerliyse, düzenlerken bir son kullanma tarihi belirleyin. Sessizce süresi dolan bir rozet, geri çekilen bir rozetten farklıdır ve doğrulama sayfanız hangisi olduğunu söylemelidir.

Panodan iptal etme

Birkaç kimlik bilgisi için pano en hızlı yoldur ve kod gerektirmez.

  1. Oturum açın ve kenar çubuğundan Awards’ı açın.
  2. Kimlik bilgisini bulun. Liste alıcıyı, rozet adını, düzenlenme tarihini ve son kullanma tarihini gösterir; alıcıya göre arama yapabilirsiniz.
  3. Kimlik bilgisi ayrıntı penceresini açmak için satıra (veya View’a) tıklayın.
  4. Revoke’a tıklayın.
  5. Onay iletişim kutusunda isteğe bağlı olarak bir neden girin ve isteğe bağlı olarak Email the recipient that their credential was revoked seçeneğini işaretleyin.
  6. Onaylayın.

Award detail modal

Kimlik bilgisi, alıcının yanında kırmızı bir Revoked etiketiyle listenizde kalır; böylece siz ve ekibiniz nelerin geri çekildiğini her zaman görebilirsiniz. İptal etmek, kimlik bilgisini plan kotanıza iade etmez. Siz düzenlediniz, sayıldı.

Neden alanı hakkında bir not

Neden isteğe bağlıdır ama doldurun. Kimlik bilgisiyle birlikte saklanır, herkese açık Open Badges assertion’ında revocationReason olarak görünür ve sistemlerinizin aldığı webhook yükünde yer alır. Assertion’da herkese açık olduğu için, bir dış okuyucuya yazar gibi yazın. „Hatalı düzenlendi“ veya „Program iptal edildi“ uygundur. „Jane 14. soruda kopya çekti“ uygun değildir. Kişisel ayrıntıları kendi kayıtlarınızda tutun ve herkese açık nedeni tarafsız bırakın.

Alıcıya e-posta göndermeli misiniz?

Genellikle evet. Kimlik bilgisinin geçersiz olduğunu ancak bir işveren doğrulama bağlantısına tıkladığında öğrenen bir öğrencinin size kızmaya her hakkı vardır. Bildirimin isteğe bağlı olmasının nedeni tam da budur: bazı iptallerin (örneğin test ödüllerinin toplu temizliği) kimseyi rahatsız etmesine gerek yoktur. Önerimiz:

  • E-posta gönderin: iptal, kimlik bilgisini hâlâ sergiliyor olabilecek gerçek bir kişiyi etkiliyorsa.
  • E-posta göndermeyin: dahili test verilerini düzenliyorsanız veya hiç gönderilmemiş kimlik bilgilerini geçersiz kılıyorsanız.

Birçok kimlik bilgisini aynı anda iptal etme

Programlar nadiren tek bir kimlik bilgisini tek başına iptal etmek zorunda kalır; çoğu zaman bütün bir grup söz konusudur. Awards listesinde:

  1. Geri çekmek istediğiniz kimlik bilgilerinin onay kutularını işaretleyin.
  2. Toplu eylem çubuğunda Revoke selected’a tıklayın.
  3. Bir neden ekleyin, alıcılara bildirim gönderilip gönderilmeyeceğine karar verin ve onaylayın.

Toplu iptal, dayanıklı bir arka plan işi olarak çalışır; bu yüzden birkaç yüz kimlik bilgisi tarayıcı sekmenizi zaman aşımına uğratmaz. Zaten iptal edilmiş kimlik bilgileri toplu işi başarısız kılmak yerine atlanır ve yarıda kesilen bir iş devam ettirilebilir. Aynı altyapı, bir elektronik tablodan toplu düzenlemeyi de çalıştırır; bunu CSV’den Open Badges nasıl düzenlenir yazımızda anlatıyoruz.

API üzerinden iptal etme

Öğrenme sisteminiz veya İK platformunuz artık kimin sertifikalı olmadığına karar veriyorsa, programatik olarak iptal edebilirsiniz. Uç nokta POST /awards/{awardId}/revoke’tur ve bir API anahtarı (X-Api-Key: bws_<32-hex>) veya bir Cognito Bearer belirteci ile kimlik doğrulaması yapılır. Ödül kimliği yola girer; reason ve notify JSON gövdesine girer ve ikisi de isteğe bağlıdır.

curl ile:

curl -X POST https://api.badges.ninja/awards/<award-id>/revoke \
  -H "X-Api-Key: bws_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Issued to the wrong recipient","notify":true}'
# 200 -> {"revoked":true,"awardId":"<award-id>"}

JavaScript ile:

const res = await fetch(`https://api.badges.ninja/awards/${awardId}/revoke`, {
  method: "POST",
  headers: { "X-Api-Key": API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ reason: "Program cancelled", notify: false }),
});
const { revoked } = await res.json(); // true

Ve Python ile:

import requests
res = requests.post(
    f"https://api.badges.ninja/awards/{award_id}/revoke",
    headers={"X-Api-Key": API_KEY},
    json={"reason": "Program cancelled", "notify": False},
)
print(res.json()["revoked"])  # True

Bilmeye değer bazı pratik ayrıntılar:

  • İdempotenttir. Zaten iptal edilmiş bir kimlik bilgisini iptal etmek aynı başarı yanıtını döndürür ve ikinci bir bildirim göndermez. Bu, onu yeniden deneyen bir işten çağırmayı güvenli kılar.
  • Nedenler 500 karaktere kısaltılır.
  • notify varsayılan olarak false’tur. Siz istemedikçe hiçbir şey e-postayla gönderilmez.
  • Toplu iptal, toplu uç nokta üzerinden action: "revoke" ve bir ödül kimliği listesiyle yapılabilir; takip edebileceğiniz bir iş kimliği döndürür. Tüm parametreler ödüller API başvurusunda yer alır.

API’ye yalnızca iptal başka bir sistem tarafından yönetiliyorsa ihtiyacınız olur. Tek seferlik bir işlem için pano daha hızlıdır ve yanlış yazılmış bir kimliğe karşı sizi koruyan bir onay adımı vardır.

Alıcı ve doğrulayıcı ne görür

İptal ettikten sonra nelerin değiştiği ve ne kadar hızlı değiştiği şöyle.

Herkese açık doğrulama sayfasında. https://badges.ninja/awards/<award-id> adresindeki sayfa kimlik bilgisini iptal edilmiş olarak gösterir ve sosyal paylaşım için sayfa başlığının başına „[Revoked]“ eklenir; böylece paylaşılan bir bağlantı önizleme kartında geçerli bir kimlik bilgisi gibi görünmez.

Open Badges v2.0 assertion’ında. https://api.badges.ninja/certify-badge/award/<award-id> adresinde barındırılan JSON artık "revoked": true içerir; bir neden verdiyseniz "revocationReason" da bulunur. İptal edilmiş assertion’lar yalnızca yaklaşık 30 saniye önbelleğe alınır, canlı olanlar ise beş dakika; böylece değişiklik doğrulayıcılara hızla ulaşır.

Open Badges 3.0 kimlik bilgisinde. İptal ayrıca kimlik bilgisinin bitini bir W3C Bitstring Status List içinde değiştirir; doğrulanabilir kimlik bilgisi cüzdanları ve doğrulayıcıları bunu bu yolla tespit eder. Bu liste kısa süre önbelleğe alınır, dolayısıyla yayılmanın yaklaşık bir dakika içinde gerçekleşmesini bekleyin. İki sürümü kıyaslıyorsanız Open Badges v2 vs v3 yazısına bakın.

Alıcının kendi kopyasında. İndirdiği dosyada hiçbir şey değişmez. Dizüstü bilgisayarındaki rozet görseli aynı görünür. Değişen, doğrulamanın sonucudur: bağlantıya tıklayan veya kimlik bilgisini programatik olarak kontrol eden herkes iptal yanıtını alır. Alıcıya bildirim gönderdiyseniz, nedenini açıklayan bir e-postası da olur.

LinkedIn’de. Bir LinkedIn profiline eklenen kimlik bilgisi, doğrulama sayfanıza işaret eden bir bağlantı ve meta verilerdir. LinkedIn sizin adınıza iptal kontrolü yapmaz, bu yüzden kayıt profilde kalabilir; ancak bağlantıyı izleyen herkes iptal sayfasına ulaşır. Bu, bildirim göndermenin ve alıcıdan kaydı kaldırmasını istemenin bir başka nedenidir.

Kendi sistemlerinize haber verin: webhook’lar

İptal, kuruluşunuzun içinde nadiren hikâyenin sonudur. Öğrencinin bir topluluğa erişimini kaybetmesi, bir işveren kaydının güncellenmesi veya bir CRM etiketinin kaldırılması gerekebilir. Badges Ninja, bir kimlik bilgisi iptal edildiğinde ödül URL’si ve nedenle birlikte bir credential.revoked webhook olayı gönderir:

{
  "awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
  "reason": "Issued in error"
}

Buna abone olun; kimsenin güncellemeyi hatırlamasına gerek kalmadan alt akış sistemleriniz uyumlu kalır. Kurulum ayrıntıları webhook belgelerinde yer alıyor, daha geniş olay modelini ise rozet olayları için webhook kurulumu yazımızda ele alıyoruz.

Bugün benimseyebileceğiniz basit bir iptal politikası

Araçlar işin kolay yarısıdır. Zor yarısı, ne zaman iptal edeceğinize ve bunu kimin yapabileceğine önceden karar vermektir. Kısa yazılı bir politika sonradan çıkacak tartışmaları önler. İşe yarar bir şablon:

  1. İptal gerekçeleri. Sıralayın: hatalı düzenleme, usulsüzlükle elde etme, artık karşılanmayan gereklilik (örneğin üyeliğin sona ermesi) veya geri çekilen program.
  2. Kim karar verir. Bir kişiyi değil, bir rolü belirtin. İptal yetkisini bu rolle sınırlayın.
  3. Bildirim. Kimlik bilgisi hiç teslim edilmediyse dışında, alıcılara nedenle birlikte e-posta ile bildirim yapıldığını belirtin.
  4. İtiraz. Alıcılara kararı itiraz etme yolu verin ve ne kadar sürede yanıt vereceğinizi söyleyin. İtiraz kabul edilirse iptali geri almaya çalışmak yerine yeni bir kimlik bilgisi düzenleyin; böylece geçmiş temiz kalır.
  5. Kayıt. Kimin neyi neden iptal ettiğine dair, herkese açık tarafsız nedenden ayrı bir dahili not tutun.

Politikayı, kimlik bilgisini anlattığınız sayfada yayımlayın; böylece kazananlar kayıt olmadan önce kuralları bilsinler.

Kaçınmanız gereken yaygın hatalar

  • İptal etmek isterken silmek. Silme kalıcıdır, geri alınamaz ve herkese açık sayfayı ortadan kaldırır. Bunu, kimsenin görmediği kimlik bilgilerindeki gerçek hatalar için kullanın.
  • Nedene özel ayrıntılar koymak. Assertion’da herkese açıktır.
  • Kayıtlı kopyaların değişmesini beklemek. İptal doğrulama uç noktasında yaşar. Alıcılara kimlik bilgisini profillerden ve portfolyolardan kaldırmalarını söyleyin.
  • Süre dolumu yerine iptal etmek. Süreli kimlik bilgileri için bir son kullanma tarihi kullanın.
  • İade varsaymak. İptal edilen kimlik bilgileri plan kotanızdan sayılmaya devam eder.
  • Alt akış sistemlerini unutmak. Erişim ve kayıtların kimlik bilgisi durumunu izlemesi için webhook’u bağlayın.

Sıkça sorulan sorular

Bir iptali geri alabilir miyim? Arayüz üzerinden hayır. Yanlışlıkla iptal ettiyseniz alıcıya yeni bir kimlik bilgisi düzenleyin. İptal edilen, denetim izinin bir parçası olarak kalır.

Alıcının bir şey yapması gerekir mi? Hayır. Bildirim göndermeyi seçtiyseniz bir e-posta alır. Aksi hâlde değişiklik doğrulama sayfasında sessizce gerçekleşir.

İptal, hiç gönderilmemiş kimlik bilgileri için de çalışır mı? Evet, ancak basit bir hata içeren gönderilmemiş bir kimlik bilgisini göndermeden önce düzenlemeyi ya da kimse görmediyse silmeyi tercih edebilirsiniz.

Kaç tane iptal edebileceğime dair bir sınır var mı? Toplu iptal, devam ettirilebilir bir arka plan işi olarak çalışır; bu yüzden büyük gruplar tek tek değil, tek bir işlemde ele alınır.

İşverenler bir kimlik bilgisinin iptal edildiğini görür mü? Onu herkese açık URL’si veya assertion’ı üzerinden doğrulayan herkes iptal durumunu ve, verdiyseniz, nedeni görür.

Sonuç

Bir Open Badge’i iptal etmek, güven açısından gerçek sonuçları olan küçük bir eylemdir. Tek bir kimlik bilgisi için panodan yapın, bir grup için toplu iptali kullanın ve karar başka bir sisteme aitse API’ye veya webhook’lara başvurun. Nedenleri tarafsız tutun, bilmesi gerekenlere bildirim gönderin ve iptalin doğrulayıcıların gördüğünü değiştirdiğini, alıcıların elindeki dosyaları değiştirmediğini unutmayın.

İ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