So widerrufst du ein Open Badge (und was mit der Kopie des Empfängers passiert)

Widerruf bei Open Badges: wie er funktioniert, was sich für den Empfänger ändert und wie du „irrtümlich ausgestellt“, „Nachweis abgelaufen“ und „Richtlinienverstoß“ richtig behandelst.

Nacho Coll Von Aktualisiert 10 Min. Lesezeit
Widerruf bei Open Badges: wie er funktioniert, was sich für den Empfänger ändert und wie du „irrtümlich ausgestellt“, „Nachweis abgelaufen“ und „Richtlinienverstoß“ richtig behandelst.

Früher oder später muss jedes Programm, das digitale Nachweise ausstellt, einen davon zurücknehmen. Ein Zertifikat ging an die falsche Person. Ein Lernender hat bei der Abschlussprüfung geschummelt. Ein Partnervertrag ist ausgelaufen, und die Abzeichen mit „Certified Partner“ sollten nicht mehr gültig sein. Das Ausstellen ist der Happy Path; der Widerruf entscheidet darüber, ob man deinen Nachweisen wirklich vertrauen kann.

Dieser Leitfaden erklärt, wie der Widerruf bei Open Badges funktioniert, was der Empfänger danach sieht und was nicht, und wie du bei https://badges.ninja einen Nachweis oder mehrere hundert widerrufst, über das Dashboard oder die API.

Was „widerrufen“ bei Open Badges bedeutet

In der Open-Badges-v2.0-Spezifikation ist jedes ausgestellte Abzeichen eine Assertion: ein kleines JSON-LD-Dokument unter einer öffentlichen URL, das besagt: „Dieser Aussteller hat dieses Abzeichen an diesen Empfänger an diesem Datum verliehen.“ Ein Widerruf ist schlicht eine Änderung an diesem gehosteten Dokument. Die Assertion erhält "revoked": true und optional einen "revocationReason"-String, der den Grund erklärt.

Dieses Design hat eine wichtige Konsequenz, die viele Programmverantwortliche überrascht:

  • Die gehostete Assertion ist die maßgebliche Quelle. Wer den Nachweis über die Assertion-URL oder die Verifizierungsseite prüft, sieht den widerrufenen Status sofort.
  • Kopien werden nicht zurückgerufen. Hat der Empfänger das Abzeichenbild oder das JSON heruntergeladen oder in ein Portfolio gepinnt, ändert sich diese Datei nicht. Sie enthält weiterhin einen Link zu deiner gehosteten Assertion, ein Prüfer, der dem Link folgt, sieht also den Widerruf, aber wer nur kurz auf eine gespeicherte PNG schaut, sieht ihn nicht.

Ein Widerruf ist also eine Aussage am Verifizierungsendpunkt, keine Löschung. Stell es dir so vor, als würdest du den Originaldatensatz mit „UNGÜLTIG“ abstempeln, statt jeder einzelnen Fotokopie hinterherzulaufen.

Wenn du dir das Dokument selbst genauer ansehen möchtest, geht unser Open-Badge-JSON-LD-Walkthrough jedes Feld durch.

Widerrufen, neu ausstellen oder löschen: die richtige Aktion wählen

Bevor du irgendwo klickst, entscheide, welche der drei Aktionen zur Situation passt. Sie sind nicht austauschbar.

SituationBeste AktionWarum
Nachweis wurde an die falsche Person oder mit einem Tippfehler ausgestelltLöschen (wenn nie gesendet) oder Widerrufen, dann neu ausstellenLöschen entfernt den Datensatz komplett; Widerrufen bewahrt eine Prüfspur
Lernender hat gegen eine Richtlinie verstoßen oder den Nachweis unrechtmäßig erlangtWiderrufen, mit GrundDer Datensatz bleibt als widerrufen verifizierbar, was du bei einem Streitfall willst
Nachweis hat einfach sein Enddatum erreichtNichts tun; beim Ausstellen ein Ablaufdatum setzenAblauf ist ein normaler Lebenszyklus-Vorgang, kein Widerruf
Programm eingestellt, Kohorte für ungültig erklärtMassenwiderrufEin Job, ein Grund, für alle angewendet
Angaben waren falsch, der Nachweis ist sonst aber gültigVor dem Senden bearbeiten, oder nach dem Senden widerrufen und neu ausstellenHält die Erfahrung des Empfängers sauber

Zwei Faustregeln:

  1. Bevorzuge Widerrufen gegenüber Löschen bei allem, was real ist. Die öffentliche Seite eines gelöschten Nachweises liefert einen Not-found-Fehler. Ein widerrufener Nachweis löst sich weiterhin auf und sagt klar, dass er widerrufen ist, was ein viel besserer Beleg ist, falls später jemand nachfragt, was passiert ist.
  2. Nutze den Widerruf nie als Ersatz für den Ablauf. Ist ein Nachweis nur zwei Jahre gültig, setze beim Ausstellen ein Ablaufdatum. Ein Abzeichen, das still verfällt, ist etwas anderes als eines, das zurückgezogen wurde, und deine Verifizierungsseite sollte angeben, was zutrifft.

Widerrufen über das Dashboard

Für eine Handvoll Nachweise ist das Dashboard der schnellste Weg und braucht keinen Code.

  1. Melde dich an und öffne Awards in der Seitenleiste.
  2. Finde den Nachweis. Die Liste zeigt Empfänger, Abzeichenname, Ausstellungsdatum und Ablauf, und du kannst nach Empfänger suchen.
  3. Klicke auf die Zeile (oder View), um das Detailfenster des Nachweises zu öffnen.
  4. Klicke auf Revoke.
  5. Gib im Bestätigungsdialog optional einen Grund ein und hake optional Email the recipient that their credential was revoked an.
  6. Bestätige.

Award detail modal

Der Nachweis bleibt in deiner Liste, mit einem roten Revoked-Chip neben dem Empfänger, damit du und dein Team immer sehen können, was zurückgezogen wurde. Ein Widerruf erstattet den Nachweis nicht auf dein Plan-Kontingent zurück. Du hast ihn ausgestellt, er wurde gezählt.

Ein Hinweis zum Grundfeld

Der Grund ist optional, aber trag ihn ein. Er wird mit dem Nachweis gespeichert, erscheint als revocationReason in der öffentlichen Open-Badges-Assertion und ist in der Webhook-Payload enthalten, die deine Systeme erhalten. Weil er in der Assertion öffentlich ist, formuliere ihn so, wie du es für einen externen Leser tun würdest. „Irrtümlich ausgestellt“ oder „Programm eingestellt“ ist in Ordnung. „Jane hat bei Frage 14 geschummelt“ ist es nicht. Bewahre persönliche Details in deinen eigenen Unterlagen auf und halte den öffentlichen Grund neutral.

Solltest du den Empfänger per E-Mail informieren?

Meistens ja. Ein Lernender, der erst davon erfährt, dass sein Nachweis ungültig ist, wenn ein Arbeitgeber auf den Verifizierungslink klickt, hat jedes Recht, sauer auf dich zu sein. Die Benachrichtigung ist genau deshalb opt-in, weil manche Widerrufe (etwa das Aufräumen von Testawards) niemanden behelligen müssen. Unsere Empfehlung:

  • Per E-Mail informieren, wenn der Widerruf eine reale Person betrifft, die den Nachweis womöglich noch vorzeigt.
  • Keine E-Mail, wenn du interne Testdaten aufräumst oder Nachweise für ungültig erklärst, die nie versendet wurden.

Viele Nachweise auf einmal widerrufen

Programme müssen selten einen einzelnen Nachweis isoliert widerrufen; häufiger geht es um eine ganze Kohorte. In der Awards-Liste:

  1. Hake die Nachweise an, die du zurückziehen möchtest.
  2. Klicke in der Massenaktionsleiste auf Revoke selected.
  3. Füge einen Grund hinzu, entscheide, ob die Empfänger benachrichtigt werden sollen, und bestätige.

Der Massenwiderruf läuft als dauerhafter Hintergrundjob, sodass ein paar hundert Nachweise deinen Browser-Tab nicht in ein Timeout laufen lassen. Bereits widerrufene Nachweise werden übersprungen, statt den Batch scheitern zu lassen, und ein mittendrin unterbrochener Job kann fortgesetzt werden. Dieselbe Technik steckt hinter dem Massenausstellen aus einer Tabelle, das wir in Open Badges aus einer CSV ausstellen behandeln.

Widerrufen über die API

Wenn dein Lernsystem oder deine HR-Plattform entscheidet, wer nicht mehr zertifiziert ist, kannst du programmatisch widerrufen. Der Endpunkt ist POST /awards/{awardId}/revoke, authentifiziert mit einem API-Key (X-Api-Key: bws_<32-hex>) oder einem Cognito-Bearer-Token. Die Award-ID steht im Pfad; reason und notify kommen in den JSON-Body, beide sind optional.

Mit 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>"}

In 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

Und in 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

Ein paar praktische Details, die du kennen solltest:

  • Der Aufruf ist idempotent. Wird ein bereits widerrufener Nachweis erneut widerrufen, kommt dieselbe Erfolgsantwort zurück und es wird keine zweite Benachrichtigung gesendet. Damit ist er sicher aus einem Job mit Wiederholungen aufrufbar.
  • Gründe werden auf 500 Zeichen gekürzt.
  • notify ist standardmäßig false. Es wird nichts gemailt, wenn du es nicht verlangst.
  • Massenwiderruf ist über den Bulk-Endpunkt mit action: "revoke" und einer Liste von Award-IDs möglich; er liefert eine Job-ID zurück, die du verfolgen kannst. Alle Parameter stehen in der Awards-API-Referenz.

Die API brauchst du nur, wenn der Widerruf von einem anderen System ausgelöst wird. Für einen Einzelfall ist das Dashboard schneller und hat einen Bestätigungsschritt, der dich vor einer falsch getippten ID schützt.

Was Empfänger und Prüfer sehen

So ändert sich die Lage nach dem Widerruf, und wie schnell.

Auf der öffentlichen Verifizierungsseite. Die Seite unter https://badges.ninja/awards/<award-id> zeigt den Nachweis als widerrufen, und der Seitentitel für das Teilen in sozialen Netzwerken wird mit „[Revoked]“ eingeleitet, damit ein geteilter Link in einer Vorschaukarte nicht wie ein gültiger Nachweis aussieht.

In der Open-Badges-v2.0-Assertion. Das gehostete JSON unter https://api.badges.ninja/certify-badge/award/<award-id> enthält jetzt "revoked": true sowie "revocationReason", falls du einen Grund angegeben hast. Widerrufene Assertions werden nur etwa 30 Sekunden gecacht, gültige dagegen fünf Minuten, sodass die Änderung Prüfer schnell erreicht.

Im Open-Badges-3.0-Credential. Der Widerruf setzt außerdem das Bit des Nachweises in einer W3C Bitstring Status List um, woran Wallets und Prüfer für Verifiable Credentials ihn erkennen. Diese Liste wird kurz gecacht, rechne also mit einer Verbreitung innerhalb von etwa einer Minute. Wenn du die beiden Versionen abwägst, lies Open Badges v2 vs v3.

In der eigenen Kopie des Empfängers. An der heruntergeladenen Datei ändert sich nichts. Das Abzeichenbild auf seinem Laptop sieht identisch aus. Es ändert sich das Ergebnis der Verifizierung: Wer den Link anklickt oder den Nachweis programmatisch prüft, erhält die Antwort „widerrufen“. Wenn du den Empfänger benachrichtigt hast, hat er außerdem eine E-Mail, die das Warum erklärt.

Auf LinkedIn. Ein zu einem LinkedIn-Profil hinzugefügter Nachweis ist ein Link plus Metadaten, die auf deine Verifizierungsseite zeigen. LinkedIn prüft nicht in deinem Auftrag auf Widerruf, der Eintrag kann also im Profil stehen bleiben, aber wer dem Link folgt, landet auf der Widerrufsseite. Das ist ein weiterer Grund, die Benachrichtigung zu senden und den Empfänger zu bitten, den Eintrag zu entfernen.

Deine eigenen Systeme informieren: Webhooks

Ein Widerruf ist in deiner Organisation selten das Ende der Geschichte. Der Lernende muss vielleicht den Zugang zu einer Community verlieren, ein Arbeitgeberdatensatz muss aktualisiert oder ein CRM-Tag entfernt werden. Badges Ninja sendet beim Widerruf eines Nachweises ein credential.revoked-Webhook-Event mit der Award-URL und dem Grund:

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

Abonniere es, und deine nachgelagerten Systeme bleiben im Gleichschritt, ohne dass jemand daran denken muss, sie zu aktualisieren. Details zur Einrichtung findest du in der Webhook-Dokumentation, und das umfassendere Event-Modell behandeln wir in Webhook-Setup für Badge-Events.

Eine einfache Widerrufsrichtlinie, die du heute übernehmen kannst

Die Werkzeuge sind die leichte Hälfte. Die schwerere Hälfte ist, vorab zu entscheiden, wann du widerrufst und wer es darf. Eine kurze schriftliche Richtlinie verhindert später Streit. Eine brauchbare Vorlage:

  1. Widerrufsgründe. Liste sie auf: irrtümlich ausgestellt, durch Fehlverhalten erlangt, Voraussetzung nicht mehr erfüllt (zum Beispiel eine abgelaufene Mitgliedschaft) oder Programm eingestellt.
  2. Wer entscheidet. Nenne eine Rolle, keine Person. Beschränke die Widerrufsberechtigung auf diese Rolle.
  3. Benachrichtigung. Lege fest, dass Empfänger per E-Mail mit Begründung informiert werden, es sei denn, der Nachweis wurde nie zugestellt.
  4. Einspruch. Gib Empfängern eine Möglichkeit, die Entscheidung anzufechten, und nenne die Bearbeitungszeit. Hat ein Einspruch Erfolg, stelle einen neuen Nachweis aus, statt den Widerruf rückgängig machen zu wollen, so bleibt die Historie sauber.
  5. Dokumentation. Führe intern Buch darüber, wer was warum widerrufen hat, getrennt vom neutralen öffentlichen Grund.

Veröffentliche die Richtlinie auf derselben Seite, auf der du den Nachweis beschreibst, damit Erwerber die Regeln kennen, bevor sie sich anmelden.

Häufige Fehler, die du vermeiden solltest

  • Löschen, obwohl du widerrufen wolltest. Löschen ist endgültig, nicht rückgängig zu machen, und lässt die öffentliche Seite verschwinden. Nutze es für echte Fehler bei Nachweisen, die noch niemand gesehen hat.
  • Private Details im Grund. Er ist in der Assertion öffentlich.
  • Zu erwarten, dass gespeicherte Kopien sich ändern. Der Widerruf lebt am Verifizierungsendpunkt. Bitte Empfänger, den Nachweis aus Profilen und Portfolios zu entfernen.
  • Widerrufen statt ablaufen lassen. Nutze ein Ablaufdatum für zeitlich begrenzte Nachweise.
  • Von einer Erstattung auszugehen. Widerrufene Nachweise zählen weiterhin auf dein Plan-Kontingent.
  • Nachgelagerte Systeme zu vergessen. Richte den Webhook ein, damit Zugänge und Datensätze dem Status des Nachweises folgen.

Häufig gestellte Fragen

Kann ich einen Widerruf rückgängig machen? Nicht über die Oberfläche. Hast du versehentlich widerrufen, stelle dem Empfänger einen neuen Nachweis aus. Der widerrufene bleibt als Teil der Prüfspur bestehen.

Muss der Empfänger etwas tun? Nein. Wenn du ihn benachrichtigen wolltest, bekommt er eine E-Mail. Sonst geschieht die Änderung still auf der Verifizierungsseite.

Funktioniert der Widerruf auch bei Nachweisen, die nie gesendet wurden? Ja, doch bei einem ungesendeten Nachweis mit einem einfachen Fehler bearbeitest du ihn vielleicht lieber vor dem Senden oder löschst ihn, wenn ihn noch niemand gesehen hat.

Gibt es ein Limit, wie viele ich widerrufen kann? Der Massenwiderruf läuft als fortsetzbarer Hintergrundjob, große Batches werden also in einem Vorgang statt einzeln verarbeitet.

Sehen Arbeitgeber, dass ein Nachweis widerrufen wurde? Jeder, der ihn über seine öffentliche URL oder Assertion verifiziert, sieht den Status „widerrufen“ und den Grund, falls du einen angegeben hast.

Fazit

Ein Open Badge zu widerrufen ist eine kleine Handlung mit echten Folgen für das Vertrauen. Mach es im Dashboard, wenn es um einen einzelnen Nachweis geht, nutze den Massenwiderruf für eine Kohorte und greife zu API oder Webhooks, wenn ein anderes System die Entscheidung trifft. Halte Gründe neutral, benachrichtige die, die es wissen müssen, und denk daran: Ein Widerruf ändert, was Prüfer sehen, nicht die Dateien, die schon in den Händen der Empfänger sind.

Bereit, deinen ersten verifizierbaren Nachweis auszustellen? Kostenlos starten bei badges.ninja — visueller Designer, öffentliche Verifizierungsseite, PDF-Zertifikat, Open-Badge-v2.0-Ausgabe. Keine Kreditkarte nötig.

Nacho Coll

Über den Autor

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.

Zurück zum Blog

Verwandte Artikel