Comment révoquer un Open Badge (et ce qu’il advient de la copie du bénéficiaire)
La révocation dans Open Badges : comment elle fonctionne, ce qui change pour le bénéficiaire, et la bonne façon de traiter un « badge émis par erreur », un « identifiant expiré » ou une « violation de règle ».
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.
Tôt ou tard, tout programme qui émet des identifiants numériques doit en reprendre un. Un certificat est parti chez la mauvaise personne. Un apprenant a triché à l’évaluation finale. Un contrat de partenariat s’est terminé et les badges affichant « Certified Partner » ne devraient plus être valides. Émettre, c’est le chemin facile ; la révocation, c’est ce qui décide si vos identifiants sont réellement dignes de confiance.
Ce guide explique comment fonctionne la révocation dans Open Badges, ce que le bénéficiaire voit et ne voit pas ensuite, et comment révoquer un identifiant ou plusieurs centaines sur https://badges.ninja, depuis le tableau de bord ou l’API.
Ce que « révoquer » signifie dans Open Badges
Dans la spécification Open Badges v2.0, chaque badge émis est une assertion : un petit document JSON-LD hébergé à une URL publique qui indique « cet émetteur a décerné ce badge à ce bénéficiaire à cette date ». La révocation n’est qu’une modification de ce document hébergé. L’assertion reçoit "revoked": true et, éventuellement, une chaîne "revocationReason" qui explique pourquoi.
Cette conception a une conséquence importante qui surprend de nombreux responsables de programme :
- L’assertion hébergée est la source de vérité. Quiconque vérifie l’identifiant en récupérant l’URL de l’assertion ou en ouvrant la page de vérification voit immédiatement l’état révoqué.
- Les copies ne sont pas rappelées. Si le bénéficiaire a téléchargé l’image du badge ou le JSON, ou l’a épinglé dans un portfolio, ce fichier ne change pas. Il contient toujours un lien vers votre assertion hébergée : un vérificateur qui suit ce lien verra donc qu’elle est révoquée, mais une personne qui jette un œil à un PNG enregistré ne le verra pas.
La révocation est donc une déclaration faite au point de vérification, pas une suppression. Voyez cela comme un tampon « VOID » apposé sur l’enregistrement d’origine, plutôt que de courir après chaque photocopie.
Pour examiner de plus près le document lui-même, notre présentation pas à pas du JSON-LD d’un Open Badge passe en revue chaque champ.
Révoquer, réémettre ou supprimer : choisir la bonne action
Avant de cliquer sur quoi que ce soit, décidez laquelle des trois actions correspond à la situation. Elles ne sont pas interchangeables.
| Situation | Meilleure action | Pourquoi |
|---|---|---|
| L’identifiant a été émis à la mauvaise personne ou avec une faute de frappe | Supprimer (s’il n’a jamais été envoyé) ou révoquer, puis réémettre | La suppression efface entièrement l’enregistrement ; la révocation conserve une piste d’audit |
| L’apprenant a enfreint une règle ou l’identifiant a été obtenu de manière irrégulière | Révoquer, avec un motif | L’enregistrement reste vérifiable comme révoqué, ce que vous voulez en cas de litige |
| L’identifiant a simplement atteint sa date de fin | Ne rien faire ; définir une expiration à l’émission | L’expiration est un événement normal du cycle de vie, pas une révocation |
| Programme annulé, cohorte invalidée | Révocation en masse | Une tâche, un motif, appliqués à tout le monde |
| Les détails étaient erronés mais l’identifiant reste valide | Modifier avant l’envoi, ou révoquer puis réémettre après l’envoi | Préserve l’expérience du bénéficiaire |
Deux règles pratiques :
- Préférez la révocation à la suppression pour tout ce qui est réel. La page publique d’un identifiant supprimé renvoie une erreur not-found. Celle d’un identifiant révoqué continue de s’afficher et indique clairement qu’il est révoqué, ce qui constitue une bien meilleure preuve si quelqu’un demande plus tard ce qui s’est passé.
- N’utilisez jamais la révocation à la place de l’expiration. Si un identifiant n’est valable que deux ans, définissez une date d’expiration à l’émission. Un badge qui expire discrètement n’est pas la même chose qu’un badge retiré, et votre page de vérification doit indiquer lequel des deux.
Révoquer depuis le tableau de bord
Pour une poignée d’identifiants, le tableau de bord est le chemin le plus rapide et ne demande aucun code.
- Connectez-vous et ouvrez Awards dans la barre latérale.
- Trouvez l’identifiant. La liste affiche le bénéficiaire, le nom du badge, la date d’émission et l’expiration, et vous pouvez rechercher par bénéficiaire.
- Cliquez sur la ligne (ou sur View) pour ouvrir la fenêtre de détail de l’identifiant.
- Cliquez sur Revoke.
- Dans la boîte de dialogue de confirmation, saisissez éventuellement un motif, et cochez éventuellement Email the recipient that their credential was revoked.
- Confirmez.

L’identifiant reste dans votre liste avec une pastille rouge Revoked à côté du bénéficiaire, afin que vous et votre équipe puissiez toujours voir ce qui a été retiré. La révocation ne rembourse pas l’identifiant sur le quota de votre forfait. Vous l’avez émis, il a été compté.
Un mot sur le champ du motif
Le motif est facultatif, mais renseignez-le. Il est enregistré avec l’identifiant, apparaît comme revocationReason dans l’assertion Open Badges publique, et est inclus dans la charge utile du webhook reçue par vos systèmes. Comme il est public dans l’assertion, rédigez-le comme pour un lecteur extérieur. « Issued in error » ou « Program cancelled » conviennent. « Jane a triché à la question 14 » ne convient pas. Gardez les détails personnels dans vos propres dossiers et laissez un motif public neutre.
Faut-il envoyer un e-mail au bénéficiaire ?
En général, oui. Un apprenant qui découvre que son identifiant est invalide seulement lorsqu’un employeur clique sur le lien de vérification a toutes les raisons d’être mécontent de vous. La notification est facultative précisément parce que certaines révocations (un nettoyage en masse d’attributions de test, par exemple) n’ont pas besoin de déranger qui que ce soit. Nos conseils :
- Envoyez un e-mail quand la révocation touche une personne réelle qui pourrait encore afficher l’identifiant.
- Ne l’envoyez pas quand vous faites le ménage dans des données de test internes ou invalidez des identifiants qui n’ont jamais été envoyés.
Révoquer plusieurs identifiants à la fois
Il est rare qu’un programme ait à révoquer un identifiant isolé ; le plus souvent, c’est toute une cohorte. Dans la liste Awards :
- Cochez les cases des identifiants que vous voulez retirer.
- Cliquez sur Revoke selected dans la barre d’actions groupées.
- Ajoutez un motif et décidez si vous prévenez les bénéficiaires, puis confirmez.
La révocation en masse s’exécute comme une tâche d’arrière-plan durable : quelques centaines d’identifiants ne feront donc pas expirer l’onglet de votre navigateur. Les identifiants déjà révoqués sont ignorés au lieu de faire échouer le lot, et une tâche interrompue en cours de route peut être reprise. Le même mécanisme alimente l’émission en masse depuis un tableur, que nous détaillons dans comment émettre des Open Badges depuis un CSV.
Révoquer via l’API
Si votre système d’apprentissage ou votre plateforme RH décide qui n’est plus certifié, vous pouvez révoquer par programmation. Le point de terminaison est POST /awards/{awardId}/revoke, authentifié par une clé d’API (X-Api-Key: bws_<32-hex>) ou un jeton Bearer Cognito. L’identifiant d’attribution (award ID) se place dans le chemin ; reason et notify vont dans le corps JSON, tous deux facultatifs.
Avec 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>"}
En 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
Et en 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
Quelques détails pratiques à connaître :
- L’opération est idempotente. Révoquer un identifiant déjà révoqué renvoie la même réponse de succès et n’envoie pas de seconde notification. Vous pouvez donc l’appeler sans risque depuis une tâche qui effectue des nouvelles tentatives.
- Les motifs sont tronqués à 500 caractères.
notifyvaut false par défaut. Aucun e-mail n’est envoyé si vous ne le demandez pas.- La révocation en masse est disponible via le point de terminaison bulk avec
action: "revoke"et une liste d’identifiants d’attribution ; elle renvoie un identifiant de tâche que vous pouvez suivre. Tous les paramètres figurent dans la référence de l’API awards.
Vous n’avez besoin de l’API que lorsque la révocation est pilotée par un autre système. Pour une opération ponctuelle, le tableau de bord est plus rapide et comporte une étape de confirmation qui vous protège d’un identifiant mal saisi.
Ce que voient le bénéficiaire et le vérificateur
Après la révocation, voici ce qui change et à quelle vitesse.
Sur la page de vérification publique. La page https://badges.ninja/awards/<award-id> affiche l’identifiant comme révoqué, et le titre de la page pour le partage sur les réseaux sociaux est préfixé de « [Revoked] » afin qu’un lien partagé ne ressemble pas à un identifiant valide dans une carte d’aperçu.
Dans l’assertion Open Badges v2.0. Le JSON hébergé à https://api.badges.ninja/certify-badge/award/<award-id> porte désormais "revoked": true, ainsi que "revocationReason" si vous en avez donné un. Les assertions révoquées ne sont mises en cache que pendant environ 30 secondes, contre cinq minutes pour les assertions valides, de sorte que le changement parvient rapidement aux vérificateurs.
Dans l’identifiant Open Badges 3.0. La révocation fait aussi basculer le bit de l’identifiant dans une W3C Bitstring Status List, ce qui permet aux portefeuilles et vérificateurs d’identifiants vérifiables de la détecter. Cette liste est mise en cache brièvement ; comptez donc environ une minute de propagation. Si vous hésitez entre les deux versions, consultez Open Badges v2 vs v3.
Dans la copie du bénéficiaire. Rien ne change dans le fichier qu’il a téléchargé. L’image du badge sur son ordinateur paraît identique. Ce qui change, c’est le résultat de la vérification : quiconque clique sur le lien ou contrôle l’identifiant par programmation obtient la réponse « révoqué ». Si vous l’avez prévenu, il dispose aussi d’un e-mail qui explique pourquoi.
Sur LinkedIn. Un identifiant ajouté à un profil LinkedIn est un lien accompagné de métadonnées qui renvoie à votre page de vérification. LinkedIn ne surveille pas la révocation à votre place ; l’entrée peut donc persister sur le profil, mais quiconque suit le lien arrive sur la page révoquée. C’est une raison de plus d’envoyer la notification et de demander au bénéficiaire de retirer l’entrée.
Prévenir vos propres systèmes : les webhooks
La révocation est rarement la fin de l’histoire au sein de votre organisation. L’apprenant peut devoir perdre l’accès à une communauté, un dossier employeur peut devoir être mis à jour, ou une étiquette CRM retirée. Badges Ninja émet un événement webhook credential.revoked lorsqu’un identifiant est révoqué, avec l’URL de l’attribution et le motif :
{
"awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
"reason": "Issued in error"
}
Abonnez-vous-y et vos systèmes en aval restent synchronisés sans que personne ait à penser à les mettre à jour. Les détails de configuration se trouvent dans la documentation des webhooks, et nous présentons le modèle d’événements plus large dans configuration des webhooks pour les événements de badge.
Une politique de révocation simple à adopter dès aujourd’hui
Les outils sont la moitié facile. La moitié difficile consiste à décider à l’avance quand vous révoquerez et qui en a le droit. Une courte politique écrite évite des disputes par la suite. Un modèle qui fonctionne :
- Motifs de révocation. Listez-les : émis par erreur, obtenu par faute, exigence non remplie (par exemple, une adhésion échue) ou programme retiré.
- Qui décide. Désignez un rôle, pas une personne. Limitez le droit de révoquer à ce rôle.
- Notification. Indiquez que les bénéficiaires sont prévenus par e-mail, avec le motif, sauf si l’identifiant n’a jamais été remis.
- Recours. Donnez aux bénéficiaires un moyen de contester la décision et précisez le délai de réponse. Si un recours aboutit, réémettez un nouvel identifiant plutôt que d’essayer d’annuler la révocation : l’historique reste ainsi propre.
- Enregistrement. Conservez une note interne indiquant qui a révoqué quoi et pourquoi, distincte du motif public neutre.
Publiez la politique sur la même page que celle où vous décrivez l’identifiant, afin que les bénéficiaires connaissent les règles avant de s’inscrire.
Erreurs courantes à éviter
- Supprimer alors que vous vouliez révoquer. La suppression est définitive, irréversible, et fait disparaître la page publique. Réservez-la aux véritables erreurs sur des identifiants que personne n’a vus.
- Mettre des détails privés dans le motif. Il est public dans l’assertion.
- S’attendre à ce que les copies enregistrées changent. La révocation vit au point de vérification. Dites aux bénéficiaires de retirer l’identifiant de leurs profils et portfolios.
- Révoquer au lieu de faire expirer. Utilisez une date d’expiration pour les identifiants à durée limitée.
- Supposer un remboursement. Les identifiants révoqués restent comptabilisés dans le quota de votre forfait.
- Oublier les systèmes en aval. Branchez le webhook pour que les accès et les dossiers suivent le statut de l’identifiant.
Foire aux questions
Puis-je annuler une révocation ? Pas depuis l’interface. Si vous avez révoqué par erreur, émettez un nouvel identifiant au bénéficiaire. L’identifiant révoqué reste dans la piste d’audit.
Le bénéficiaire doit-il faire quelque chose ? Non. Si vous avez choisi de le prévenir, il reçoit un e-mail. Sinon, le changement se fait silencieusement sur la page de vérification.
La révocation fonctionne-t-elle pour des identifiants jamais envoyés ? Oui, même si pour un identifiant non envoyé comportant une simple erreur, vous préférerez peut-être le modifier avant l’envoi, ou le supprimer si personne ne l’a vu.
Y a-t-il une limite au nombre d’identifiants que je peux révoquer ? La révocation en masse s’exécute comme une tâche d’arrière-plan reprenable ; les gros lots sont donc traités en une seule opération plutôt qu’un par un.
Les employeurs verront-ils qu’un identifiant a été révoqué ? Quiconque le vérifie via son URL publique ou son assertion voit le statut révoqué et le motif, si vous en avez donné un.
Conclusion
Révoquer un Open Badge est une petite action aux conséquences réelles pour la confiance. Faites-le depuis le tableau de bord pour un identifiant isolé, utilisez la révocation en masse pour une cohorte, et recourez à l’API ou aux webhooks lorsqu’un autre système détient la décision. Gardez des motifs neutres, prévenez les personnes qui doivent l’être, et rappelez-vous que la révocation change ce que voient les vérificateurs, pas les fichiers déjà entre les mains des bénéficiaires.
Prêt à émettre votre premier identifiant vérifiable ? Commencez gratuitement sur badges.ninja — concepteur visuel, page de vérification publique, certificat PDF, sortie Open Badge v2.0. Aucune carte bancaire requise.
Comment cet article a été créé
Certains articles de ce blog sont rédigés avec l'aide d'un assistant IA, puis relus, vérifiés et édités par l'équipe Badges Ninja avant publication. Chaque exemple de code et chaque prix est vérifié sur le produit réel. Pour en savoir plus sur notre processus éditorial et d'IA, consultez notre page sur le processus éditorial .

À propos de l'auteur
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.
Plus de Nacho Coll
- Open Badges pour bootcamps de code : émettre des certifications vérifiables à l'échelle d'une promo19 nov. 2026 · 13min de lecture
- Configurer des webhooks pour les événements de badge : une intégration en temps réel avec votre backend16 nov. 2026 · 10min de lecture
- Expiration et renouvellement des Open Badges : gérer le cycle de vie des certifications à durée limitée12 nov. 2026 · 12min de lecture


