Επαλήθευση υπογραφής Open Badge σε Node.js, Python και Go
Τρία λειτουργικά δείγματα κώδικα (Node, Python, Go) για να λάβετε ένα υπογεγραμμένο διαπιστευτήριο Open Badge, να εντοπίσετε το δημόσιο κλειδί του εκδότη και να επαληθεύσετε την υπογραφή 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.
Αν εκδίδετε διαπιστευτήρια, το μεγαλύτερο μέρος της επαλήθευσης γίνεται χωρίς εσάς: ο αποδέκτης μοιράζεται έναν σύνδεσμο, ένας εργοδότης τον ανοίγει και η σελίδα επαλήθευσης κάνει τα υπόλοιπα. Αργά ή γρήγορα όμως κάποιος θα θέσει μια πιο καίρια ερώτηση. «Πώς ξέρω ότι αυτό το αρχείο υπογράφηκε πραγματικά από εσάς και δεν τροποποιήθηκε εκ των υστέρων;» Την απάντηση τη δίνει μια ψηφιακή υπογραφή, και ο έλεγχός της παίρνει περίπου δεκαπέντε γραμμές κώδικα σε οποιαδήποτε δημοφιλή γλώσσα.
Αυτό το εγχειρίδιο δείχνει βήμα βήμα πώς επαληθεύεται ένα υπογεγραμμένο διαπιστευτήριο Open Badges 3.0 που εκδόθηκε μέσω https://badges.ninja, σε Node.js, Python και Go. Δεν χρειάζεται να εκτελέσετε τίποτα από αυτά για να εκδώσετε διαπιστευτήρια. Απευθύνεται σε όσους θέλουν να ελέγξουν το σύστημα, να φτιάξουν ένα εσωτερικό εργαλείο επαλήθευσης ή απλώς να καταλάβουν τι σημαίνει «επαληθεύσιμο» στην πράξη.
Τι ακριβώς επαληθεύετε
Υπάρχουν δύο επίπεδα επαλήθευσης στα Open Badges και βοηθά να τα ξεχωρίζετε.
Η φιλοξενούμενη επαλήθευση είναι το μοντέλο του Open Badges 2.0. Η απονομή έχει δημόσια διεύθυνση URL και όποιος την ανοίξει βλέπει τον εκδότη, το ψηφιακό σήμα, την κατακερματισμένη ταυτότητα του αποδέκτη και την κατάσταση. Η εμπιστοσύνη προκύπτει από το ότι τα δεδομένα σερβίρονται από το δικό του domain του εκδότη. Αν μπορείτε να ανοίξετε τη σελίδα στο https://badges.ninja, το διαπιστευτήριο είναι αληθινό. Δεν απαιτεί κώδικα ούτε υπογραφή.
Η επαλήθευση υπογραφής είναι το μοντέλο του Open Badges 3.0, χτισμένο πάνω στα W3C Verifiable Credentials. Το διαπιστευτήριο πακετάρεται ως υπογεγραμμένο token, ώστε να ελέγχεται εκτός σύνδεσης, ακόμη και χρόνια αργότερα, ακόμη κι αν αντιγράφηκε σε ψηφιακό πορτοφόλι ή σε συνημμένο email. Η εμπιστοσύνη προέρχεται από τα μαθηματικά: το token φέρει μια υπογραφή που μόνο ο κάτοχος του ιδιωτικού κλειδιού του εκδότη θα μπορούσε να έχει παράγει.
Στο https://badges.ninja κάθε απονομή διατίθεται και στις δύο μορφές. Αυτό το άρθρο αφορά τη δεύτερη. Αν θέλετε το υπόβαθρο για τις διαφορές των δύο εκδόσεων, διαβάστε το Open Badges v2 vs v3, ενώ για μια ξενάγηση στο φιλοξενούμενο JSON δείτε την ανάλυση του Open Badge JSON-LD.
Τα κινούμενα μέρη
Το υπογεγραμμένο διαπιστευτήριο είναι ένα VC-JWT: ένα συμπαγές JWS, δηλαδή τρία αλφαριθμητικά base64url χωρισμένα με τελείες.
header.payload.signature
- Η κεφαλίδα (header) λέει πώς υπογράφηκε. Για τα διαπιστευτήριά μας περιέχει
alg: EdDSA,typ: JWTκαι έναkid(αναγνωριστικό κλειδιού) της μορφήςdid:web:api.badges.ninja#<thumbprint>. - Το φορτίο (payload) περιέχει τους ισχυρισμούς, μεταξύ αυτών τα
iss(το DID του εκδότηdid:web:api.badges.ninja),jti(το αναγνωριστικό του διαπιστευτηρίου),nbf(ισχύει από), ένα προαιρετικόexp(λήξη) και ένα αντικείμενοvcμε το πραγματικόOpenBadgeCredential. - Η υπογραφή είναι μια υπογραφή Ed25519 πάνω στα ακριβή bytes του
header.payload.
Το δημόσιο κλειδί που ελέγχει την υπογραφή δημοσιεύεται από τον εκδότη σε δύο σημεία, και τα δύο χωρίς πιστοποίηση ταυτότητας:
- Το
https://api.badges.ninja/.well-known/jwks.jsonεπιστρέφει ένα JWK Set. - Το
https://api.badges.ninja/.well-known/did.jsonεπιστρέφει το έγγραφο DID για τοdid:web:api.badges.ninja.
Το kid του JWKS είναι το αποτύπωμα (thumbprint) RFC 7638 του κλειδιού. Το kid στην κεφαλίδα του token είναι το DID URL και το τμήμα του μετά το # είναι το ίδιο αποτύπωμα. Αυτό το τμήμα είναι που σας βοηθά να διαλέξετε το σωστό κλειδί.
Η συνταγή επαλήθευσης
Κάθε γλώσσα ακολουθεί τα ίδια πέντε βήματα:
- Λάβετε το υπογεγραμμένο διαπιστευτήριο από το δημόσιο endpoint.
- Χωρίστε το token στα τρία μέρη του.
- Διαβάστε την κεφαλίδα, ελέγξτε ότι το
algείναι ακριβώςEdDSAκαι πάρτε το αποτύπωμα από τοkid. - Λάβετε το JWKS και βρείτε το κλειδί με το αντίστοιχο
kid. - Επαληθεύστε την υπογραφή Ed25519 πάνω στο
header.payloadμε αυτό το κλειδί.
Το endpoint του διαπιστευτηρίου είναι δημόσιο και δέχεται το αναγνωριστικό της απονομής (το ίδιο GUID που βλέπετε σε μια διεύθυνση επαλήθευσης όπως https://badges.ninja/awards/<awardId>):
curl https://api.badges.ninja/certify-badge/award/<awardId>/vc
Από προεπιλογή επιστρέφει το υπογεγραμμένο VC-JWT ως application/jwt. Προσθέστε ?format=json για να πάρετε το μη υπογεγραμμένο JSON του διαπιστευτηρίου, για ανάγνωση. Η αναφορά επαλήθευσης τεκμηριώνει και τα δύο.
Προσέξτε ότι δεν υπάρχει ξεχωριστό endpoint «επαλήθευσέ το για μένα», και αυτό είναι σκόπιμο. Ένας server που σας λέει «ναι, είναι έγκυρο» σας ζητά να εμπιστευτείτε τον server. Όλο το νόημα της υπογραφής είναι ότι μπορείτε να την ελέγξετε μόνοι σας απέναντι σε ένα δημοσιευμένο κλειδί.
Node.js
Η ενσωματωμένη ενότητα crypto του Node υποστηρίζει Ed25519 και εισαγωγή JWK, οπότε δεν χρειάζεστε εξαρτήσεις.
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);
Το όρισμα αλγορίθμου null είναι σωστό: στο Ed25519 ο τύπος του κλειδιού καθορίζει τον αλγόριθμο. Αν προτιμάτε βιβλιοθήκη, η jose κάνει την ίδια δουλειά με compactVerify και importJWK και αναλαμβάνει τους ελέγχους της κεφαλίδας.
Python
Το πακέτο cryptography σας δίνει άμεσα Ed25519. Εγκαταστήστε το με 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 δεν διαθέτει εισαγωγή JWK για Ed25519 σε αυτή τη βιβλιοθήκη, γι’ αυτό αποκωδικοποιούμε μόνοι μας τη συντεταγμένη x (το ακατέργαστο δημόσιο κλειδί των 32 byte). Αυτό είναι το μόνο που περιέχει ένα JWK τύπου OKP με καμπύλη Ed25519.
Go
Η τυπική βιβλιοθήκη της Go καλύπτει τα πάντα, συμπεριλαμβανομένου του 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)
}
Εκτελέστε το με go run main.go <awardId>. Ο χειρισμός σφαλμάτων έχει περιοριστεί για αναγνωσιμότητα· σε ένα πραγματικό εργαλείο θα ελέγχατε κάθε αποκωδικοποίηση.
Συνηθισμένα σφάλματα και πώς να τα διαβάζετε
Το κλειδί δεν βρίσκεται στο JWKS. Συγκρίνατε ολόκληρο το kid από την κεφαλίδα του token (did:web:api.badges.ninja#abc) με το kid του JWKS (abc). Συγκρίνετε μόνο το τμήμα μετά το #. Αν το τμήμα εξακολουθεί να μην ταιριάζει, ο εκδότης μπορεί να έχει εναλλάξει κλειδιά από τότε που εκδόθηκε το token· λάβετε το έγγραφο DID και δείτε τις εγγραφές verificationMethod.
Μη έγκυρη υπογραφή σε token που μόλις κατεβάσατε. Ελέγξτε ότι επαληθεύσατε το header.payload ως το αρχικό κείμενο base64url και όχι ως επανακωδικοποιημένο JSON. Η επανασειριοποίηση του JSON αλλάζει τα bytes και σπάει την υπογραφή. Ελέγξτε επίσης για τελικό χαρακτήρα νέας γραμμής στο token που κατεβάσατε.
Σύγχυση αλγορίθμου. Η κλασική επίθεση στα JWT είναι ένα token που δηλώνει alg: none ή αλλάζει σε συμμετρικό αλγόριθμο, ώστε ο επαληθευτής να εξαπατηθεί και να το δεχτεί. Τα δείγματά μας την αποφεύγουν ορίζοντας σταθερά τον αναμενόμενο αλγόριθμο, EdDSA, και απορρίπτοντας κάθε άλλον. Μην αφήνετε ποτέ το token να επιλέγει πώς θα επαληθευτεί.
Σφάλματα padding στο Base64. Το JWS χρησιμοποιεί base64url χωρίς padding. Η Python χρειάζεται να προστεθεί ξανά το padding (όπως φαίνεται παραπάνω) και η Go χρειάζεται RawURLEncoding, όχι URLEncoding.
Έγκυρη υπογραφή, αλλά ισχύει ακόμη το διαπιστευτήριο; Η υπογραφή αποδεικνύει την αυθεντικότητα και την ακεραιότητα, όχι την τρέχουσα κατάσταση. Ένα διαπιστευτήριο μπορεί να είναι σωστά υπογεγραμμένο και παρ’ όλα αυτά ανακληθέν ή ληγμένο. Ελέγξτε το exp στο φορτίο και την κατάσταση ανάκλησης που περιγράφεται παρακάτω.
Μην ξεχάσετε την ανάκληση
Κάθε διαπιστευτήριο Open Badges 3.0 από το https://badges.ninja φέρει μια εγγραφή credentialStatus που ακολουθεί το W3C Bitstring Status List. Δείχνει σε ένα διαπιστευτήριο λίστας κατάστασης που μπορείτε να λάβετε στο /certify-badge/status/<listId>. Όταν ένας εκδότης ανακαλεί μια απονομή, ένα bit αλλάζει στη λίστα· η λίστα αποθηκεύεται προσωρινά για περίπου ένα λεπτό, οπότε οι ανακλήσεις φτάνουν γρήγορα στους επαληθευτές. Αποκωδικοποιήστε τη λίστα και διαβάστε το bit στο statusListIndex του διαπιστευτηρίου: το 1 σημαίνει ανακληθέν, το 0 σημαίνει ενεργό. Η αναφορά επαλήθευσης περιλαμβάνει ένα σύντομο παράδειγμα Node για αυτόν τον έλεγχο του bit.
Ένας πλήρης επαληθευτής κάνει τρία πράγματα: επαληθεύει την υπογραφή, ελέγχει τη λήξη και ελέγχει το bit ανάκλησης. Αν θέλετε να δείτε πώς φαίνεται η ανάκληση από την πλευρά του εκδότη, η ενέργεια στον πίνακα ελέγχου περιγράφεται στον οδηγό απονομών.
Όταν δεν χρειάζεστε τίποτα από αυτά
Οι περισσότεροι υπεύθυνοι προγραμμάτων δεν θα γράψουν ποτέ αυτόν τον κώδικα, και είναι απολύτως εντάξει. Για τους καθημερινούς ελέγχους, ανοίξτε τη δημόσια σελίδα της απονομής στο https://badges.ninja/awards/<awardId> και διαβάστε την. Η σελίδα δεν απαιτεί εγγραφή ούτε κλειδί και δείχνει τον εκδότη, το ψηφιακό σήμα και την κατάσταση. Οι αποδέκτες μπορούν επίσης να κατεβάσουν το Verifiable Credential από το μενού Download στη δημόσια σελίδα του διαπιστευτηρίου τους και να το εισαγάγουν σε οποιοδήποτε πορτοφόλι Open Badges 3.0.
Ο έλεγχος υπογραφής γίνεται πολύτιμος όταν:
- ένας εργοδότης ή ένα πανεπιστήμιο θέλει να αυτοματοποιήσει τον έλεγχο των διαπιστευτηρίων που λαμβάνει·
- χτίζετε ένα σύστημα αρχείων που αποθηκεύει αντίγραφα διαπιστευτηρίων και πρέπει να αποδείξει ότι δεν αλλοιώθηκαν·
- ένας ελεγκτής ζητά απόδειξη ότι τα διαπιστευτήριά σας είναι ανεξάρτητα επαληθεύσιμα και όχι απλώς «εμπιστευτείτε την ιστοσελίδα μας».
Η ίδια ρύθμιση κλειδιού API που χρησιμοποιείται για την έκδοση δεν χρειάζεται εδώ, επειδή όλα αυτά τα endpoints είναι δημόσια. Αν θέλετε να εκδίδετε διαπιστευτήρια από κώδικα, το API quickstart σας καθοδηγεί στη δημιουργία κλειδιού και της πρώτης σας απονομής.

Γρήγορη αναφορά
| Στοιχείο | Τιμή |
|---|---|
| Υπογεγραμμένο διαπιστευτήριο | GET https://api.badges.ninja/certify-badge/award/<awardId>/vc |
| Μη υπογεγραμμένο JSON για ανάγνωση | ίδιο URL με ?format=json |
| DID εκδότη | did:web:api.badges.ninja |
| Δημόσια κλειδιά | /.well-known/jwks.json και /.well-known/did.json |
| Αλγόριθμος | Ed25519 (EdDSA) |
| Αντιστοίχιση κλειδιού | το τμήμα του kid της κεφαλίδας ισούται με το kid του JWKS |
| Ανάκληση | credentialStatus που δείχνει στο /certify-badge/status/<listId> |
Συνοψίζοντας
Η επαλήθευση της υπογραφής ενός Open Badge είναι μια σύντομη, μηχανική διαδικασία: λάβετε το token, καρφώστε τον αλγόριθμο, βρείτε το κλειδί από το αποτύπωμα και ελέγξτε την υπογραφή Ed25519 πάνω στα δύο πρώτα τμήματα. Προσθέστε ελέγχους λήξης και ανάκλησης και έχετε έναν επαληθευτή που δεν εμπιστεύεται κανέναν εκτός από το δημοσιευμένο κλειδί του εκδότη. Αυτή η ανεξαρτησία κάνει ένα ψηφιακό διαπιστευτήριο να αξίζει περισσότερο από ένα PDF.
Έτοιμοι να εκδώσετε το πρώτο σας επαληθεύσιμο διαπιστευτήριο; Ξεκινήστε δωρεάν στο badges.ninja — οπτικός σχεδιαστής, δημόσια σελίδα επαλήθευσης, πιστοποιητικό PDF, έξοδος Open Badge v2.0. Δεν απαιτείται πιστωτική κάρτα.
Πώς δημιουργήθηκε αυτό το άρθρο
Ορισμένες αναρτήσεις σε αυτό το blog συντάσσονται με τη βοήθεια ενός βοηθού AI και στη συνέχεια ελέγχονται, επαληθεύονται και επεξεργάζονται από την ομάδα της Badges Ninja πριν από τη δημοσίευση. Κάθε δείγμα κώδικα και τιμή επαληθεύεται με το ζωντανό προϊόν. Διαβάστε περισσότερα για τη συντακτική μας διαδικασία και τη διαδικασία AI στη σελίδα συντακτικής διαδικασίας .

Σχετικά με τον συγγραφέα
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.
Περισσότερα από Nacho Coll
- Open Badges για Coding Bootcamp: Έκδοση επαληθεύσιμων διαπιστευτηρίων σε κλίμακα κοορτής19 Νοε 2026 · 12λεπτά ανάγνωσης
- Ρύθμιση Webhooks για συμβάντα ψηφιακών σημάτων: ενσωμάτωση σε πραγματικό χρόνο με το backend σας16 Νοε 2026 · 9λεπτά ανάγνωσης
- Λήξη και ανανέωση των Open Badges: διαχείριση κύκλου ζωής για διαπιστευτήρια περιορισμένης διάρκειας12 Νοε 2026 · 12λεπτά ανάγνωσης


