Kaip atšaukti Open Badge (ir kas nutinka gavėjo turimai kopijai)

Atšaukimas Open Badges sistemoje: kaip jis veikia, kas pasikeičia gavėjui ir kaip teisingai elgtis esant atvejams „išduota per klaidą”, „credential nebegalioja” ir „pažeista tvarka”.

Nacho Coll Autorius Atnaujinta 9 min skaitymo
Atšaukimas Open Badges sistemoje: kaip jis veikia, kas pasikeičia gavėjui ir kaip teisingai elgtis esant atvejams „išduota per klaidą”, „credential nebegalioja” ir „pažeista tvarka”.

Anksčiau ar vėliau kiekviena skaitmenines kvalifikacijas išduodanti programa turi kažką atsiimti. Pažymėjimas buvo išsiųstas ne tam žmogui. Paaiškėjo, kad besimokantysis nusirašinėjo per baigiamąjį vertinimą. Pasibaigė partnerystės sutartis, o ženkleliai su užrašu „Certified Partner” nebeturėtų galioti. Išdavimas – tai laimingasis scenarijus; atšaukimas lemia, ar jūsų kvalifikacijomis iš tiesų galima pasitikėti.

Šiame vadove paaiškinama, kaip atšaukimas veikia Open Badges sistemoje, ką gavėjas po to mato ir ko nemato, ir kaip atšaukti vieną kvalifikaciją ar kelis šimtus svetainėje https://badges.ninja – iš valdymo skydelio arba per API.

Ką reiškia „atšaukti“ Open Badges sistemoje

Open Badges v2.0 specifikacijoje kiekvienas išduotas ženklelis yra assertion (patvirtinimas): nedidelis JSON-LD dokumentas, talpinamas viešu URL adresu, kuriame sakoma: „šis išdavėjas šią dieną skyrė šį ženklelį šiam gavėjui“. Atšaukimas – tai tiesiog to talpinamo dokumento pakeitimas. Assertion gauna "revoked": true ir, jei norite, "revocationReason" eilutę, paaiškinančią priežastį.

Dėl tokio sprendimo atsiranda svarbi pasekmė, kuri nustebina daugelį programų vadovų:

  • Talpinamas assertion yra tiesos šaltinis. Kiekvienas, kuris tikrina kvalifikaciją atidarydamas assertion URL ar patikrinimo puslapį, iškart pamato atšauktą būseną.
  • Kopijos neatšaukiamos. Jei gavėjas atsisiuntė ženklelio paveikslėlį ar JSON, arba prisegė jį prie portfolio, tas failas nesikeičia. Jame vis dar yra nuoroda į jūsų talpinamą assertion, todėl tikrintojas, paspaudęs nuorodą, pamatys, kad jis atšauktas, tačiau žmogus, tik žvilgtelėjęs į išsaugotą PNG, to nepamatys.

Taigi atšaukimas yra pareiškimas patikrinimo taške, o ne ištrynimas. Įsivaizduokite, kad ant pagrindinio įrašo uždedate antspaudą „NEGALIOJA“, o ne vaikotės kiekvienos kopijos.

Jei norite atidžiau pažvelgti į patį dokumentą, mūsų Open Badge JSON-LD analizė apžvelgia kiekvieną lauką.

Atšaukti, išduoti iš naujo ar ištrinti: pasirinkite tinkamą veiksmą

Prieš ką nors spausdami nuspręskite, kuris iš trijų veiksmų tinka situacijai. Jie nėra tarpusavyje pakeičiami.

SituacijaGeriausias veiksmasKodėl
Kvalifikacija išduota ne tam asmeniui arba su klaidaIštrinti (jei nebuvo išsiųsta) arba Atšaukti, tada išduoti iš naujoIštrynimas pašalina įrašą visiškai; atšaukimas palieka audito pėdsaką
Besimokantysis pažeidė tvarką arba kvalifikacija įgyta netinkamaiAtšaukti, nurodant priežastįĮrašas lieka patikrinamas kaip atšauktas – būtent to jums reikia ginčo atveju
Kvalifikacijos galiojimas tiesiog pasibaigėNieko nedaryti; išduodami nustatykite galiojimo pabaigąGaliojimo pabaiga yra įprastas gyvavimo ciklo įvykis, o ne atšaukimas
Programa nutraukta, grupė anuliuotaMasinis atšaukimasViena užduotis, viena priežastis, taikoma visiems
Duomenys buvo neteisingi, bet kvalifikacija kitaip galiojaRedaguoti prieš siunčiant arba atšaukti ir išduoti iš naujo po išsiuntimoGavėjo patirtis išlieka tvarkinga

Dvi nykščio taisyklės:

  1. Realiems atvejams verčiau atšaukite, o ne ištrinkite. Ištrintos kvalifikacijos viešas puslapis grąžina klaidą „nerasta“. Atšaukta vis dar atsidaro ir aiškiai nurodo, kad yra atšaukta, o tai yra daug geresnis įrodymas, jei vėliau kas nors paklaustų, kas nutiko.
  2. Niekada nenaudokite atšaukimo vietoj galiojimo pabaigos. Jei kvalifikacija galioja tik dvejus metus, išduodami nustatykite galiojimo pabaigos datą. Ženklelis, kuris tyliai nustoja galioti, skiriasi nuo atšaukto, ir jūsų patikrinimo puslapyje turi būti aišku, kuris iš jų.

Atšaukimas iš valdymo skydelio

Kelioms kvalifikacijoms valdymo skydelis yra greičiausias kelias ir nereikalauja kodo.

  1. Prisijunkite ir šoniniame meniu atidarykite Awards.
  2. Suraskite kvalifikaciją. Sąraše matyti gavėjas, ženklelio pavadinimas, išdavimo data ir galiojimo pabaiga, o paiešką galima atlikti pagal gavėją.
  3. Spustelėkite eilutę (arba View), kad atsidarytų kvalifikacijos išsamios informacijos langas.
  4. Spustelėkite Revoke.
  5. Patvirtinimo lange, jei norite, įveskite priežastį ir, jei norite, pažymėkite Email the recipient that their credential was revoked.
  6. Patvirtinkite.

Award detail modal

Kvalifikacija lieka jūsų sąraše su raudona žyma Revoked šalia gavėjo, todėl jūs ir jūsų komanda visada matote, kas buvo atšaukta. Atšaukimas negrąžina kvalifikacijos į jūsų plano kvotą. Jūs ją išdavėte, ji buvo įskaičiuota.

Pastaba apie priežasties lauką

Priežastis neprivaloma, bet užpildykite ją. Ji saugoma kartu su kvalifikacija, rodoma kaip revocationReason viešame Open Badges assertion ir įtraukiama į webhook turinį, kurį gauna jūsų sistemos. Kadangi ji viešai matoma assertion, rašykite ją taip, lyg skaitytų pašalinis žmogus. „Išduota per klaidą“ arba „Programa nutraukta“ tinka. „Jonė nusirašinėjo per 14 klausimą“ netinka. Asmeninę informaciją laikykite savo įrašuose, o vieša priežastis tebūna neutrali.

Ar verta siųsti gavėjui el. laišką?

Dažniausiai taip. Besimokantysis, kuris sužino, kad jo kvalifikacija nebegalioja, tik tada, kai darbdavys paspaudžia patikrinimo nuorodą, turi visišką teisę būti jumis nepatenkintas. Pranešimas yra pasirenkamas todėl, kad kai kurie atšaukimai (pavyzdžiui, masinis bandomųjų apdovanojimų valymas) nieko netrukdo. Mūsų rekomendacija:

  • Siųskite el. laišką, kai atšaukimas paliečia realų žmogų, kuris vis dar gali rodyti kvalifikaciją.
  • Praleiskite el. laišką, kai tvarkote vidinius bandomuosius duomenis arba anuliuojate kvalifikacijas, kurios niekada nebuvo išsiųstos.

Daugelio kvalifikacijų atšaukimas vienu metu

Programoms retai tereikia atšaukti vieną kvalifikaciją atskirai; dažniau tai visa grupė. Sąraše Awards:

  1. Pažymėkite langelius prie kvalifikacijų, kurias norite atšaukti.
  2. Masinių veiksmų juostoje spustelėkite Revoke selected.
  3. Pridėkite priežastį ir nuspręskite, ar pranešti gavėjams, tada patvirtinkite.

Masinis atšaukimas vykdomas kaip patvari fono užduotis, todėl kelių šimtų kvalifikacijų jūsų naršyklės skirtukas neišjungs dėl laiko limito. Jau atšauktos kvalifikacijos praleidžiamos, o ne nutraukia visos partijos, o pusiaukelėje nutrūkusią užduotį galima tęsti. Tą patį mechanizmą naudoja masinis išdavimas iš skaičiuoklės, apie kurį rašome straipsnyje kaip išduoti Open Badges iš CSV.

Atšaukimas per API

Jei jūsų mokymosi sistema ar personalo platforma nusprendžia, kas nebėra sertifikuotas, galite atšaukti programiškai. Galinis taškas yra POST /awards/{awardId}/revoke, autentifikuojamas API raktu (X-Api-Key: bws_<32-hex>) arba Cognito Bearer žetonu. Apdovanojimo ID nurodomas kelyje; reason ir notify perduodami JSON turinyje, ir abu neprivalomi.

Naudojant curl:

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 kalba:

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

Ir Python kalba:

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

Keletas praktinių detalių, kurias verta žinoti:

  • Operacija idempotentiška. Jau atšaukus kvalifikaciją, ją atšaukti dar kartą grąžinamas tas pats sėkmės atsakas ir antras pranešimas nesiunčiamas. Todėl saugu kviesti iš kartojančios užduoties.
  • Priežastys sutrumpinamos iki 500 simbolių.
  • notify numatytoji reikšmė – false. Niekas nesiunčiama el. paštu, jei neprašysite.
  • Masinis atšaukimas galimas per masinį galinį tašką su action: "revoke" ir apdovanojimų ID sąrašu; jis grąžina užduoties ID, kurį galite sekti. Visi parametrai pateikti awards API nuorodoje.

API reikia tik tada, kai atšaukimą inicijuoja kita sistema. Vienkartiniam atvejui valdymo skydelis greitesnis ir turi patvirtinimo žingsnį, kuris apsaugo nuo klaidingai įvesto ID.

Ką mato gavėjas ir tikrintojas

Atšaukus pasikeičia štai kas ir štai kaip greitai.

Viešame patikrinimo puslapyje. Puslapis adresu https://badges.ninja/awards/<award-id> rodo kvalifikaciją kaip atšauktą, o dalijimosi socialiniuose tinkluose puslapio pavadinimas pradedamas „[Revoked]“, kad bendrinama nuoroda peržiūros kortelėje neatrodytų kaip galiojanti kvalifikacija.

Open Badges v2.0 assertion. Talpinamas JSON adresu https://api.badges.ninja/certify-badge/award/<award-id> dabar turi "revoked": true, o jei nurodėte priežastį – ir "revocationReason". Atšaukti assertion talpinami podėlyje vos apie 30 sekundžių, o galiojantys – penkias minutes, todėl pakeitimas tikrintojus pasiekia greitai.

Open Badges 3.0 kvalifikacijoje. Atšaukimas taip pat perjungia kvalifikacijos bitą W3C Bitstring Status List sąraše – būtent taip jį aptinka verifikuojamųjų kvalifikacijų piniginės ir tikrintojai. Tas sąrašas podėlyje laikomas trumpai, todėl skleidimosi tikėkitės per maždaug minutę. Jei svarstote tarp dviejų versijų, žr. Open Badges v2 ir v3.

Paties gavėjo kopijoje. Atsisiųstame faile nesikeičia nieko. Ženklelio paveikslėlis jo nešiojamajame kompiuteryje atrodo identiškai. Keičiasi patikrinimo rezultatas: kiekvienas, kuris paspaudžia nuorodą ar tikrina kvalifikaciją programiškai, gauna atšaukimo atsakymą. Jei jį informavote, jis taip pat turi el. laišką, paaiškinantį, kodėl.

LinkedIn. Į LinkedIn profilį pridėta kvalifikacija yra nuoroda su metaduomenimis, nukreipianti į jūsų patikrinimo puslapį. LinkedIn jūsų vardu atšaukimų netikrina, todėl įrašas profilyje gali likti, tačiau kiekvienas, paspaudęs nuorodą, pateks į atšauktą puslapį. Tai dar viena priežastis išsiųsti pranešimą ir paprašyti gavėjo pašalinti įrašą.

Praneškite savo sistemoms: webhooks

Atšaukimas retai yra istorijos pabaiga jūsų organizacijoje. Besimokantysis gali prarasti prieigą prie bendruomenės, gali reikėti atnaujinti darbdavio įrašą ar pašalinti CRM žymą. Badges Ninja, kai kvalifikacija atšaukiama, išsiunčia credential.revoked webhook įvykį su apdovanojimo URL ir priežastimi:

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

Užsiprenumeruokite jį, ir jūsų tolesnės sistemos išliks sinchronizuotos be to, kad kam nors reikėtų prisiminti jas atnaujinti. Nustatymo detalės pateiktos webhooks dokumentacijoje, o platesnį įvykių modelį aptariame straipsnyje webhook nustatymas ženklelių įvykiams.

Paprasta atšaukimo politika, kurią galite priimti šiandien

Įrankiai yra lengvoji pusė. Sunkesnė – iš anksto nuspręsti, kada atšauksite ir kam tai leista. Trumpa rašytinė politika vėliau apsaugo nuo ginčų. Veikiantis šablonas:

  1. Atšaukimo pagrindai. Išvardykite juos: išduota per klaidą, įgyta netinkamu elgesiu, reikalavimas nebeįvykdytas (pavyzdžiui, nutrūko narystė) arba programa nutraukta.
  2. Kas sprendžia. Nurodykite pareigas, o ne asmenį. Atšaukimo teisę suteikite tik šioms pareigoms.
  3. Pranešimas. Nurodykite, kad gavėjams el. paštu pranešama su priežastimi, nebent kvalifikacija niekada nebuvo pristatyta.
  4. Apeliacija. Suteikite gavėjams galimybę ginčyti sprendimą ir nurodykite, per kiek laiko atsakysite. Jei apeliacija patenkinama, išduokite naują kvalifikaciją, o ne bandykite atšaukimo panaikinti – tada istorija lieka švari.
  5. Įrašas. Laikykite vidinę pastabą, kas ką ir kodėl atšaukė, atskirai nuo neutralios viešos priežasties.

Paskelbkite politiką tame pačiame puslapyje, kuriame aprašote kvalifikaciją, kad gavėjai taisykles žinotų dar prieš užsiregistruodami.

Dažnos klaidos, kurių verta vengti

  • Ištrynimas, kai norėjote atšaukti. Ištrynimas yra negrįžtamas ir dėl jo dingsta viešas puslapis. Naudokite jį tik tikroms klaidoms kvalifikacijose, kurių niekas nematė.
  • Privati informacija priežastyje. Ji viešai matoma assertion.
  • Tikėjimasis, kad išsaugotos kopijos pasikeis. Atšaukimas gyvena patikrinimo taške. Paprašykite gavėjų pašalinti kvalifikaciją iš profilių ir portfolio.
  • Atšaukimas vietoj galiojimo pabaigos. Terminuotoms kvalifikacijoms naudokite galiojimo pabaigos datą.
  • Tikėjimasis kompensacijos. Atšauktos kvalifikacijos vis tiek įskaičiuojamos į jūsų plano kvotą.
  • Pamirštos tolesnės sistemos. Sujunkite webhook, kad prieiga ir įrašai sektų kvalifikacijos būseną.

Dažnai užduodami klausimai

Ar galiu atšaukimą panaikinti? Ne per sąsają. Jei atšaukėte per klaidą, išduokite gavėjui naują kvalifikaciją. Atšauktoji lieka audito pėdsako dalimi.

Ar gavėjui reikia ką nors daryti? Ne. Jei pasirinkote jį informuoti, jis gauna el. laišką. Kitu atveju pakeitimas tyliai įvyksta patikrinimo puslapyje.

Ar atšaukimas veikia kvalifikacijoms, kurios niekada nebuvo išsiųstos? Taip, nors neišsiųstai kvalifikacijai su paprasta klaida galbūt norėsite ją redaguoti prieš siunčiant arba ištrinti, jei jos niekas nematė.

Ar yra riba, kiek galiu atšaukti? Masinis atšaukimas vykdomas kaip tęsiama fono užduotis, todėl dideli kiekiai apdorojami vienos operacijos metu, o ne po vieną.

Ar darbdaviai pamatys, kad kvalifikacija atšaukta? Kiekvienas, kuris tikrina ją per viešą URL ar assertion, mato atšaukimo būseną ir priežastį, jei ją nurodėte.

Išvada

Open Badge atšaukimas yra mažas veiksmas su realiomis pasekmėmis pasitikėjimui. Pavienei kvalifikacijai tai darykite iš valdymo skydelio, grupei naudokite masinį atšaukimą, o į API ar webhooks kreipkitės tada, kai sprendimą priima kita sistema. Rašykite neutralias priežastis, informuokite tuos, kuriems reikia žinoti, ir prisiminkite: atšaukimas keičia tai, ką mato tikrintojai, o ne failus, kurie jau yra gavėjų rankose.

Pasiruošę išduoti pirmąją patikrinamą kvalifikaciją? Pradėkite nemokamai svetainėje badges.ninja – vizualus dizaineris, viešas patikrinimo puslapis, PDF pažymėjimas, Open Badge v2.0 išvestis. Kredito kortelės nereikia.

Nacho Coll

Apie autorių

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.

Grįžti į Tinklaraštį

Susiję straipsniai