Open Badge को रद्द (revoke) कैसे करें और प्राप्तकर्ता की कॉपी का क्या होता है

Open Badges में revocation कैसे काम करता है, प्राप्तकर्ता के लिए क्या बदलता है, और «गलती से जारी हुआ», «credential की अवधि समाप्त» और «नीति का उल्लंघन» जैसे मामलों को सही तरीके से कैसे संभालें।

Nacho Coll लेखक: अपडेट किया गया 12 मिनट पढ़ें
Open Badges में revocation कैसे काम करता है, प्राप्तकर्ता के लिए क्या बदलता है, और «गलती से जारी हुआ», «credential की अवधि समाप्त» और «नीति का उल्लंघन» जैसे मामलों को सही तरीके से कैसे संभालें।

डिजिटल credential जारी करने वाले हर प्रोग्राम को देर-सवेर कोई credential वापस लेना ही पड़ता है। कोई सर्टिफिकेट गलत व्यक्ति को चला गया। किसी learner ने फाइनल असेसमेंट में नकल की। किसी पार्टनर का अनुबंध खत्म हो गया और “Certified Partner” वाले badge अब मान्य नहीं रहने चाहिए। जारी करना आसान हिस्सा है; revocation वह हिस्सा है जो तय करता है कि आपके credential पर सचमुच भरोसा किया जा सकता है या नहीं।

यह गाइड बताती है कि Open Badges में revocation कैसे काम करता है, उसके बाद प्राप्तकर्ता क्या देखता है और क्या नहीं, और https://badges.ninja पर डैशबोर्ड या API से एक या कुछ सौ credential कैसे रद्द करें।

Open Badges में “revoke” का क्या मतलब है

Open Badges v2.0 स्पेसिफिकेशन में हर जारी किया गया badge एक assertion होता है: एक सार्वजनिक URL पर होस्ट किया गया छोटा JSON-LD दस्तावेज़, जो कहता है “इस जारीकर्ता ने यह badge इस प्राप्तकर्ता को इस तारीख को दिया।” Revocation बस उसी होस्ट किए गए दस्तावेज़ में बदलाव है। Assertion में "revoked": true जुड़ जाता है, और चाहें तो कारण बताने वाली "revocationReason" स्ट्रिंग भी।

इस डिज़ाइन का एक अहम नतीजा है जो कई प्रोग्राम मालिकों को चौंकाता है:

  • होस्ट किया गया assertion ही सत्य का स्रोत है। जो भी assertion URL खोलकर या सत्यापन पेज पर जाकर credential को verify करता है, उसे revoked स्थिति तुरंत दिखती है।
  • कॉपियाँ वापस नहीं बुलाई जातीं। अगर प्राप्तकर्ता ने badge की इमेज या JSON डाउनलोड कर ली, या उसे पोर्टफोलियो में पिन कर दिया, तो वह फ़ाइल नहीं बदलती। उसमें आपके होस्ट किए गए assertion का लिंक रहता है, इसलिए लिंक खोलने वाले verifier को revoked दिखेगा, लेकिन सेव की हुई PNG को देखने वाले को नहीं।

इसलिए revocation सत्यापन endpoint पर की गई एक घोषणा है, मिटाना नहीं। इसे ऐसे समझिए कि आप हर फोटोकॉपी के पीछे भागने के बजाय मूल रिकॉर्ड पर “VOID” की मुहर लगा रहे हैं।

अगर आप दस्तावेज़ को करीब से देखना चाहते हैं, तो हमारा Open Badge JSON-LD walkthrough हर फ़ील्ड को समझाता है।

Revoke, दोबारा जारी करना या delete: सही कार्रवाई चुनें

कुछ भी क्लिक करने से पहले तय करें कि इन तीन कार्रवाइयों में से कौन-सी स्थिति के अनुकूल है। ये आपस में बदली नहीं जा सकतीं।

स्थितिसबसे अच्छी कार्रवाईकारण
Credential गलत व्यक्ति को या टाइपो के साथ जारी हुआDelete (अगर भेजा नहीं गया) या Revoke, फिर दोबारा जारी करेंDelete रिकॉर्ड को पूरी तरह हटा देता है; revoke ऑडिट ट्रेल बनाए रखता है
Learner ने नीति तोड़ी या credential अनुचित तरीके से मिलाकारण के साथ Revokeरिकॉर्ड revoked के रूप में सत्यापन योग्य रहता है, जो विवाद में आप चाहते हैं
Credential बस अपनी समाप्ति तिथि तक पहुँचाकुछ न करें; जारी करते समय expiry सेट करेंExpiry सामान्य जीवनचक्र की घटना है, revocation नहीं
प्रोग्राम रद्द हुआ, cohort अमान्य घोषित हुआBulk revokeएक job, एक कारण, सब पर लागू
विवरण गलत थे लेकिन credential बाकी तौर पर मान्य हैभेजने से पहले edit करें, या भेजने के बाद revoke करके दोबारा जारी करेंप्राप्तकर्ता का अनुभव साफ-सुथरा रहता है

दो मोटे नियम:

  1. किसी भी असली credential के लिए delete की जगह revoke चुनें। Delete किए गए credential का सार्वजनिक पेज not-found त्रुटि देता है। Revoked credential का पेज फिर भी खुलता है और साफ़ बताता है कि वह revoked है, जो बाद में कोई पूछे कि क्या हुआ था तो कहीं बेहतर प्रमाण है।
  2. Revocation को कभी expiry का विकल्प न बनाएँ। अगर credential केवल दो साल के लिए मान्य है, तो जारी करते समय expiry तारीख सेट करें। चुपचाप समाप्त हुआ badge और वापस लिया गया badge अलग चीज़ें हैं, और आपके सत्यापन पेज को बताना चाहिए कि कौन-सा है।

डैशबोर्ड से revoke करना

कुछ ही credential के लिए डैशबोर्ड सबसे तेज़ रास्ता है और इसमें कोड की ज़रूरत नहीं।

  1. साइन इन करें और साइडबार से Awards खोलें।
  2. Credential ढूँढें। सूची में प्राप्तकर्ता, badge का नाम, जारी करने की तारीख और expiry दिखती है, और आप प्राप्तकर्ता के नाम से खोज सकते हैं।
  3. Credential detail modal खोलने के लिए पंक्ति (या View) पर क्लिक करें।
  4. Revoke पर क्लिक करें।
  5. पुष्टि डायलॉग में चाहें तो कारण (reason) लिखें, और चाहें तो Email the recipient that their credential was revoked पर टिक करें।
  6. पुष्टि करें।

Award detail modal

Credential आपकी सूची में बना रहता है और प्राप्तकर्ता के पास लाल Revoked चिप दिखती है, ताकि आप और आपकी टीम हमेशा देख सकें कि क्या वापस लिया गया। Revoke करने से credential आपके प्लान कोटे में वापस नहीं जुड़ता। आपने उसे जारी किया था, वह गिना जा चुका है।

कारण फ़ील्ड के बारे में एक बात

कारण वैकल्पिक है, पर इसे भरें। यह credential के साथ सहेजा जाता है, सार्वजनिक Open Badges assertion में revocationReason के रूप में दिखता है, और आपके सिस्टम को मिलने वाले webhook payload में शामिल होता है। चूँकि यह assertion पर सार्वजनिक है, इसे ऐसे लिखें जैसे बाहरी पाठक के लिए लिख रहे हों। “Issued in error” या “Program cancelled” ठीक है। “Jane ने प्रश्न 14 में नकल की” ठीक नहीं है। निजी ब्योरा अपने रिकॉर्ड में रखें और सार्वजनिक कारण तटस्थ रखें।

क्या प्राप्तकर्ता को ईमेल करना चाहिए?

आमतौर पर हाँ। जिस learner को अपने credential के निष्क्रिय होने का पता तब चले जब कोई नियोक्ता सत्यापन लिंक खोले, उसे आपसे नाराज़ होने का पूरा हक़ है। सूचना opt-in इसीलिए है कि कुछ revocation (जैसे टेस्ट awards की थोक सफ़ाई) में किसी को परेशान करने की ज़रूरत नहीं होती। हमारी सलाह:

  • ईमेल करें जब revocation किसी असली व्यक्ति को प्रभावित करता हो जो शायद अब भी वह credential दिखा रहा हो।
  • ईमेल छोड़ दें जब आप आंतरिक टेस्ट डेटा साफ़ कर रहे हों या ऐसे credential अमान्य कर रहे हों जो कभी भेजे ही नहीं गए।

एक साथ कई credential revoke करना

प्रोग्राम को शायद ही कभी अकेला credential revoke करना पड़ता है; अक्सर पूरा cohort होता है। Awards सूची में:

  1. जिन credential को वापस लेना है उनके चेकबॉक्स पर टिक करें।
  2. बल्क-एक्शन बार में Revoke selected पर क्लिक करें।
  3. कारण जोड़ें और तय करें कि प्राप्तकर्ताओं को सूचित करना है या नहीं, फिर पुष्टि करें।

Bulk revocation एक durable बैकग्राउंड job के रूप में चलता है, इसलिए कुछ सौ credential से आपका ब्राउज़र टैब timeout नहीं होगा। जो credential पहले से revoked हैं उन्हें batch फेल करने के बजाय छोड़ दिया जाता है, और बीच में रुकी job फिर से शुरू की जा सकती है। यही व्यवस्था स्प्रेडशीट से bulk जारी करने को भी चलाती है, जिसे हमने CSV से Open Badges कैसे जारी करें में बताया है।

API से revoke करना

अगर आपका learning सिस्टम या HR प्लेटफ़ॉर्म तय करता है कि कौन अब certified नहीं है, तो आप प्रोग्राम के ज़रिए revoke कर सकते हैं। Endpoint है POST /awards/{awardId}/revoke, जो API key (X-Api-Key: bws_<32-hex>) या Cognito Bearer token से authenticate होता है। Award ID पाथ में जाता है; reason और notify JSON body में जाते हैं और दोनों वैकल्पिक हैं।

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 है। पहले से revoked credential को दोबारा revoke करने पर वही सफलता का response मिलता है और दूसरी सूचना नहीं भेजी जाती। इसलिए इसे retry करने वाली job से कॉल करना सुरक्षित है।
  • कारण 500 अक्षरों तक छोटा कर दिया जाता है।
  • notify का डिफ़ॉल्ट false है। जब तक आप न कहें, कोई ईमेल नहीं जाता।
  • Bulk revoke bulk endpoint से उपलब्ध है, जिसमें action: "revoke" और award ID की सूची दी जाती है; यह एक job ID लौटाता है जिसे आप ट्रैक कर सकते हैं। पूरे पैरामीटर awards API reference में हैं।

API की ज़रूरत तभी है जब revocation किसी दूसरे सिस्टम से चलता हो। एक-दो मामलों के लिए डैशबोर्ड तेज़ है और उसमें पुष्टि का चरण है जो गलत टाइप हुए ID से बचाता है।

प्राप्तकर्ता और verifier क्या देखते हैं

Revoke करने के बाद क्या बदलता है, और कितनी जल्दी।

सार्वजनिक सत्यापन पेज पर। https://badges.ninja/awards/<award-id> वाला पेज credential को revoked दिखाता है, और सोशल शेयरिंग के लिए पेज के शीर्षक के आगे “[Revoked]” जुड़ जाता है ताकि साझा किया गया लिंक प्रीव्यू कार्ड में चालू credential जैसा न दिखे।

Open Badges v2.0 assertion में। https://api.badges.ninja/certify-badge/award/<award-id> पर होस्ट किए गए JSON में अब "revoked": true होता है, और कारण दिया हो तो "revocationReason" भी। Revoked assertion केवल लगभग 30 सेकंड के लिए cache होते हैं, जबकि चालू assertion पाँच मिनट के लिए, इसलिए बदलाव verifier तक जल्दी पहुँचता है।

Open Badges 3.0 credential में। Revocation W3C Bitstring Status List में credential की बिट भी पलट देता है, जिससे verifiable-credential वॉलेट और verifier इसे पहचानते हैं। वह सूची थोड़ी देर के लिए cache होती है, इसलिए लगभग एक मिनट में प्रसार की उम्मीद रखें। अगर आप दोनों संस्करणों की तुलना कर रहे हैं, तो Open Badges v2 vs v3 देखें।

प्राप्तकर्ता की अपनी कॉपी में। उनकी डाउनलोड की हुई फ़ाइल में कुछ नहीं बदलता। उनके लैपटॉप पर badge की इमेज पहले जैसी ही दिखती है। जो बदलता है वह सत्यापन का नतीजा है: जो भी क्लिक करके या प्रोग्राम से credential जाँचता है, उसे revoked जवाब मिलता है। अगर आपने उन्हें सूचित किया था, तो उनके पास कारण बताने वाला ईमेल भी होता है।

LinkedIn पर। LinkedIn प्रोफ़ाइल में जोड़ा गया credential एक लिंक और मेटाडेटा है जो आपके सत्यापन पेज की ओर इशारा करता है। LinkedIn आपकी ओर से revocation की जाँच नहीं करता, इसलिए एंट्री प्रोफ़ाइल पर बनी रह सकती है, लेकिन लिंक खोलने वाला revoked पेज पर पहुँचता है। यह सूचना भेजने और प्राप्तकर्ता से एंट्री हटाने को कहने का एक और कारण है।

अपने सिस्टम को बताएँ: webhooks

आपके संगठन के भीतर revocation शायद ही कभी कहानी का अंत होता है। हो सकता है learner की किसी कम्युनिटी तक पहुँच खत्म करनी हो, नियोक्ता रिकॉर्ड अपडेट करना हो, या CRM टैग हटाना हो। जब कोई credential revoke होता है, तो Badges Ninja award URL और कारण के साथ credential.revoked webhook इवेंट भेजता है:

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

इसे subscribe कर लें, तो आपके downstream सिस्टम बिना किसी के अपडेट करना याद रखे तालमेल में रहते हैं। सेटअप का ब्योरा webhooks दस्तावेज़ीकरण में है, और व्यापक इवेंट मॉडल हमने badge इवेंट के लिए webhook सेटअप में समझाया है।

एक सरल revocation नीति जो आप आज अपना सकते हैं

टूल आसान आधा हिस्सा हैं। कठिन आधा यह तय करना है कि आप कब revoke करेंगे और कौन कर सकता है। एक छोटी लिखित नीति बाद की बहस से बचाती है। एक कारगर टेम्पलेट:

  1. Revocation के आधार। उन्हें सूचीबद्ध करें: गलती से जारी, कदाचार से प्राप्त, शर्त अब पूरी नहीं होती (जैसे सदस्यता समाप्त), या प्रोग्राम वापस लिया गया।
  2. कौन तय करता है। किसी व्यक्ति का नहीं, भूमिका का नाम लिखें। Revoke की अनुमति उसी भूमिका तक सीमित रखें।
  3. सूचना। स्पष्ट करें कि प्राप्तकर्ताओं को कारण के साथ ईमेल से बताया जाता है, जब तक credential कभी पहुँचाया ही न गया हो।
  4. अपील। प्राप्तकर्ताओं को निर्णय को चुनौती देने का तरीका दें और बताएँ कि आप कितने समय में जवाब देंगे। अगर अपील सफल हो, तो revocation पलटने की कोशिश करने के बजाय नया credential जारी करें, इससे इतिहास साफ़ रहता है।
  5. रिकॉर्ड। सार्वजनिक तटस्थ कारण से अलग, किसने क्या और क्यों revoke किया इसका आंतरिक नोट रखें।

नीति को उसी पेज पर प्रकाशित करें जहाँ आप credential का वर्णन करते हैं, ताकि पाने वाले साइन अप करने से पहले नियम जान लें।

बचने वाली आम गलतियाँ

  • Revoke करना था, पर delete कर दिया। Delete स्थायी है, पलटा नहीं जा सकता, और सार्वजनिक पेज गायब कर देता है। इसे केवल उन credential की असली गलतियों के लिए इस्तेमाल करें जिन्हें किसी ने देखा नहीं।
  • कारण में निजी ब्योरा लिखना। यह assertion पर सार्वजनिक है।
  • सेव की गई कॉपियों के बदलने की उम्मीद। Revocation सत्यापन endpoint पर रहता है। प्राप्तकर्ताओं से कहें कि credential को प्रोफ़ाइल और पोर्टफोलियो से हटा दें।
  • Expire करने की जगह revoke करना। समय-सीमित credential के लिए expiry तारीख का उपयोग करें।
  • रिफंड मान लेना। Revoked credential फिर भी आपके प्लान कोटे में गिने जाते हैं।
  • Downstream सिस्टम भूल जाना। Webhook जोड़ें ताकि पहुँच और रिकॉर्ड credential की स्थिति के साथ चलें।

अक्सर पूछे जाने वाले प्रश्न

क्या मैं revocation को पलट सकता हूँ? इंटरफ़ेस से नहीं। अगर आपने गलती से revoke कर दिया, तो प्राप्तकर्ता को नया credential जारी करें। Revoked वाला ऑडिट ट्रेल के हिस्से के रूप में बना रहता है।

क्या प्राप्तकर्ता को कुछ करना पड़ता है? नहीं। अगर आपने उन्हें सूचित करना चुना, तो उन्हें एक ईमेल मिलता है। वरना बदलाव सत्यापन पेज पर चुपचाप हो जाता है।

क्या revocation उन credential पर भी काम करता है जो कभी भेजे नहीं गए? हाँ, हालाँकि न भेजे गए ऐसे credential के लिए जिसमें साधारण गलती हो, आप भेजने से पहले उसे edit करना, या अगर किसी ने नहीं देखा तो delete करना पसंद कर सकते हैं।

क्या मैं कितने revoke कर सकता हूँ इसकी कोई सीमा है? Bulk revocation एक resumable बैकग्राउंड job के रूप में चलता है, इसलिए बड़े batch एक-एक करके नहीं बल्कि एक ही ऑपरेशन में संभाले जाते हैं।

क्या नियोक्ता देखेंगे कि credential revoke हुआ? जो भी उसे उसके सार्वजनिक URL या assertion से verify करता है, उसे revoked स्थिति दिखती है, और कारण भी, अगर आपने दिया हो।

निष्कर्ष

Open Badge को revoke करना एक छोटी कार्रवाई है, पर भरोसे पर इसका असर बड़ा है। एक credential हो तो डैशबोर्ड से करें, पूरे cohort के लिए bulk revoke इस्तेमाल करें, और जब फ़ैसला किसी दूसरे सिस्टम का हो तो API या webhooks अपनाएँ। कारण तटस्थ रखें, जिन्हें जानना ज़रूरी है उन्हें सूचित करें, और याद रखें कि revocation वह बदलता है जो verifier देखते हैं, उन फ़ाइलों को नहीं जो पहले से प्राप्तकर्ताओं के हाथ में हैं।

अपना पहला verifiable credential जारी करने के लिए तैयार हैं? badges.ninja पर मुफ़्त शुरू करें — विज़ुअल डिज़ाइनर, सार्वजनिक सत्यापन पेज, PDF सर्टिफिकेट, Open Badge v2.0 आउटपुट। क्रेडिट कार्ड की ज़रूरत नहीं।

ब्लॉग पर वापस

संबंधित लेख