Hogyan vonj vissza egy Open Badge-et (és mi történik a címzett másolatával)
Visszavonás az Open Badges rendszerében: hogyan működik, mi változik a címzett számára, és hogyan kezeld helyesen a „tévedésből kiadott”, a „lejárt” és a „szabálysértés miatti” eseteket.
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.
Előbb-utóbb minden digitális tanúsítványokat kiadó programnak vissza kell vonnia valamit. Egy tanúsítvány rossz emberhez került. Kiderült, hogy egy tanuló csalt a záróvizsgán. Véget ért egy partnerszerződés, és a „Tanúsított partner” feliratú jelvényeknek már nem szabadna érvényesnek lenniük. A kiadás a könnyű rész; a visszavonás dönti el, hogy a tanúsítványaidban tényleg meg lehet-e bízni.
Ez az útmutató elmagyarázza, hogyan működik a visszavonás az Open Badgesben, mit lát és mit nem lát utána a címzett, és hogyan vonhatsz vissza egyetlen tanúsítványt vagy akár több százat a https://badges.ninja oldalon, a vezérlőpultról vagy az API-n keresztül.
Mit jelent a „visszavonás” az Open Badgesben
Az Open Badges v2.0 specifikációban minden kiadott jelvény egy assertion (állítás): egy nyilvános URL-en tárolt kis JSON-LD dokumentum, amely azt mondja: „ez a kibocsátó ezen a napon ennek a címzettnek odaítélte ezt a jelvényt.” A visszavonás egyszerűen e tárolt dokumentum módosítása. Az assertion megkapja a "revoked": true értéket, és opcionálisan egy "revocationReason" szöveget, amely megindokolja a döntést.
Ennek a felépítésnek van egy fontos következménye, amely sok programgazdát meglep:
- A tárolt assertion az igazság forrása. Aki az assertion URL-jének lekérésével vagy az ellenőrzőoldal megnyitásával ellenőrzi a tanúsítványt, azonnal a visszavont állapotot látja.
- A másolatokat nem hívják vissza. Ha a címzett letöltötte a jelvény képét vagy a JSON-t, vagy kitűzte egy portfólióba, az a fájl nem változik. Továbbra is tartalmaz egy hivatkozást a tárolt assertionödre, így az ellenőrző, aki követi a linket, látni fogja a visszavonást, de aki csak ránéz egy elmentett PNG-re, az nem.
A visszavonás tehát az ellenőrzési végponton tett kijelentés, nem törlés. Gondolj rá úgy, mintha a fő nyilvántartásra „ÉRVÉNYTELEN” bélyegzőt ütnél, ahelyett, hogy minden fénymásolatot felkutatnál.
Ha közelebbről is meg akarod nézni magát a dokumentumot, az Open Badge JSON-LD bemutatónk minden mezőt végigvesz.
Visszavonás, újrakiadás vagy törlés: válaszd a megfelelő műveletet
Mielőtt bárhová kattintasz, döntsd el, a három művelet közül melyik illik a helyzethez. Nem felcserélhetők.
| Helyzet | Legjobb művelet | Miért |
|---|---|---|
| A tanúsítvány rossz személynek vagy elírással lett kiadva | Törlés (ha még nem küldted el) vagy visszavonás, majd újrakiadás | A törlés teljesen eltávolítja a rekordot; a visszavonás megőrzi az auditnyomot |
| A tanuló megszegte a szabályzatot, vagy a tanúsítványt helytelenül szerezte | Visszavonás indoklással | A rekord visszavontként ellenőrizhető marad, vita esetén pont erre van szükséged |
| A tanúsítvány egyszerűen elérte a lejárati dátumát | Ne tegyél semmit; kiadáskor állíts be lejáratot | A lejárat a normál életciklus része, nem visszavonás |
| A program megszűnt, a csoport eredményei érvénytelenek | Tömeges visszavonás | Egy művelet, egy indok, mindenkire alkalmazva |
| Az adatok hibásak voltak, de a tanúsítvány egyébként érvényes | Szerkesztés küldés előtt, vagy küldés után visszavonás és újrakiadás | A címzett élménye tiszta marad |
Két ökölszabály:
- Mindennél, ami valós, a visszavonást válaszd a törlés helyett. Egy törölt tanúsítvány nyilvános oldala „nem található” hibát ad. A visszavont még megnyílik, és egyértelműen kimondja, hogy visszavonták, ami sokkal jobb bizonyíték, ha később valaki rákérdez, mi történt.
- Soha ne használd a visszavonást a lejárat helyettesítésére. Ha egy tanúsítvány csak két évig érvényes, kiadáskor állíts be lejárati dátumot. Az a jelvény, amely csendben lejár, más, mint az, amelyet visszavontak, és az ellenőrzőoldalnak meg kell mondania, melyikről van szó.
Visszavonás a vezérlőpultról
Néhány tanúsítványnál a vezérlőpult a leggyorsabb út, és nem kell hozzá kód.
- Jelentkezz be, és nyisd meg az Awards menüpontot az oldalsávban.
- Keresd meg a tanúsítványt. A lista mutatja a címzettet, a jelvény nevét, a kiadás és a lejárat dátumát, és címzett szerint is kereshetsz.
- Kattints a sorra (vagy a View gombra) a tanúsítvány részletes ablakának megnyitásához.
- Kattints a Revoke gombra.
- A megerősítő párbeszédablakban opcionálisan add meg az indoklást, és opcionálisan jelöld be az Email the recipient that their credential was revoked négyzetet.
- Erősítsd meg.

A tanúsítvány bent marad a listádban, a címzett mellett piros Revoked címkével, így te és a csapatod mindig látjátok, mi lett visszavonva. A visszavonás nem írja jóvá a tanúsítványt a csomagod keretéből. Te adtad ki, beleszámított.
Megjegyzés az indoklás mezőről
Az indoklás nem kötelező, de töltsd ki. A tanúsítvánnyal együtt tárolódik, revocationReason-ként megjelenik a nyilvános Open Badges assertionben, és szerepel a rendszereidhez küldött webhook-adatcsomagban is. Mivel nyilvános az assertionben, úgy fogalmazd meg, mintha kívülálló olvasná. A „Tévedésből kiadva” vagy a „A program megszűnt” rendben van. A „Jane csalt a 14. kérdésnél” nem. A személyes részleteket tartsd a saját nyilvántartásodban, a nyilvános indoklás pedig legyen semleges.
Értesítsd a címzettet e-mailben?
Általában igen. Az a tanuló, aki csak akkor tudja meg, hogy a tanúsítványa érvénytelen, amikor egy munkáltató rákattint az ellenőrző linkre, joggal haragszik rád. Az értesítés azért opcionális, mert egyes visszavonásoknál (például a tesztjutalmak tömeges takarításánál) senkit nem kell zavarni. Ajánlásunk:
- Küldj e-mailt, ha a visszavonás olyan valódi személyt érint, aki még mutogathatja a tanúsítványt.
- Hagyd ki az e-mailt, ha belső tesztadatokat rendezel, vagy olyan tanúsítványokat semmisítesz meg, amelyeket sosem küldtek ki.
Sok tanúsítvány visszavonása egyszerre
Egy program ritkán von vissza egyetlen tanúsítványt; sokkal gyakoribb, hogy egy egész csoportot. Az Awards listában:
- Jelöld be a visszavonandó tanúsítványok jelölőnégyzeteit.
- Kattints a Revoke selected gombra a tömeges műveletek sávjában.
- Adj meg indoklást, döntsd el, értesíted-e a címzetteket, majd erősítsd meg.
A tömeges visszavonás tartós háttérfeladatként fut, így néhány száz tanúsítvány sem fogja lefagyasztani a böngészőfület. A már visszavont tanúsítványokat átugorja, ahelyett hogy az egész köteg elbukna, a menet közben megszakadt feladat pedig folytatható. Ugyanez a mechanizmus hajtja a táblázatból történő tömeges kiadást is, erről a hogyan adj ki Open Badge-eket CSV-ből cikkben írunk.
Visszavonás az API-n keresztül
Ha a tanulási rendszered vagy HR platformod dönti el, ki nem tanúsított többé, programozottan is visszavonhatsz. A végpont a POST /awards/{awardId}/revoke, API-kulccsal (X-Api-Key: bws_<32-hex>) vagy Cognito Bearer tokennel hitelesítve. Az award ID az útvonalba kerül; a reason és a notify a JSON törzsbe, és mindkettő opcionális.
curl-lel:
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>"}
JavaScriptben:
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
És Pythonban:
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
Néhány hasznos gyakorlati részlet:
- Idempotens. Egy már visszavont tanúsítvány visszavonása ugyanazt a sikeres választ adja, és nem küld második értesítést. Így biztonságosan hívható újrapróbálkozó feladatból.
- Az indoklások le vannak vágva 500 karakterre.
- A
notifyalapértéke false. Semmi nem megy e-mailben, hacsak nem kéred. - A tömeges visszavonás a bulk végponton érhető el
action: "revoke"értékkel és az award ID-k listájával; egy követhető job ID-t ad vissza. A teljes paraméterlista az awards API referenciában található.
Az API-ra csak akkor van szükséged, ha a visszavonást egy másik rendszer vezérli. Egyedi esetben a vezérlőpult gyorsabb, és van megerősítő lépése, amely megvéd egy elgépelt ID-tól.
Mit lát a címzett és az ellenőrző
A visszavonás után ez változik, és ilyen gyorsan.
A nyilvános ellenőrzőoldalon. A https://badges.ninja/awards/<award-id> oldal visszavontként mutatja a tanúsítványt, a közösségi megosztáshoz használt oldalcím pedig a „[Revoked]” előtagot kapja, hogy egy megosztott link ne tűnjön élő tanúsítványnak az előnézeti kártyán.
Az Open Badges v2.0 assertionben. A https://api.badges.ninja/certify-badge/award/<award-id> címen tárolt JSON mostantól "revoked": true értéket hordoz, és "revocationReason" mezőt, ha adtál meg indoklást. A visszavont assertionök csak körülbelül 30 másodpercig gyorsítótárazódnak, az élők öt percig, így a változás gyorsan eljut az ellenőrzőkhöz.
Az Open Badges 3.0 tanúsítványban. A visszavonás a tanúsítvány bitjét is átbillenti egy W3C Bitstring Status Listben, ezen keresztül ismerik fel a hitelesíthető tanúsítványok tárcái és ellenőrzői. A lista rövid ideig gyorsítótárazódik, így nagyjából egy percen belüli terjedésre számíthatsz. Ha a két verziót mérlegeled, nézd meg az Open Badges v2 vs v3 cikket.
A címzett saját másolatában. A letöltött fájlban semmi nem változik. A jelvény képe a laptopján pontosan ugyanúgy néz ki. Az ellenőrzés eredménye változik: aki rákattint, vagy programozottan ellenőrzi a tanúsítványt, a visszavont választ kapja. Ha értesítetted, kapott egy e-mailt is, amely elmagyarázza az okot.
A LinkedInen. A LinkedIn-profilhoz adott tanúsítvány egy link és metaadatok, amelyek az ellenőrzőoldaladra mutatnak vissza. A LinkedIn nem figyeli helyetted a visszavonást, így a bejegyzés ott maradhat a profilon, de aki követi a linket, a visszavont oldalra jut. Ez is ok arra, hogy elküldd az értesítést, és megkérd a címzettet a bejegyzés eltávolítására.
Értesítsd a saját rendszereidet: webhookok
A visszavonás a szervezetedben ritkán ér véget ennyivel. A tanulónak el kell veszítenie a hozzáférést egy közösséghez, frissíteni kell egy munkáltatói nyilvántartást, vagy el kell távolítani egy CRM-címkét. A Badges Ninja credential.revoked webhook-eseményt bocsát ki, amikor egy tanúsítványt visszavonnak, az award URL-lel és az indoklással:
{
"awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
"reason": "Issued in error"
}
Iratkozz fel rá, és a downstream rendszereid szinkronban maradnak anélkül, hogy bárkinek eszébe kellene jutnia frissíteni őket. A beállítás részletei a webhook dokumentációban vannak, a tágabb eseménymodellről pedig a webhook beállítása jelvényeseményekhez cikkben írunk.
Egy egyszerű visszavonási szabályzat, amelyet ma bevezethetsz
Az eszközök a könnyebbik fele. A nehezebb az, hogy előre eldöntsd, mikor vonsz vissza, és ki jogosult erre. Egy rövid írásos szabályzat megelőzi a későbbi vitákat. Egy használható sablon:
- A visszavonás okai. Sorold fel őket: tévedésből kiadva, helytelen úton szerzett, a követelmény már nem teljesül (például lejárt a tagság), vagy a program megszűnt.
- Ki dönt. Nevezz meg egy szerepkört, ne egy személyt. A visszavonási jogot korlátozd erre a szerepkörre.
- Értesítés. Rögzítsd, hogy a címzetteket e-mailben értesítik az indoklással, kivéve, ha a tanúsítványt soha nem kézbesítették.
- Fellebbezés. Adj a címzetteknek lehetőséget a döntés vitatására, és mondd meg, mennyi időn belül válaszolsz. Ha a fellebbezés sikeres, adj ki új tanúsítványt ahelyett, hogy a visszavonást próbálnád meg semmissé tenni, így a előzmények tiszták maradnak.
- Nyilvántartás. Vezess belső jegyzetet arról, ki mit vont vissza és miért, a semleges nyilvános indoklástól elkülönítve.
Tedd közzé a szabályzatot ugyanazon az oldalon, ahol a tanúsítványt bemutatod, hogy a megszerzők a jelentkezés előtt ismerjék a szabályokat.
Gyakori hibák, amelyeket érdemes elkerülni
- Törlés visszavonás helyett. A törlés végleges, nem vonható vissza, és eltűnik tőle a nyilvános oldal. Valódi hibákra használd, olyan tanúsítványoknál, amelyeket senki nem látott.
- Privát részletek az indoklásban. Az assertionben nyilvános.
- Annak várása, hogy a mentett másolatok megváltoznak. A visszavonás az ellenőrzési végponton él. Kérd meg a címzetteket, hogy távolítsák el a tanúsítványt a profiljaikról és portfólióikból.
- Visszavonás lejárat helyett. Időkorlátos tanúsítványoknál használj lejárati dátumot.
- Visszatérítés feltételezése. A visszavont tanúsítványok továbbra is beleszámítanak a csomagod keretébe.
- A downstream rendszerek elfelejtése. Kösd be a webhookot, hogy a hozzáférések és nyilvántartások kövessék a tanúsítvány állapotát.
Gyakran ismételt kérdések
Visszavonhatom a visszavonást? A felületen keresztül nem. Ha tévedésből vontad vissza, adj ki egy új tanúsítványt a címzettnek. A visszavont az auditnyom részeként megmarad.
Kell tennie valamit a címzettnek? Nem. Ha az értesítés mellett döntöttél, kap egy e-mailt. Egyébként a változás csendben történik az ellenőrzőoldalon.
Működik a visszavonás ki nem küldött tanúsítványokra? Igen, bár egy ki nem küldött, egyszerű hibás tanúsítványt inkább szerkeszthetsz küldés előtt, vagy törölheted, ha senki nem látta.
Van korlátja annak, hányat vonhatok vissza? A tömeges visszavonás folytatható háttérfeladatként fut, így a nagy kötegek egyetlen műveletben, nem egyenként kezelődnek.
Látni fogják a munkáltatók, hogy egy tanúsítványt visszavontak? Aki a nyilvános URL-en vagy az assertionön keresztül ellenőrzi, látja a visszavont állapotot és az indoklást, ha adtál meg.
Összegzés
Egy Open Badge visszavonása kis lépés, de valódi következményekkel jár a bizalomra nézve. Egyetlen tanúsítványnál a vezérlőpultról tedd, egy csoportnál használd a tömeges visszavonást, az API-hoz vagy a webhookokhoz pedig akkor nyúlj, ha egy másik rendszer birtokolja a döntést. Tartsd semlegesen az indoklásokat, értesítsd, akinek tudnia kell, és ne feledd: a visszavonás azt változtatja meg, amit az ellenőrzők látnak, nem a címzettek kezében már meglévő fájlokat.
Készen állsz az első hitelesíthető tanúsítványod kiadására? Kezdd ingyen a badges.ninja-n — vizuális szerkesztő, nyilvános ellenőrzőoldal, PDF-tanúsítvány, Open Badge v2.0 kimenet. Bankkártya nélkül.
Hogyan készült ez a cikk
A blog egyes bejegyzéseit AI-asszisztens segítségével írjuk, majd közzététel előtt a Badges Ninja csapata ellenőrzi, tényellenőrzi és szerkeszti. Minden kódrészletet és árat az élő termékkel egyeztetve ellenőrzünk. Szerkesztési és AI-folyamatunkról bővebben olvashat a szerkesztési folyamat oldalunkon .

A szerzőről
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.
Több cikk tőle: Nacho Coll
- Coding bootcamp Open Badges: ellenőrizhető igazolások kibocsátása évfolyamméretben2026. nov. 19. · 10perc olvasás
- Webhookok beállítása jelvényeseményekhez: valós idejű integráció a backendeddel2026. nov. 16. · 8perc olvasás
- Open Badge lejárat és megújítás: életciklus-kezelés időkorlátos tanúsítványokhoz2026. nov. 12. · 10perc olvasás


