Kuinka mitätöit Open Badgen (ja mitä saajan kopiolle tapahtuu)
Mitätöinti Open Badgesissa: miten se toimii, mikä muuttuu saajalle ja oikea tapa käsitellä ”myönnetty vahingossa”, ”todistus on vanhentunut” ja ”sääntörikkomus” -tilanteet.
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.
Ennemmin tai myöhemmin jokaisen digitaalisia todistuksia myöntävän ohjelman on otettava jokin niistä takaisin. Sertifikaatti meni väärälle henkilölle. Oppijan havaittiin huijanneen loppuarvioinnissa. Kumppanisopimus päättyi, eikä ”Certified Partner” -merkkien pitäisi enää olla voimassa. Myöntäminen on helppo osa; mitätöinti ratkaisee, voiko todistuksiisi todella luottaa.
Tämä opas selittää, miten mitätöinti toimii Open Badgesissa, mitä saaja näkee ja mitä ei näe sen jälkeen, ja miten mitätöit yhden todistuksen tai satoja osoitteessa https://badges.ninja, hallintapaneelista tai API:n kautta.
Mitä ”mitätöinti” tarkoittaa Open Badgesissa
Open Badges v2.0 -määrittelyssä jokainen myönnetty merkki on assertion: julkisessa URL-osoitteessa sijaitseva pieni JSON-LD-dokumentti, jonka mukaan ”tämä myöntäjä myönsi tämän merkin tälle saajalle tänä päivänä.” Mitätöinti on yksinkertaisesti muutos tähän isännöityyn dokumenttiin. Assertioniin lisätään "revoked": true ja halutessa "revocationReason"-merkkijono, joka kertoo syyn.
Tällä rakenteella on tärkeä seuraus, joka yllättää monet ohjelmien omistajat:
- Isännöity assertion on totuuden lähde. Jokainen, joka varmentaa todistuksen hakemalla assertionin URL-osoitteen tai avaamalla varmennussivun, näkee mitätöidyn tilan heti.
- Kopioita ei kutsuta takaisin. Jos saaja on ladannut merkin kuvan tai JSON-tiedoston tai kiinnittänyt sen portfolioonsa, kyseinen tiedosto ei muutu. Se sisältää yhä linkin takaisin isännöityyn assertioniisi, joten linkkiä seuraava varmentaja näkee sen mitätöidyksi, mutta tallennettua PNG-kuvaa vilkaiseva ihminen ei.
Mitätöinti on siis lausuma, joka annetaan varmennuksen päätepisteessä, ei poisto. Ajattele sitä niin, että pääasiakirjaan lyödään ”MITÄTÖITY”-leima sen sijaan, että jahtaisit jokaista valokopiota.
Jos haluat tarkastella itse dokumenttia lähemmin, Open Badge JSON-LD -läpikäyntimme käy läpi jokaisen kentän.
Mitätöi, myönnä uudelleen vai poista: valitse oikea toimenpide
Ennen kuin klikkaat mitään, päätä, mikä kolmesta toimenpiteestä sopii tilanteeseen. Ne eivät ole keskenään vaihdettavissa.
| Tilanne | Paras toimenpide | Miksi |
|---|---|---|
| Todistus myönnettiin väärälle henkilölle tai siinä oli kirjoitusvirhe | Poista (jos sitä ei koskaan lähetetty) tai Mitätöi ja myönnä sitten uudelleen | Poisto poistaa tietueen kokonaan; mitätöinti säilyttää tarkastusjäljen |
| Oppija rikkoi sääntöjä tai todistus hankittiin epäasianmukaisesti | Mitätöi, syyn kera | Tietue pysyy varmennettavana mitätöitynä, mitä haluat riitatilanteessa |
| Todistus vain saavutti päättymispäivänsä | Älä tee mitään; aseta vanhenemispäivä myöntäessäsi | Vanheneminen on normaali elinkaaren tapahtuma, ei mitätöinti |
| Ohjelma peruttu, kohortti mitätöity | Joukkomitätöinti | Yksi työ, yksi syy, sovellettuna kaikkiin |
| Tiedot olivat virheelliset, mutta todistus on muuten pätevä | Muokkaa ennen lähettämistä tai mitätöi ja myönnä uudelleen lähettämisen jälkeen | Pitää saajan kokemuksen siistinä |
Kaksi nyrkkisääntöä:
- Suosi mitätöintiä poiston sijaan kaikessa todellisessa. Poistetun todistuksen julkinen sivu palauttaa ”ei löydy” -virheen. Mitätöity todistus aukeaa yhä ja kertoo selvästi olevansa mitätöity, mikä on paljon parempi todiste, jos joku myöhemmin kysyy, mitä tapahtui.
- Älä koskaan käytä mitätöintiä vanhenemisen korvikkeena. Jos todistus on voimassa vain kaksi vuotta, aseta vanhenemispäivä sitä myöntäessäsi. Merkki, joka hiljaa raukeaa, on eri asia kuin peruutettu merkki, ja varmennussivusi pitäisi kertoa, kumpi on kyseessä.
Mitätöinti hallintapaneelista
Muutaman todistuksen kohdalla hallintapaneeli on nopein tapa, eikä se vaadi koodia.
- Kirjaudu sisään ja avaa sivupalkista Awards.
- Etsi todistus. Luettelo näyttää saajan, merkin nimen, myöntöpäivän ja vanhenemisen, ja voit hakea saajan mukaan.
- Klikkaa riviä (tai View) avataksesi todistuksen tietoikkunan.
- Klikkaa Revoke.
- Vahvistusikkunassa voit halutessasi kirjoittaa syyn ja halutessasi rastittaa kohdan Email the recipient that their credential was revoked.
- Vahvista.

Todistus pysyy luettelossasi punaisen Revoked-merkin kera saajan vieressä, joten sinä ja tiimisi näette aina, mitä on peruutettu. Mitätöinti ei palauta todistusta suunnitelmasi kiintiöön. Myönsit sen, joten se laskettiin mukaan.
Huomio syy-kentästä
Syy on valinnainen, mutta täytä se. Se tallennetaan todistuksen mukana, näkyy julkisessa Open Badges -assertionissa kenttänä revocationReason ja sisältyy järjestelmiesi vastaanottamaan webhook-payloadiin. Koska se on julkinen assertionissa, kirjoita se kuin ulkopuoliselle lukijalle. ”Myönnetty vahingossa” tai ”Ohjelma peruttu” on hyvä. ”Jane huijasi kysymyksessä 14” ei ole. Pidä henkilökohtaiset tiedot omissa tiedoissasi ja julkinen syy neutraalina.
Pitäisikö saajalle lähettää sähköpostia?
Yleensä kyllä. Oppijalla, joka saa tietää todistuksensa kuolleen vasta, kun työnantaja klikkaa varmennuslinkkiä, on täysi oikeus olla tyytymätön sinuun. Ilmoitus on vapaaehtoinen juuri siksi, että jotkin mitätöinnit (esimerkiksi testimyöntöjen joukkosiivous) eivät tarvitse vaivata ketään. Suosituksemme:
- Lähetä sähköposti, kun mitätöinti koskee oikeaa ihmistä, joka saattaa yhä esitellä todistusta.
- Jätä sähköposti pois, kun siivoat sisäisiä testitietoja tai mitätöit todistuksia, joita ei koskaan lähetetty.
Monen todistuksen mitätöinti kerralla
Ohjelmien tarvitsee harvoin mitätöidä yksittäistä todistusta erikseen; useammin kyse on koko kohortista. Awards-luettelossa:
- Rastita todistukset, jotka haluat peruuttaa.
- Klikkaa Revoke selected joukkotoimintojen palkissa.
- Lisää syy, päätä ilmoitetaanko saajille ja vahvista.
Joukkomitätöinti suoritetaan kestävänä taustatyönä, joten muutama sata todistusta ei aiheuta selaimen välilehden aikakatkaisua. Jo mitätöidyt todistukset ohitetaan sen sijaan, että koko erä epäonnistuisi, ja kesken keskeytynyt työ voidaan jatkaa. Sama koneisto pyörittää joukkomyöntöä laskentataulukosta, jota käsittelemme artikkelissa kuinka myönnät Open Badges -merkit CSV-tiedostosta.
Mitätöinti API:n kautta
Jos oppimisjärjestelmäsi tai HR-alustasi päättää, kuka ei enää ole sertifioitu, voit mitätöidä ohjelmallisesti. Päätepiste on POST /awards/{awardId}/revoke, ja se todennetaan API-avaimella (X-Api-Key: bws_<32-hex>) tai Cognito Bearer -tokenilla. Award-ID annetaan polussa; reason ja notify annetaan JSON-bodyssa, ja molemmat ovat valinnaisia.
curlilla:
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>"}
JavaScriptillä:
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
Ja Pythonilla:
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
Joitakin käytännön yksityiskohtia, jotka kannattaa tietää:
- Se on idempotentti. Jo mitätöidyn todistuksen mitätöinti palauttaa saman onnistumisvastauksen eikä lähetä toista ilmoitusta. Siksi sitä on turvallista kutsua uudelleenyrittävästä työstä.
- Syyt typistetään 500 merkkiin.
notifyon oletuksena false. Mitään ei lähetetä sähköpostitse, ellet pyydä.- Joukkomitätöinti on saatavilla joukkopäätepisteen kautta arvolla
action: "revoke"ja award-ID:iden luettelolla; se palauttaa työn ID:n, jota voit seurata. Täydet parametrit löytyvät awards-API-viitteestä.
Tarvitset API:a vain, kun mitätöintiä ohjaa jokin toinen järjestelmä. Kertaluonteiseen tarpeeseen hallintapaneeli on nopeampi, ja siinä on vahvistusvaihe, joka suojaa väärin kirjoitetulta ID:ltä.
Mitä saaja ja varmentaja näkevät
Kun olet mitätöinyt, nämä asiat muuttuvat, ja näin nopeasti.
Julkisella varmennussivulla. Osoitteen https://badges.ninja/awards/<award-id> sivu näyttää todistuksen mitätöitynä, ja sosiaalisen jakamisen sivuotsikon eteen lisätään ”[Revoked]”, jotta jaettu linkki ei näytä esikatselukortissa voimassa olevalta todistukselta.
Open Badges v2.0 -assertionissa. Isännöity JSON osoitteessa https://api.badges.ninja/certify-badge/award/<award-id> sisältää nyt "revoked": true sekä "revocationReason", jos annoit sellaisen. Mitätöidyt assertionit välimuistitetaan vain noin 30 sekunniksi, kun taas voimassa olevat viideksi minuutiksi, joten muutos tavoittaa varmentajat nopeasti.
Open Badges 3.0 -todistuksessa. Mitätöinti kääntää myös todistuksen bitin W3C Bitstring Status Listissä, jonka avulla verifiable credential -lompakot ja varmentajat havaitsevat sen. Lista on välimuistissa lyhyen aikaa, joten muutoksen leviämiseen kuluu noin minuutti. Jos punnitset kahta versiota, lue Open Badges v2 vs v3.
Saajan omassa kopiossa. Heidän lataamansa tiedosto ei muutu mitenkään. Merkin kuva heidän kannettavallaan näyttää samalta. Muuttuu varmennuksen lopputulos: jokainen, joka klikkaa linkistä tai tarkistaa todistuksen ohjelmallisesti, saa mitätöidyn vastauksen. Jos ilmoitit heille, heillä on myös sähköposti, joka kertoo syyn.
LinkedInissä. LinkedIn-profiiliin lisätty todistus on linkki ja metadata, jotka osoittavat takaisin varmennussivullesi. LinkedIn ei seuraa mitätöintiä puolestasi, joten merkintä voi jäädä profiiliin, mutta jokainen linkkiä seuraava päätyy mitätöidylle sivulle. Tämäkin on syy lähettää ilmoitus ja pyytää saajaa poistamaan merkintä.
Kerro omille järjestelmillesi: webhookit
Mitätöinti on harvoin tarinan loppu organisaatiosi sisällä. Oppijan on ehkä menetettävä pääsy yhteisöön, työnantajatietue on ehkä päivitettävä tai CRM-tunniste poistettava. Badges Ninja lähettää credential.revoked-webhook-tapahtuman, kun todistus mitätöidään, ja mukana ovat award-URL ja syy:
{
"awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
"reason": "Issued in error"
}
Tilaa se, niin loppupään järjestelmäsi pysyvät mukana ilman, että kenenkään tarvitsee muistaa päivittää niitä. Käyttöönoton yksityiskohdat ovat webhook-dokumentaatiossa, ja laajemman tapahtumamallin käsittelemme artikkelissa webhookien käyttöönotto merkkitapahtumille.
Yksinkertainen mitätöintikäytäntö, jonka voit ottaa käyttöön tänään
Työkalut ovat helppo puoli. Vaikeampi puoli on päättää etukäteen, milloin mitätöit ja kuka siihen saa ryhtyä. Lyhyt kirjallinen käytäntö estää riitoja myöhemmin. Toimiva pohja:
- Mitätöinnin perusteet. Luettele ne: myönnetty vahingossa, hankittu väärinkäytöksellä, vaatimus ei enää täyty (esimerkiksi jäsenyys raukesi) tai ohjelma peruttu.
- Kuka päättää. Nimeä rooli, ei henkilöä. Rajaa mitätöintioikeus kyseiseen rooliin.
- Ilmoitus. Kerro, että saajille ilmoitetaan sähköpostilla syyn kera, ellei todistusta koskaan toimitettu.
- Valitus. Anna saajille tapa riitauttaa päätös ja kerro, kuinka kauan vastaamiseen kuluu. Jos valitus menestyy, myönnä uusi todistus sen sijaan, että yrittäisit kumota mitätöinnin, jolloin historia pysyy siistinä.
- Kirjaus. Pidä sisäistä muistiinpanoa siitä, kuka mitätöi minkä ja miksi, erillään neutraalista julkisesta syystä.
Julkaise käytäntö samalla sivulla, jolla kuvaat todistuksen, jotta suorittajat tietävät säännöt ennen ilmoittautumista.
Yleisiä virheitä, joita kannattaa välttää
- Poistaminen, vaikka tarkoitit mitätöidä. Poisto on pysyvä eikä sitä voi perua, ja se saa julkisen sivun katoamaan. Käytä sitä aitoihin virheisiin todistuksissa, joita kukaan ei ole nähnyt.
- Yksityisten tietojen laittaminen syyhyn. Se on julkinen assertionissa.
- Odotus, että tallennetut kopiot muuttuvat. Mitätöinti elää varmennuksen päätepisteessä. Pyydä saajia poistamaan todistus profiileistaan ja portfolioistaan.
- Mitätöinti vanhentamisen sijaan. Käytä vanhenemispäivää määräaikaisille todistuksille.
- Hyvityksen olettaminen. Mitätöidyt todistukset lasketaan yhä suunnitelmasi kiintiöön.
- Loppupään järjestelmien unohtaminen. Kytke webhook, jotta pääsyoikeudet ja tietueet seuraavat todistuksen tilaa.
Usein kysytyt kysymykset
Voinko perua mitätöinnin? Et käyttöliittymän kautta. Jos mitätöit vahingossa, myönnä saajalle uusi todistus. Mitätöity jää osaksi tarkastusjälkeä.
Tarvitseeko saajan tehdä jotain? Ei. Jos valitsit ilmoittamisen, he saavat sähköpostin. Muuten muutos tapahtuu hiljaa varmennussivulla.
Toimiiko mitätöinti todistuksille, joita ei koskaan lähetetty? Kyllä, mutta lähettämättömän todistuksen yksinkertaisen virheen kohdalla saatat mieluummin muokata sitä ennen lähettämistä tai poistaa sen, jos kukaan ei ole nähnyt sitä.
Onko mitätöitävien määrälle rajaa? Joukkomitätöinti suoritetaan jatkettavana taustatyönä, joten suuretkin erät käsitellään yhdellä toimenpiteellä yksitellen sijaan.
Näkevätkö työnantajat, että todistus mitätöitiin? Jokainen, joka varmentaa sen julkisen URL-osoitteen tai assertionin kautta, näkee mitätöidyn tilan ja syyn, jos annoit sellaisen.
Yhteenveto
Open Badgen mitätöinti on pieni teko, jolla on todellisia seurauksia luottamukselle. Tee se hallintapaneelista, kun kyse on yksittäisestä todistuksesta, käytä joukkomitätöintiä kohortille ja tartu API:in tai webhookeihin, kun päätös on jonkin toisen järjestelmän hallussa. Pidä syyt neutraaleina, ilmoita niille, joiden täytyy tietää, ja muista, että mitätöinti muuttaa sitä, mitä varmentajat näkevät, ei saajien käsissä jo olevia tiedostoja.
Valmis myöntämään ensimmäisen varmennettavan todistuksesi? Aloita ilmaiseksi osoitteessa badges.ninja — visuaalinen suunnittelutyökalu, julkinen varmennussivu, PDF-sertifikaatti, Open Badge v2.0 -tuloste. Luottokorttia ei tarvita.
Miten tämä artikkeli tehtiin
Osa tämän blogin artikkeleista laaditaan tekoälyavustajan avulla, minkä jälkeen Badges Ninja -tiimi tarkistaa, faktantarkistaa ja muokkaa ne ennen julkaisua. Jokainen koodiesimerkki ja hinta tarkistetaan live-tuotteesta. Lue lisää toimituksellisesta ja tekoälyprosessistamme toimitusprosessin sivulla .

Kirjoittajasta
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.
Lisää käyttäjältä Nacho Coll
- Open Badges koodauskoulutuksiin: varmennettavat todistukset kohortin mittakaavassa19.11.2026 · 8min lukuaika
- Webhookien käyttöönotto merkkitapahtumille: reaaliaikainen integraatio taustajärjestelmääsi16.11.2026 · 7min lukuaika
- Open Badgen voimassaolon päättyminen ja uusiminen: määräaikaisten todistusten elinkaaren hallinta12.11.2026 · 8min lukuaika


