Πώς να ανακαλέσετε ένα Open Badge (και τι συμβαίνει με το αντίγραφο του αποδέκτη)

Η ανάκληση στα Open Badges: πώς λειτουργεί, τι αλλάζει για τον αποδέκτη και ο σωστός τρόπος διαχείρισης των περιπτώσεων «εκδόθηκε κατά λάθος», «το διαπιστευτήριο έληξε» και «παραβίαση πολιτικής».

Nacho Coll Από Ενημερώθηκε 11 λεπτά ανάγνωσης
Η ανάκληση στα Open Badges: πώς λειτουργεί, τι αλλάζει για τον αποδέκτη και ο σωστός τρόπος διαχείρισης των περιπτώσεων «εκδόθηκε κατά λάθος», «το διαπιστευτήριο έληξε» και «παραβίαση πολιτικής».

Αργά ή γρήγορα, κάθε πρόγραμμα που εκδίδει ψηφιακά διαπιστευτήρια πρέπει να πάρει ένα πίσω. Ένα πιστοποιητικό πήγε στο λάθος άτομο. Ένας εκπαιδευόμενος βρέθηκε να έχει αντιγράψει στην τελική αξιολόγηση. Ένα συνεργατικό συμβόλαιο έληξε και τα σήματα που έγραφαν «Πιστοποιημένος συνεργάτης» δεν πρέπει πλέον να ισχύουν. Η έκδοση είναι το ευχάριστο μέρος· η ανάκληση είναι αυτή που κρίνει αν τα διαπιστευτήριά σας μπορούν πραγματικά να θεωρηθούν αξιόπιστα.

Αυτός ο οδηγός εξηγεί πώς λειτουργεί η ανάκληση στα Open Badges, τι βλέπει και τι δεν βλέπει ο αποδέκτης μετά, και πώς να ανακαλέσετε ένα διαπιστευτήριο ή μερικές εκατοντάδες στο https://badges.ninja, από τον πίνακα ελέγχου ή μέσω του API.

Τι σημαίνει «ανάκληση» στα Open Badges

Στην προδιαγραφή Open Badges v2.0, κάθε εκδοθέν σήμα είναι ένα assertion: ένα μικρό έγγραφο JSON-LD που φιλοξενείται σε δημόσιο URL και λέει «αυτός ο εκδότης απένειμε αυτό το σήμα σε αυτόν τον αποδέκτη την τάδε ημερομηνία». Η ανάκληση είναι απλώς μια αλλαγή σε αυτό το φιλοξενούμενο έγγραφο. Το assertion παίρνει "revoked": true και, προαιρετικά, μια συμβολοσειρά "revocationReason" που εξηγεί το γιατί.

Αυτός ο σχεδιασμός έχει μια σημαντική συνέπεια που εκπλήσσει πολλούς υπευθύνους προγραμμάτων:

  • Το φιλοξενούμενο assertion είναι η πηγή αλήθειας. Όποιος επαληθεύει το διαπιστευτήριο ανοίγοντας το URL του assertion ή τη σελίδα επαλήθευσης βλέπει αμέσως την κατάσταση ανάκλησης.
  • Τα αντίγραφα δεν ανακαλούνται. Αν ο αποδέκτης κατέβασε την εικόνα του σήματος ή το JSON, ή το καρφίτσωσε σε ένα portfolio, αυτό το αρχείο δεν αλλάζει. Περιέχει ακόμη έναν σύνδεσμο προς το φιλοξενούμενο assertion σας, οπότε όποιος ακολουθήσει τον σύνδεσμο θα δει ότι έχει ανακληθεί, αλλά όποιος ρίξει μια ματιά σε ένα αποθηκευμένο PNG δεν θα το δει.

Η ανάκληση είναι επομένως μια δήλωση στο σημείο επαλήθευσης, όχι διαγραφή. Σκεφτείτε την ως σφραγίδα «ΑΚΥΡΟ» στο πρωτότυπο αρχείο, αντί να κυνηγάτε κάθε φωτοτυπία.

Αν θέλετε να δείτε το ίδιο το έγγραφο από κοντά, η ανάλυση του Open Badge JSON-LD περνά από κάθε πεδίο.

Ανάκληση, επανέκδοση ή διαγραφή: διαλέξτε τη σωστή ενέργεια

Πριν πατήσετε οτιδήποτε, αποφασίστε ποια από τις τρεις ενέργειες ταιριάζει στην περίπτωσή σας. Δεν είναι εναλλάξιμες.

ΠερίπτωσηΚαλύτερη ενέργειαΓιατί
Το διαπιστευτήριο εκδόθηκε σε λάθος άτομο ή με τυπογραφικό λάθοςΔιαγραφή (αν δεν στάλθηκε ποτέ) ή Ανάκληση και μετά επανέκδοσηΗ διαγραφή αφαιρεί εντελώς την εγγραφή· η ανάκληση διατηρεί ίχνος ελέγχου
Ο εκπαιδευόμενος παραβίασε μια πολιτική ή το διαπιστευτήριο αποκτήθηκε με αθέμιτο τρόποΑνάκληση, με αιτιολογίαΗ εγγραφή παραμένει επαληθεύσιμη ως ανακληθείσα, κάτι που θέλετε σε περίπτωση διαφωνίας
Το διαπιστευτήριο απλώς έφτασε στην ημερομηνία λήξης τουΜην κάνετε τίποτα· ορίστε λήξη κατά την έκδοσηΗ λήξη είναι φυσιολογικό γεγονός του κύκλου ζωής, όχι ανάκληση
Το πρόγραμμα ακυρώθηκε, η ομάδα (cohort) ακυρώθηκεΜαζική ανάκλησηΜία εργασία, μία αιτιολογία, για όλους
Τα στοιχεία ήταν λάθος αλλά το διαπιστευτήριο κατά τα άλλα ισχύειΕπεξεργασία πριν την αποστολή, ή ανάκληση και επανέκδοση μετά την αποστολήΚρατά καθαρή την εμπειρία του αποδέκτη

Δύο εμπειρικοί κανόνες:

  1. Προτιμήστε την ανάκληση από τη διαγραφή για οτιδήποτε πραγματικό. Η δημόσια σελίδα ενός διαγραμμένου διαπιστευτηρίου επιστρέφει σφάλμα «δεν βρέθηκε». Ένα ανακληθέν εξακολουθεί να φορτώνεται και δηλώνει καθαρά ότι έχει ανακληθεί, κάτι που αποτελεί πολύ καλύτερη απόδειξη αν κάποιος ρωτήσει αργότερα τι συνέβη.
  2. Ποτέ μη χρησιμοποιείτε την ανάκληση ως υποκατάστατο της λήξης. Αν ένα διαπιστευτήριο ισχύει μόνο για δύο χρόνια, ορίστε ημερομηνία λήξης κατά την έκδοση. Ένα σήμα που λήγει αθόρυβα διαφέρει από ένα που αποσύρθηκε, και η σελίδα επαλήθευσής σας πρέπει να λέει ποιο από τα δύο ισχύει.

Ανάκληση από τον πίνακα ελέγχου

Για λίγα διαπιστευτήρια, ο πίνακας ελέγχου είναι ο ταχύτερος δρόμος και δεν χρειάζεται κώδικα.

  1. Συνδεθείτε και ανοίξτε το Awards από την πλαϊνή μπάρα.
  2. Βρείτε το διαπιστευτήριο. Η λίστα δείχνει τον αποδέκτη, το όνομα του σήματος, την ημερομηνία έκδοσης και τη λήξη, και μπορείτε να κάνετε αναζήτηση ανά αποδέκτη.
  3. Κάντε κλικ στη γραμμή (ή στο View) για να ανοίξετε το παράθυρο λεπτομερειών του διαπιστευτηρίου.
  4. Κάντε κλικ στο Revoke.
  5. Στο παράθυρο επιβεβαίωσης, εισαγάγετε προαιρετικά μια αιτιολογία και προαιρετικά επιλέξτε Email the recipient that their credential was revoked.
  6. Επιβεβαιώστε.

Award detail modal

Το διαπιστευτήριο παραμένει στη λίστα σας με ένα κόκκινο σήμα Revoked δίπλα στον αποδέκτη, ώστε εσείς και η ομάδα σας να βλέπετε πάντα τι έχει αποσυρθεί. Η ανάκληση δεν επιστρέφει το διαπιστευτήριο στο όριο του πλάνου σας. Το εκδώσατε, μετρήθηκε.

Μια σημείωση για το πεδίο αιτιολογίας

Η αιτιολογία είναι προαιρετική, αλλά συμπληρώστε την. Αποθηκεύεται μαζί με το διαπιστευτήριο, εμφανίζεται ως revocationReason στο δημόσιο assertion του Open Badges και περιλαμβάνεται στο webhook payload που λαμβάνουν τα συστήματά σας. Επειδή είναι δημόσια στο assertion, γράψτε την όπως θα γράφατε για έναν εξωτερικό αναγνώστη. Το «Εκδόθηκε κατά λάθος» ή «Το πρόγραμμα ακυρώθηκε» είναι εντάξει. Το «Η Μαρία αντέγραψε στην ερώτηση 14» δεν είναι. Κρατήστε τα προσωπικά στοιχεία στα δικά σας αρχεία και κρατήστε τη δημόσια αιτιολογία ουδέτερη.

Να στείλετε email στον αποδέκτη;

Συνήθως ναι. Ένας εκπαιδευόμενος που μαθαίνει ότι το διαπιστευτήριό του έπαψε να ισχύει μόνο όταν ένας εργοδότης ανοίξει τον σύνδεσμο επαλήθευσης έχει κάθε δικαίωμα να είναι δυσαρεστημένος μαζί σας. Η ειδοποίηση είναι προαιρετική ακριβώς επειδή κάποιες ανακλήσεις (π.χ. ένας μαζικός καθαρισμός δοκιμαστικών διαπιστευτηρίων) δεν χρειάζεται να ενοχλήσουν κανέναν. Η συμβουλή μας:

  • Στείλτε email όταν η ανάκληση αφορά πραγματικό άτομο που ίσως εξακολουθεί να εμφανίζει το διαπιστευτήριο.
  • Παραλείψτε το email όταν τακτοποιείτε εσωτερικά δοκιμαστικά δεδομένα ή ακυρώνετε διαπιστευτήρια που δεν στάλθηκαν ποτέ.

Ανάκληση πολλών διαπιστευτηρίων ταυτόχρονα

Τα προγράμματα σπάνια χρειάζονται να ανακαλέσουν ένα διαπιστευτήριο μεμονωμένα· πιο συχνά πρόκειται για μια ολόκληρη ομάδα. Στη λίστα Awards:

  1. Επιλέξτε τα πλαίσια των διαπιστευτηρίων που θέλετε να αποσύρετε.
  2. Κάντε κλικ στο Revoke selected στη γραμμή μαζικών ενεργειών.
  3. Προσθέστε αιτιολογία και αποφασίστε αν θα ειδοποιηθούν οι αποδέκτες, και μετά επιβεβαιώστε.

Η μαζική ανάκληση εκτελείται ως ανθεκτική εργασία παρασκηνίου, οπότε μερικές εκατοντάδες διαπιστευτήρια δεν θα προκαλέσουν timeout στην καρτέλα του προγράμματος περιήγησής σας. Τα διαπιστευτήρια που έχουν ήδη ανακληθεί παραλείπονται αντί να αποτύχει η δέσμη, και μια εργασία που διακόπηκε στη μέση μπορεί να συνεχιστεί. Ο ίδιος μηχανισμός τροφοδοτεί τη μαζική έκδοση από υπολογιστικό φύλλο, που καλύπτουμε στο πώς να εκδώσετε Open Badges από CSV.

Ανάκληση μέσω του API

Αν το σύστημα μάθησης ή η πλατφόρμα HR σας αποφασίζει ποιος δεν είναι πλέον πιστοποιημένος, μπορείτε να κάνετε ανάκληση προγραμματιστικά. Το endpoint είναι POST /awards/{awardId}/revoke, με έλεγχο ταυτότητας μέσω API key (X-Api-Key: bws_<32-hex>) ή Cognito Bearer token. Το award ID μπαίνει στο path· τα reason και notify μπαίνουν στο σώμα JSON και είναι και τα δύο προαιρετικά.

Με 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:

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

Και σε Python:

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

Μερικές πρακτικές λεπτομέρειες που αξίζει να γνωρίζετε:

  • Είναι αδύναμο (idempotent). Η ανάκληση ενός ήδη ανακληθέντος διαπιστευτηρίου επιστρέφει την ίδια επιτυχή απάντηση και δεν στέλνει δεύτερη ειδοποίηση. Έτσι είναι ασφαλές να την καλείτε από εργασία που κάνει επαναπροσπάθειες.
  • Οι αιτιολογίες περικόπτονται στους 500 χαρακτήρες.
  • Το notify έχει προεπιλογή false. Δεν στέλνεται τίποτα με email αν δεν το ζητήσετε.
  • Η μαζική ανάκληση είναι διαθέσιμη μέσω του bulk endpoint με action: "revoke" και μια λίστα από award IDs· επιστρέφει ένα job ID που μπορείτε να παρακολουθείτε. Οι πλήρεις παράμετροι βρίσκονται στην αναφορά του awards API.

Χρειάζεστε το API μόνο όταν η ανάκληση καθοδηγείται από άλλο σύστημα. Για μία φορά, ο πίνακας ελέγχου είναι πιο γρήγορος και έχει βήμα επιβεβαίωσης που σας προστατεύει από ένα λανθασμένο ID.

Τι βλέπουν ο αποδέκτης και ο επαληθευτής

Αφού κάνετε την ανάκληση, να τι αλλάζει και πόσο γρήγορα.

Στη δημόσια σελίδα επαλήθευσης. Η σελίδα στο https://badges.ninja/awards/<award-id> εμφανίζει το διαπιστευτήριο ως ανακληθέν, και ο τίτλος της σελίδας για κοινοποίηση στα κοινωνικά δίκτυα έχει το πρόθεμα «[Revoked]», ώστε ένας κοινοποιημένος σύνδεσμος να μη φαίνεται σαν ενεργό διαπιστευτήριο σε μια κάρτα προεπισκόπησης.

Στο assertion Open Badges v2.0. Το φιλοξενούμενο JSON στο https://api.badges.ninja/certify-badge/award/<award-id> φέρει πλέον "revoked": true, και "revocationReason" αν δώσατε αιτιολογία. Τα ανακληθέντα assertions αποθηκεύονται στην κρυφή μνήμη μόνο για περίπου 30 δευτερόλεπτα, ενώ τα ενεργά για πέντε λεπτά, οπότε η αλλαγή φτάνει γρήγορα στους επαληθευτές.

Στο διαπιστευτήριο Open Badges 3.0. Η ανάκληση αλλάζει επίσης το bit του διαπιστευτηρίου σε μια W3C Bitstring Status List, και αυτός είναι ο τρόπος με τον οποίο τα πορτοφόλια και οι επαληθευτές verifiable credentials την εντοπίζουν. Η λίστα αυτή αποθηκεύεται σύντομα στην κρυφή μνήμη, οπότε περιμένετε διάδοση μέσα σε περίπου ένα λεπτό. Αν σταθμίζετε τις δύο εκδόσεις, δείτε το Open Badges v2 vs v3.

Στο δικό του αντίγραφο του αποδέκτη. Τίποτα δεν αλλάζει στο αρχείο που κατέβασε. Η εικόνα του σήματος στον φορητό του υπολογιστή φαίνεται ίδια. Αλλάζει το αποτέλεσμα της επαλήθευσης: όποιος κάνει κλικ στον σύνδεσμο ή ελέγχει το διαπιστευτήριο προγραμματιστικά παίρνει την απάντηση «ανακληθέν». Αν τον ειδοποιήσατε, έχει και ένα email που εξηγεί το γιατί.

Στο LinkedIn. Ένα διαπιστευτήριο που προστέθηκε σε προφίλ LinkedIn είναι ένας σύνδεσμος μαζί με μεταδεδομένα που δείχνουν πίσω στη σελίδα επαλήθευσής σας. Το LinkedIn δεν ελέγχει για ανάκληση εκ μέρους σας, οπότε η καταχώριση μπορεί να παραμείνει στο προφίλ, αλλά όποιος ακολουθήσει τον σύνδεσμο καταλήγει στη σελίδα ανάκλησης. Αυτός είναι ένας ακόμη λόγος να στείλετε την ειδοποίηση και να ζητήσετε από τον αποδέκτη να αφαιρέσει την καταχώριση.

Ενημερώστε τα δικά σας συστήματα: webhooks

Η ανάκληση σπάνια είναι το τέλος της ιστορίας μέσα στον οργανισμό σας. Ο εκπαιδευόμενος μπορεί να χρειάζεται να χάσει την πρόσβαση σε μια κοινότητα, μια εγγραφή εργοδότη μπορεί να χρειάζεται ενημέρωση ή μια ετικέτα CRM μπορεί να χρειάζεται αφαίρεση. Το Badges Ninja εκπέμπει ένα συμβάν webhook credential.revoked όταν ένα διαπιστευτήριο ανακαλείται, με το URL του award και την αιτιολογία:

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

Εγγραφείτε σε αυτό και τα συστήματά σας θα παραμένουν συγχρονισμένα χωρίς να χρειάζεται να θυμάται κανείς να τα ενημερώσει. Οι λεπτομέρειες ρύθμισης βρίσκονται στην τεκμηρίωση των webhooks, και το ευρύτερο μοντέλο συμβάντων το καλύπτουμε στο webhook setup for badge events.

Μια απλή πολιτική ανάκλησης που μπορείτε να υιοθετήσετε σήμερα

Τα εργαλεία είναι το εύκολο μισό. Το δυσκολότερο μισό είναι να αποφασίσετε εκ των προτέρων πότε θα κάνετε ανάκληση και ποιος έχει το δικαίωμα. Μια σύντομη γραπτή πολιτική προλαβαίνει τις διαφωνίες αργότερα. Ένα εφαρμόσιμο πρότυπο:

  1. Λόγοι ανάκλησης. Απαριθμήστε τους: έκδοση κατά λάθος, απόκτηση μέσω παραπτώματος, μη πλήρωση πλέον της προϋπόθεσης (για παράδειγμα, έληξε μια συνδρομή μέλους) ή απόσυρση του προγράμματος.
  2. Ποιος αποφασίζει. Ορίστε έναν ρόλο, όχι ένα πρόσωπο. Περιορίστε το δικαίωμα ανάκλησης σε αυτόν τον ρόλο.
  3. Ειδοποίηση. Δηλώστε ότι οι αποδέκτες ενημερώνονται με email, μαζί με την αιτιολογία, εκτός αν το διαπιστευτήριο δεν παραδόθηκε ποτέ.
  4. Ένσταση. Δώστε στους αποδέκτες τρόπο να αμφισβητήσουν την απόφαση και πείτε σε πόσο χρόνο θα απαντήσετε. Αν μια ένσταση γίνει δεκτή, εκδώστε νέο διαπιστευτήριο αντί να προσπαθήσετε να αναιρέσετε την ανάκληση, και το ιστορικό μένει καθαρό.
  5. Αρχείο. Κρατήστε μια εσωτερική σημείωση για το ποιος ανακάλεσε τι και γιατί, χωριστά από τη δημόσια ουδέτερη αιτιολογία.

Δημοσιεύστε την πολιτική στην ίδια σελίδα όπου περιγράφετε το διαπιστευτήριο, ώστε οι αποδέκτες να γνωρίζουν τους κανόνες πριν εγγραφούν.

Συνηθισμένα λάθη που πρέπει να αποφύγετε

  • Διαγραφή ενώ εννοούσατε ανάκληση. Η διαγραφή είναι μόνιμη και δεν αναιρείται, και κάνει τη δημόσια σελίδα να εξαφανιστεί. Χρησιμοποιήστε την για πραγματικά λάθη σε διαπιστευτήρια που δεν έχει δει κανείς.
  • Ιδιωτικά στοιχεία στην αιτιολογία. Είναι δημόσια στο assertion.
  • Προσδοκία ότι τα αποθηκευμένα αντίγραφα θα αλλάξουν. Η ανάκληση ζει στο σημείο επαλήθευσης. Πείτε στους αποδέκτες να αφαιρέσουν το διαπιστευτήριο από προφίλ και portfolio.
  • Ανάκληση αντί για λήξη. Χρησιμοποιήστε ημερομηνία λήξης για διαπιστευτήρια περιορισμένης διάρκειας.
  • Υπόθεση επιστροφής. Τα ανακληθέντα διαπιστευτήρια εξακολουθούν να προσμετρώνται στο όριο του πλάνου σας.
  • Λήθη των downstream συστημάτων. Συνδέστε το webhook ώστε η πρόσβαση και οι εγγραφές να ακολουθούν την κατάσταση του διαπιστευτηρίου.

Συχνές ερωτήσεις

Μπορώ να αναιρέσω μια ανάκληση; Όχι μέσα από τη διεπαφή. Αν ανακαλέσατε κατά λάθος, εκδώστε νέο διαπιστευτήριο στον αποδέκτη. Το ανακληθέν παραμένει ως μέρος του ίχνους ελέγχου.

Χρειάζεται να κάνει κάτι ο αποδέκτης; Όχι. Αν επιλέξατε να τον ειδοποιήσετε, λαμβάνει ένα email. Διαφορετικά, η αλλαγή γίνεται αθόρυβα στη σελίδα επαλήθευσης.

Λειτουργεί η ανάκληση για διαπιστευτήρια που δεν στάλθηκαν ποτέ; Ναι, αν και για ένα μη σταλμένο διαπιστευτήριο με απλό λάθος ίσως προτιμήσετε να το επεξεργαστείτε πριν την αποστολή ή να το διαγράψετε αν δεν το έχει δει κανείς.

Υπάρχει όριο στο πόσα μπορώ να ανακαλέσω; Η μαζική ανάκληση εκτελείται ως εργασία παρασκηνίου που μπορεί να συνεχιστεί, οπότε οι μεγάλες δέσμες διεκπεραιώνονται σε μία ενέργεια αντί για ένα προς ένα.

Θα δουν οι εργοδότες ότι ένα διαπιστευτήριο ανακλήθηκε; Όποιος το επαληθεύει μέσω του δημόσιου URL ή του assertion του βλέπει την κατάσταση ανάκλησης και την αιτιολογία, αν δώσατε.

Συμπέρασμα

Η ανάκληση ενός Open Badge είναι μια μικρή ενέργεια με πραγματικές συνέπειες για την εμπιστοσύνη. Κάντε την από τον πίνακα ελέγχου όταν πρόκειται για ένα διαπιστευτήριο, χρησιμοποιήστε τη μαζική ανάκληση για μια ομάδα, και καταφύγετε στο API ή τα webhooks όταν την απόφαση την έχει άλλο σύστημα. Κρατήστε τις αιτιολογίες ουδέτερες, ειδοποιήστε όσους πρέπει να γνωρίζουν και θυμηθείτε ότι η ανάκληση αλλάζει ό,τι βλέπουν οι επαληθευτές, όχι τα αρχεία που ήδη βρίσκονται στα χέρια των αποδεκτών.

Έτοιμοι να εκδώσετε το πρώτο σας επαληθεύσιμο διαπιστευτήριο; Ξεκινήστε δωρεάν στο badges.ninja — οπτικός σχεδιαστής, δημόσια σελίδα επαλήθευσης, πιστοποιητικό PDF, έξοδος Open Badge v2.0. Χωρίς πιστωτική κάρτα.

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.

Πίσω στο Blog

Σχετικά άρθρα