Expirace a obnova Open Badge: správa životního cyklu časově omezených osvědčení

Kredity CE, certifikace i licence vypršejí. Nastavte expirationDate u Open Badges a obnovujte je programově. Schéma + pracovní postup.

Nacho Coll Autor Aktualizováno 10 min čtení
Kredity CE, certifikace i licence vypršejí. Nastavte expirationDate u Open Badges a obnovujte je programově. Schéma + pracovní postup.

Některá osvědčení platí doživotně. Diplom nepřestane být pravdivý jen proto, že uplynulo deset let. Velký podíl osvědčení, která školicí týmy vydávají, je ale pravým opakem: dvouletá certifikace z kybernetické bezpečnosti, každoroční opakovací školení bezpečné obsluhy vysokozdvižných vozíků, karta CPR, kredit dalšího vzdělávání platný jen jedno vykazované období. Taková osvědčení tvrdí, že někdo byl k určitému datu způsobilý, a toto tvrzení má dobu trvanlivosti.

Pokud vaše digitální osvědčení nikdy nevyprší, potichu sdělujete zaměstnavatelům a auditorům něco, co není pravda. Tento článek ukazuje, jak funguje expirace v Open Badges, co vidí ověřovatel, když osvědčení vyprší, a praktický postup obnovy, který nevyžaduje psaní kódu, pokud sami nechcete.

Jedna poznámka k názvosloví na úvod

Uvidíte, že lidé hledají „expirationDate”. Ve specifikaci Open Badges v2.0 se pole u potvrzení (tedy samotného udělení, na rozdíl od třídy odznaku) jmenuje expires. Je to řetězec data a času ve formátu ISO 8601. Pole API, které posíláte při vydávání osvědčení na https://badges.ninja, se také jmenuje expires. Stejná myšlenka, jen jiný název, než by většina hádala, proto na to pamatujte, když budete číst dokument JSON-LD nebo hledat v dokumentaci.

Dvě podrobnosti, které stojí za to znát:

  • Expirace je vázána na udělení, ne na odznak. Stejný odznak (řekněme „Annual Safety Training”) lze vydat jednomu člověku s expirací v březnu a jinému v září. To je přesně to, co chcete, protože platnost se počítá od chvíle, kdy každý člověk školení dokončil.
  • Je nepovinná. Vynechte ji a osvědčení nikdy nevyprší.

Nastavení expirace při vydání

Máte tři způsoby, jak nastavit dobu platnosti. Začněte prvními dvěma, protože nevyžadují kód.

Formulář na přehledu. Při vytváření osvědčení obsahuje formulář nepovinné pole data „Expires” vedle jména a e-mailu příjemce. Vyberete datum a vydáte. To je celá práce.

New Award form

Hromadná udělení. Pokud vydáváte celé skupině, stránka hromadných udělení přijme CSV s příjemci a použije jedno datum expirace na celou dávku, takže kurz, který skončil ve stejném týdnu, vyprší ve stejný den. Velkou dávku můžete pozastavit a znovu spustit. Formát souboru popisuje náš návod na vydávání Open Badges z CSV.

API. Pro automatizaci, například háček v systému pro správu výuky, který vydá osvědčení po složení zkoušky, přidejte expires do těla požadavku POST /awards. Přijímá stejné formáty jako issuedOn: milisekundy od epochy nebo řetězec s datem ISO.

// Issue a 2-year certification
const issuedOn = Date.now();
const twoYears = 2 * 365 * 24 * 60 * 60 * 1000;
const res = await fetch("https://api.badges.ninja/awards", {
  method: "POST",
  headers: { "X-Api-Key": API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    badgeId: "your-badge-id",
    recipient: { name: "Jane Smith", email: "jane@example.com" },
    issuedOn,
    expires: issuedOn + twoYears,
  }),
});
const { awardId } = await res.json();       // 200 OK
const verifyUrl = `https://badges.ninja/awards/${awardId}`;

Stejné volání v Pythonu:

import time, requests
issued = int(time.time() * 1000)
two_years = 2 * 365 * 24 * 60 * 60 * 1000
res = requests.post(
    "https://api.badges.ninja/awards",
    headers={"X-Api-Key": API_KEY},
    json={
        "badgeId": "your-badge-id",
        "recipient": {"name": "Jane Smith", "email": "jane@example.com"},
        "issuedOn": issued,
        "expires": issued + two_years,
    },
)
award_id = res.json()["awardId"]            # 200 OK

Jméno příjemce musí mít alespoň pět znaků, issuedOn je povinné a úspěšné volání vrátí HTTP 200 s { awardId }. Ověřovací URL v odpovědi není; sestavíte ji z identifikátoru, jak je ukázáno. Úplný popis požadavku najdete v referenci API udělení.

Na pozadí platforma převede cokoli, co pošlete, na řetězec ISO 8601 a uloží ho do potvrzení Open Badges jako expires.

Co vidí ověřovatel

Toto je nejdůležitější část, protože datum expirace, které nikdo nekontroluje, je jen dekorace.

Každé udělení má veřejnou ověřovací stránku na adrese https://badges.ninja/awards/<awardId> a k jejímu zobrazení není nutná registrace. Stránka při každém načtení porovná datum expirace s dnešním datem:

  • Před datem expirace: stránka zobrazí osvědčení jako platné a ukáže řádek „valid until” s datem.
  • Po datu expirace: stránka přepne na oznámení „Expired on” s datem. Osvědčení tam stále je, takže historie zůstává zachována, ale nikdo si ho nespletí s platným.
  • Pokud bylo osvědčení odvoláno: odvolání má přednost před expirací. Odvolané osvědčení se zobrazí jako odvolané, ne jako pouze prošlé.

Strojoví ověřovatelé dostanou stejnou informaci z dokumentu JSON-LD Open Badge v2.0 na adrese https://api.badges.ninja/certify-badge/award/<awardId>, kde potvrzení obsahuje pole expires. Každý nástroj, který standard čte, může uplatnit vlastní pravidla. Systém HR může prošlé osvědčení rovnou odmítnout, zatímco adresář absolventů ho může zobrazit jako „dříve certifikován”.

Osvědčení nese datum i navenek. Tlačítko „Add to LinkedIn” u udělení vyplní měsíc a rok vypršení v záznamu certifikace na LinkedIn, takže profil dané osoby odráží stejné datum, které jste nastavili. Stažitelný PDF certifikát také vytiskne datum „Expires” vedle data vydání.

Jeden důsledek stojí za jasné vyslovení: expirace se vyhodnocuje ve chvíli, kdy se někdo dívá, ne úlohou běžící na vaší straně. V den vypršení nemusíte nic dělat. Nic se „nevypíná”; ověřovací stránka prostě říká pravdu o datu.

Přehled toho, co brzy vyprší

Programy, které sledují obnovy, potřebují seznam lidí, kterým se blíží termín. Stránka udělení na přehledu má sloupec Expires s datem každého osvědčení a otevření osvědčení ukáže banner: Active, Expires on s datem, nebo Expired on s datem.

Awards list

Pro kampaň obnov je nejjednodušší vybrat řádky, které vás zajímají, a použít Export CSV. Export obsahuje sloupec „Valid To”. Otevřete ho v tabulkovém procesoru, seřaďte podle tohoto sloupce a za zhruba minutu máte pipeline obnov na příští čtvrtletí.

Upřímně musíme zmínit jedno omezení: platforma v současnosti sama neodesílá příjemcům automatické e-maily „vaše osvědčení brzy vyprší”. Připomínku berte jako krok ve vlastním procesu. Častý postup je záznam v kalendáři na prvního v měsíci: exportujete CSV, vyfiltrujete data v následujících 60 až 90 dnech a těmto lidem pošlete pokyny k obnově ze svého běžného e-mailového nástroje. U většiny programů s několika stovkami osvědčení to zabere deset minut měsíčně a je to mnohem méně práce než budovat systém upozornění.

Pokud to přesto chcete automatizovat, endpoint se seznamem udělení (GET /awards) vrací vaše osvědčení po stránkách po 50 a každý záznam obsahuje expiraci. Naplánovaný skript, který projde seznam a pošle e-mail každému, komu platnost končí do 60 dnů, je malý projekt. Nejprve ale vyzkoušejte tabulku a automatizujte, až když vás ruční krok opravdu trápí.

Vzory obnovy

Co by se mělo s osvědčením stát, když ho někdo obnovuje? Existují tři rozumné vzory a správný záleží na tom, jak je váš certifikační program definován.

Vzor 1: Vydat nové udělení (doporučeno)

Toto je nejčistší přístup. Člověk dokončí opakovací školení nebo rekvalifikační zkoušku a vy vydáte nové udělení ze stejného odznaku s novým datem vydání a novou expirací. Pak má dvě osvědčení se stejným odznakem: staré, které se zobrazuje jako prošlé, a nové, které je aktivní.

Proč je to obvykle správné:

  • Každé osvědčení poctivě zaznamenává historii: vydáno tohoto dne, platné do onoho dne.
  • Stará veřejná URL dál funguje a dál říká „expired”, což je přesné. Nikdo, kdo si ji uložil do záložek, není uveden v omyl.
  • Nové udělení dostane vlastní ověřovací URL, PDF certifikát a záznam Add to LinkedIn. Člověk může starý záznam na LinkedIn nahradit, nebo ponechat oba, aby ukázal nepřetržitou certifikaci.
  • Vaše reporty spočítají obnovy jednoduše počtem udělení na příjemce pro daný odznak.

Chcete-li zachovat vazbu mezi starým a novým, uveďte ji v kritériích odznaku nebo ve vlastních záznamech. Odznak rekvalifikace může říkat: „Obnova Annual Safety Training, platná po dokončení opakovacího školení.” Pokud potřebujete pevnou vazbu ve vlastním systému, uložte při vydání nového udělení stará a nová hodnota awardId společně do databáze systému výuky nebo HR.

Vzor 2: Upravit expiraci na místě (jen před odesláním)

Platforma podporuje úpravu osvědčení na místě, ale jen dokud nebylo odesláno e-mailem a nebylo odvoláno. V tomto okně můžete opravit jméno příjemce, e-mail, datum vydání nebo expiraci bez změny URL udělení. Slouží to k opravě chyb, například špatně zadaného data expirace při nastavení, nikoli k prodloužení osvědčení, které už někdo drží.

Jakmile je osvědčení odesláno příjemci e-mailem, je uzamčeno. Pokud ho potřebujete poté změnit, podporovanou cestou je odvolat ho a vydat nové. Tím se dostáváme ke třetímu vzoru.

Vzor 3: Odvolat a vydat znovu

Použijte to, když osvědčení již vůbec nemá být považováno za platné, například člověk během období přišel o licenci nebo jste ho vydali s nesprávným odznakem. Není to běžná cesta obnovy, protože odvolání vysílá silnější signál než expirace: říká, že osvědčení nemělo být důvěryhodné, nejen že jeho období skončilo. Náš krok za krokem návod na odvolání Open Badge popisuje, kdy se hodí které.

Dobré pravidlo: expirace znamená, že období skončilo; odvolání znamená, že něco bylo špatně. Neodvolávejte osvědčení jen proto, že vypršela. Nechte je vypršet a záznam zachovejte.

Volba doby platnosti

Expirace jsou rozhodnutí politiky a jejich špatné nastavení způsobuje skutečné potíže. Několik rad z programů, které podle nás fungují dobře:

Typ osvědčeníTypická platnostPoznámky
Certifikace z kybernetické bezpečnosti nebo IT2 až 3 rokyNástroje a hrozby se rychle mění
Každoroční školení bezpečnosti12 měsícůČasto navázáno na regulatorní požadavek
První pomoc a CPR2 rokyŘiďte se pravidlem svého regulátora, ne zvyklostí
Kredit dalšího vzděláváníKonec vykazovaného obdobíSladit s cyklem, aby se obnovy dávkovaly
Dokončení kurzuBez expiraceDokončení je fakt; expires vynechte

Dvě praktické rady. Zaprvé, kde je to možné, sladte data expirace s kalendářním rytmem. Pokud celá skupina vyprší ve stejný den, obnova je jedna kampaň místo padesáti. Zadruhé, nedávejte expiraci na osvědčení, která jsou ve skutečnosti záznamem o dokončení. Odznak „zúčastnil se konference 2025” se příští rok nestane méně pravdivým a datum expirace na něm jen vytváří zmatek.

Praktický příklad: dvouletá bezpečnostní certifikace

Pojďme to spojit pro školicí tým, který provozuje certifikaci povědomí o bezpečnosti ve firmě se 400 zaměstnanci.

  1. Odznak navrhněte jednou ve vizuálním návrháři. Pojmenujte ho, nastavte kritéria (složit zkoušku s výsledkem 80 procent nebo vyšším) a popište dobu platnosti v popisu, aby příjemci věděli, do čeho jdou.
  2. Vydávejte s expirací. Po každé zkouškové seanci nahrajte seznam úspěšných přes hromadná udělení s expirací nastavenou o dva roky dopředu. Každý člověk dostane e-mail s ověřovacím odkazem, PDF certifikátem a tlačítkem Add to LinkedIn.
  3. Kontrolujte měsíčně. Prvního v měsíci exportujte seznam udělení, seřaďte podle „Valid To” a vyberte všechny, kterým platnost končí během 90 dnů.
  4. Pozvěte je k obnově. Těmto lidem pošlete odkaz na rekvalifikační zkoušku ze svého běžného e-mailového nástroje.
  5. Vydejte obnovu. Když někdo uspěje, vydejte nové udělení ze stejného odznaku s novou dvouletou expirací. Staré se samo zobrazí jako prošlé; nic s ním nedělejte.
  6. Auditorům odpovídejte odkazem. Když compliance zjišťuje, zda je člověk aktuálně certifikován, pošlete ověřovací URL. Ukáže aktuální stav, aniž byste cokoli kontrolovali.

Žádný vlastní software, žádné úlohy cron, žádné migrace. O to jde: správa životního cyklu je většinou otázka volby rozumných dat a měsíčního návyku.

Časté chyby

  • Expirace na všem. Vyhraďte ji pro osvědčení, jejichž význam skutečně slábne. Jinak vytváříte práci s obnovami bez jakéhokoli přínosu.
  • Záměna expirace s odvoláním. Odvolávání prošlých osvědčení ničí historii nepřetržité certifikace a způsobí, že člověk vypadá, jako by nikdy nebyl platný.
  • Zapomenuté časové pásmo. Datum, které zvolíte, se stane bodem v čase. Pokud předpis říká „platné do konce března”, nastavte expiraci na poslední den března nebo první den dubna podle toho, jak se čte vaše politika, a buďte důslední.
  • Plánování úprav místo opětovného vydání. Úprava je dostupná jen před odesláním osvědčení e-mailem. Obnovy plánujte od začátku jako nová udělení.
  • Žádný proces připomínek. Protože upozornění na expiraci nejsou automatizovaná, návyk musí být váš. Zapište měsíční export někomu do kalendáře.

Kam dál

Pokud budou vaše osvědčení kontrolovat jiné systémy, stojí za to přečíst si, jak je strukturován dokument nesoucí expires: Open Badge JSON-LD example walkthrough provede každým polem potvrzení. A pokud zvažujete, zda platformě dál platit za každé osvědčení, naše srovnání alternativ ke Credly vyčísluje náklady.

Jste připraveni vydat své první ověřitelné osvědčení? Začněte zdarma na badges.ninja — vizuální návrhář, veřejná ověřovací stránka, PDF certifikát, výstup Open Badge v2.0. Kreditní karta není potřeba.

Nacho Coll

O autorovi

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.

Zpět na Blog

Související články