Ověření podpisu Open Badge v Node.js, Pythonu a Go
Tři funkční ukázky kódu (Node, Python, Go): stažení podepsaného osvědčení Open Badge, nalezení veřejného klíče vydavatele a ověření podpisu JWS.
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.
Pokud vydáváte osvědčení, většina práce s ověřováním proběhne bez vás: příjemce sdílí odkaz, zaměstnavatel na něj klikne a zbytek obstará ověřovací stránka. Dříve či později se ale někdo zeptá ostřeji: „Jak poznám, že tento soubor opravdu podepsali vy a že ho nikdo následně neupravil?” Odpovědí je digitální podpis a jeho kontrola zabere zhruba patnáct řádků kódu v kterémkoli běžném jazyce.
Tento tutoriál krok za krokem ukazuje, jak ověřit podepsané osvědčení Open Badges 3.0 vydané přes https://badges.ninja v Node.js, Pythonu a Go. Nemusíte nic z toho spouštět, abyste mohli osvědčení vydávat. Je pro ty, kdo chtějí systém auditovat, postavit interní ověřovací nástroj nebo prostě pochopit, co „ověřitelné” znamená v praxi.
Co vlastně ověřujete
V Open Badges existují dvě vrstvy ověřování a je užitečné je odlišovat.
Hostované ověření je model Open Badges 2.0. Udělený odznak má veřejnou URL a každý, kdo ji otevře, uvidí vydavatele, odznak, hashovanou identitu příjemce a stav. Důvěra vychází z toho, že data se servírují z domény samotného vydavatele. Pokud se stránka otevře na https://badges.ninja, osvědčení je skutečné. K tomu nepotřebujete kód ani podpis.
Ověření podpisu je model Open Badges 3.0 postavený na W3C Verifiable Credentials. Osvědčení je zabalené jako podepsaný token, takže ho lze zkontrolovat offline, i po letech, a to i když bylo zkopírováno do peněženky nebo přílohy e-mailu. Důvěra pramení z matematiky: token nese podpis, který mohl vytvořit jen držitel soukromého klíče vydavatele.
Na https://badges.ninja je každý udělený odznak dostupný v obou podobách. Tento článek je o té druhé. Chcete-li znát pozadí rozdílů mezi verzemi, přečtěte si Open Badges v2 vs v3 a prohlídku hostovaného JSON najdete v průvodci Open Badge JSON-LD.
Pohyblivé části
Podepsané osvědčení je VC-JWT: kompaktní JWS, tedy tři řetězce base64url oddělené tečkami.
header.payload.signature
- Hlavička říká, jak byl podpis vytvořen. U našich osvědčení obsahuje
alg: EdDSA,typ: JWTakid(identifikátor klíče) ve tvarudid:web:api.badges.ninja#<thumbprint>. - Payload nese tvrzení (claims), včetně
iss(DID vydavateledid:web:api.badges.ninja),jti(identifikátor osvědčení),nbf(platné od), volitelnéhoexp(vypršení) a objektuvcse skutečnýmOpenBadgeCredential. - Podpis je podpis Ed25519 nad přesnými bajty
header.payload.
Veřejný klíč, kterým se podpis ověřuje, vydavatel zveřejňuje na dvou místech, obě bez autentizace:
https://api.badges.ninja/.well-known/jwks.jsonvrací sadu JWK (JWK Set).https://api.badges.ninja/.well-known/did.jsonvrací dokument DID prodid:web:api.badges.ninja.
kid v JWKS je otisk klíče podle RFC 7638. kid v hlavičce tokenu je DID URL a jeho fragment (část za #) je tentýž otisk. Podle tohoto fragmentu vybíráte správný klíč.
Postup ověření
Každý jazyk sleduje stejných pět kroků:
- Stáhněte podepsané osvědčení z veřejného endpointu.
- Rozdělte token na tři části.
- Přečtěte hlavičku, ověřte, že
algje přesněEdDSA, a vezměte otisk zkid. - Stáhněte JWKS a najděte klíč s odpovídajícím
kid. - Tímto klíčem ověřte podpis Ed25519 nad
header.payload.
Endpoint osvědčení je veřejný a přijímá identifikátor uděleného odznaku (stejný GUID, jaký vidíte v ověřovací URL, například https://badges.ninja/awards/<awardId>):
curl https://api.badges.ninja/certify-badge/award/<awardId>/vc
Ve výchozím stavu vrací podepsaný VC-JWT jako application/jwt. Přidáním ?format=json získáte nepodepsané JSON osvědčení ke čtení. Obě varianty popisuje reference ověřování.
Všimněte si, že neexistuje samostatný endpoint „ověř to za mě”, a je to záměr. Server, který vám řekne „ano, platné”, vás žádá, abyste důvěřovali serveru. Smyslem podpisu je, že ho ověříte sami proti zveřejněnému klíči.
Node.js
Vestavěný modul crypto v Node podporuje Ed25519 i import JWK, takže nepotřebujete žádné závislosti.
import crypto from "node:crypto";
const API = "https://api.badges.ninja";
const awardId = process.argv[2];
// —— 1. fetch the signed credential
const jwt = (await (await fetch(`${API}/certify-badge/award/${awardId}/vc`)).text()).trim();
// —— 2. split into parts
const [h, p, s] = jwt.split(".");
const header = JSON.parse(Buffer.from(h, "base64url").toString());
const payload = JSON.parse(Buffer.from(p, "base64url").toString());
// —— 3. refuse anything but EdDSA
if (header.alg !== "EdDSA") throw new Error(`unexpected alg: ${header.alg}`);
const thumbprint = header.kid.split("#")[1];
// —— 4. resolve the public key
const jwks = await (await fetch(`${API}/.well-known/jwks.json`)).json();
const jwk = jwks.keys.find((k) => k.kid === thumbprint);
if (!jwk) throw new Error("no matching key in JWKS");
const publicKey = crypto.createPublicKey({ key: jwk, format: "jwk" });
// —— 5. verify the signature over "header.payload"
const ok = crypto.verify(null, Buffer.from(`${h}.${p}`), publicKey, Buffer.from(s, "base64url"));
console.log(ok ? "signature valid" : "signature INVALID");
console.log("issuer:", payload.iss, "credential:", payload.jti);
Argument null na místě algoritmu je správně: u Ed25519 algoritmus určuje typ klíče. Dáte-li přednost knihovně, jose dělá totéž pomocí compactVerify a importJWK a kontroly hlavičky za vás zvládne.
Python
Balíček cryptography nabízí Ed25519 přímo. Nainstalujte ho příkazem pip install cryptography requests.
import base64, json, sys
import requests
from cryptography.exceptions import InvalidSignature
from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PublicKey
API = "https://api.badges.ninja"
award_id = sys.argv[1]
def b64url(data: str) -> bytes:
return base64.urlsafe_b64decode(data + "=" * (-len(data) % 4))
# —— 1. fetch the signed credential
jwt = requests.get(f"{API}/certify-badge/award/{award_id}/vc").text.strip()
# —— 2. split into parts
h, p, s = jwt.split(".")
header = json.loads(b64url(h))
payload = json.loads(b64url(p))
# —— 3. refuse anything but EdDSA
if header["alg"] != "EdDSA":
raise SystemExit(f"unexpected alg: {header['alg']}")
thumbprint = header["kid"].split("#")[1]
# —— 4. resolve the public key
keys = requests.get(f"{API}/.well-known/jwks.json").json()["keys"]
jwk = next((k for k in keys if k["kid"] == thumbprint), None)
if jwk is None:
raise SystemExit("no matching key in JWKS")
public_key = Ed25519PublicKey.from_public_bytes(b64url(jwk["x"]))
# —— 5. verify the signature over "header.payload"
try:
public_key.verify(b64url(s), f"{h}.{p}".encode())
print("signature valid")
except InvalidSignature:
print("signature INVALID")
print("issuer:", payload["iss"], "credential:", payload["jti"])
Python v této knihovně nemá import JWK pro Ed25519, takže souřadnici x (surový 32bajtový veřejný klíč) dekódujeme sami. Přesně to JWK typu OKP s křivkou Ed25519 obsahuje.
Go
Standardní knihovna Go pokrývá všechno, včetně crypto/ed25519.
package main
import (
"crypto/ed25519"
"encoding/base64"
"encoding/json"
"fmt"
"io"
"net/http"
"os"
"strings"
)
const api = "https://api.badges.ninja"
func get(url string) []byte {
res, err := http.Get(url)
if err != nil {
panic(err)
}
defer res.Body.Close()
b, _ := io.ReadAll(res.Body)
return b
}
func main() {
awardID := os.Args[1]
// —— 1. fetch the signed credential
jwt := strings.TrimSpace(string(get(api + "/certify-badge/award/" + awardID + "/vc")))
// —— 2. split into parts
parts := strings.Split(jwt, ".")
if len(parts) != 3 {
panic("not a compact JWS")
}
enc := base64.RawURLEncoding
hb, _ := enc.DecodeString(parts[0])
var header struct{ Alg, Kid string }
json.Unmarshal(hb, &header)
// —— 3. refuse anything but EdDSA
if header.Alg != "EdDSA" {
panic("unexpected alg: " + header.Alg)
}
thumbprint := strings.Split(header.Kid, "#")[1]
// —— 4. resolve the public key
var jwks struct {
Keys []struct{ Kid, X string } `json:"keys"`
}
json.Unmarshal(get(api+"/.well-known/jwks.json"), &jwks)
var pub ed25519.PublicKey
for _, k := range jwks.Keys {
if k.Kid == thumbprint {
pub, _ = enc.DecodeString(k.X)
}
}
if pub == nil {
panic("no matching key in JWKS")
}
// —— 5. verify the signature over "header.payload"
sig, _ := enc.DecodeString(parts[2])
ok := ed25519.Verify(pub, []byte(parts[0]+"."+parts[1]), sig)
fmt.Println("signature valid:", ok)
}
Spusťte to příkazem go run main.go <awardId>. Ošetření chyb je kvůli čitelnosti zkráceno; ve skutečném nástroji byste kontrolovali každé dekódování.
Časté chyby a jak je číst
Klíč není v JWKS. Porovnali jste celý kid z hlavičky tokenu (did:web:api.badges.ninja#abc) s kid z JWKS (abc). Porovnávejte jen fragment za #. Pokud se fragment stále neshoduje, vydavatel mohl od vydání tokenu rotovat klíče; stáhněte dokument DID a podívejte se na položky verificationMethod.
Neplatný podpis u právě staženého tokenu. Zkontrolujte, že jste ověřovali header.payload jako původní text base64url, ne znovu zakódovaný JSON. Opětovná serializace JSON změní bajty a rozbije podpis. Zkontrolujte také, zda stažený token nemá na konci znak nového řádku.
Záměna algoritmů. Klasický útok na JWT je token, který tvrdí alg: none nebo přepne na symetrický algoritmus, aby ho ověřovatel přijal. Naše ukázky se mu vyhýbají tím, že očekávaný algoritmus EdDSA mají napevno a vše ostatní odmítají. Nikdy nenechte token, aby si sám zvolil, jak bude ověřen.
Chyby paddingu base64. JWS používá base64url bez paddingu. Python vyžaduje padding doplnit (viz výše) a Go potřebuje RawURLEncoding, nikoli URLEncoding.
Podpis platí, ale je osvědčení stále dobré? Podpis dokazuje autenticitu a integritu, nikoli aktuální stav. Osvědčení může být správně podepsané a přesto odvolané či prošlé. Zkontrolujte exp v payloadu a stav odvolání popsaný níže.
Nezapomeňte na odvolání
Každé osvědčení Open Badges 3.0 z https://badges.ninja obsahuje položku credentialStatus podle W3C Bitstring Status List. Ukazuje na osvědčení se seznamem stavů, které stáhnete na /certify-badge/status/<listId>. Když vydavatel odznak odvolá, v tomto seznamu se přepne bit; seznam se cachuje zhruba minutu, takže odvolání se k ověřovatelům dostanou rychle. Seznam dekódujte a přečtěte bit na statusListIndex osvědčení: 1 znamená odvoláno, 0 aktivní. Reference ověřování obsahuje krátký příklad v Node pro tuto kontrolu bitu.
Úplný ověřovatel dělá tři věci: ověří podpis, zkontroluje vypršení a zkontroluje bit odvolání. Chcete-li vidět, jak odvolání vypadá ze strany vydavatele, akci v panelu popisuje průvodce udělováním odznaků.
Kdy nic z toho nepotřebujete
Většina vlastníků programů tento kód nikdy nenapíše a to je v pořádku. Na běžné kontroly otevřete veřejnou stránku odznaku na https://badges.ninja/awards/<awardId> a přečtěte si ji. Stránka nevyžaduje registraci ani klíč a ukazuje vydavatele, odznak a stav. Příjemci si také mohou stáhnout Verifiable Credential z nabídky Stáhnout na své veřejné stránce osvědčení a importovat ho do libovolné peněženky Open Badges 3.0.
Kontrola podpisu se stává cennou, když:
- zaměstnavatel nebo univerzita chce automatizovat kontrolu přijatých osvědčení;
- budujete evidenční systém, který ukládá kopie osvědčení a musí prokázat, že nebyly změněny;
- auditor žádá důkaz, že vaše osvědčení jsou nezávisle ověřitelná, nikoli jen „věřte našemu webu”.
Nastavení API klíče, které používáte při vydávání, zde není potřeba, protože všechny tyto endpointy jsou veřejné. Pokud chcete osvědčení vydávat z kódu, rychlý start API vás provede vytvořením klíče a prvním udělením odznaku.

Rychlý přehled
| Položka | Hodnota |
|---|---|
| Podepsané osvědčení | GET https://api.badges.ninja/certify-badge/award/<awardId>/vc |
| Nepodepsaný JSON ke čtení | stejná URL s ?format=json |
| DID vydavatele | did:web:api.badges.ninja |
| Veřejné klíče | /.well-known/jwks.json a /.well-known/did.json |
| Algoritmus | Ed25519 (EdDSA) |
| Shoda klíče | fragment kid z hlavičky se rovná kid v JWKS |
| Odvolání | credentialStatus ukazující na /certify-badge/status/<listId> |
Na závěr
Ověření podpisu Open Badge je krátká mechanická rutina: stáhněte token, připněte algoritmus, najděte klíč podle otisku a zkontrolujte podpis Ed25519 nad prvními dvěma segmenty. Přidejte kontrolu vypršení a odvolání a máte ověřovatele, který nevěří nikomu kromě zveřejněného klíče vydavatele. Právě tato nezávislost činí digitální osvědčení cennějším než PDF.
Jste připraveni vydat své první ověřitelné osvědčení? Začněte zdarma na badges.ninja — vizuální designér, veřejná ověřovací stránka, PDF certifikát, výstup Open Badge v2.0. Kreditní karta není potřeba.
Jak tento článek vznikl
Některé příspěvky na tomto blogu vznikají s pomocí AI asistenta a před publikováním je kontroluje, ověřuje a upravuje tým Badges Ninja. Každá ukázka kódu a cena je ověřena oproti aktuálnímu produktu. Více o našem redakčním a AI procesu najdete na naší stránce o redakčním procesu .

O autorovi
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.
Další od Nacho Coll
- Open Badges pro bootcampy: ověřitelné certifikáty ve velikosti celého ročníku19. 11. 2026 · 10min čtení
- Nastavení webhooků pro události odznaků: integrace s vaším backendem v reálném čase16. 11. 2026 · 8min čtení
- Expirace a obnova Open Badge: správa životního cyklu časově omezených osvědčení12. 11. 2026 · 10min čtení


