Open Badge를 취소하는 방법 (수령자가 가진 사본은 어떻게 될까요?)

Open Badges에서 취소가 어떻게 동작하는지, 수령자에게 무엇이 달라지는지, 그리고 「실수로 발급」, 「자격 만료」, 「정책 위반」을 각각 올바르게 처리하는 방법을 알려드려요.

Nacho Coll 작성자 업데이트됨 22 분 읽기
Open Badges에서 취소가 어떻게 동작하는지, 수령자에게 무엇이 달라지는지, 그리고 「실수로 발급」, 「자격 만료」, 「정책 위반」을 각각 올바르게 처리하는 방법을 알려드려요.

디지털 자격 증명을 발급하는 프로그램이라면 언젠가는 하나쯤 되돌려야 할 때가 와요. 인증서가 엉뚱한 사람에게 갔을 수도 있고, 최종 평가에서 부정행위를 한 학습자가 드러날 수도 있고, 파트너 계약이 끝나서 “Certified Partner”라고 적힌 배지가 더 이상 유효하지 않게 될 수도 있어요. 발급은 순탄한 경로이고, 자격 증명을 정말 믿을 수 있는지는 취소가 결정해요.

이 가이드는 Open Badges에서 취소가 어떻게 동작하는지, 취소 후에 수령자에게 무엇이 보이고 무엇이 안 보이는지, 그리고 https://badges.ninja에서 대시보드나 API로 자격 증명 하나 또는 수백 개를 취소하는 방법을 설명해요.

Open Badges에서 “취소”란

Open Badges v2.0 사양에서 발급된 모든 배지는 **어서션(assertion)**이에요. 공개 URL에 호스팅되는 작은 JSON-LD 문서로, “이 발급자가 이 날짜에 이 수령자에게 이 배지를 수여했다”는 내용을 담고 있어요. 취소는 이 호스팅된 문서를 바꾸는 것일 뿐이에요. 어서션에 "revoked": true가 붙고, 이유를 설명하는 "revocationReason" 문자열을 선택적으로 추가할 수 있어요.

이 설계는 많은 프로그램 운영자가 놀라는 중요한 결과를 낳아요.

  • 호스팅된 어서션이 진실의 원천이에요. 어서션 URL을 가져오거나 검증 페이지를 열어서 자격 증명을 검증하는 사람은 취소된 상태를 즉시 보게 돼요.
  • 사본은 회수되지 않아요. 수령자가 배지 이미지나 JSON을 다운로드했거나 포트폴리오에 고정해 두었더라도 그 파일은 바뀌지 않아요. 파일에는 호스팅된 어서션으로 돌아가는 링크가 들어 있어서 링크를 따라가는 검증자는 취소된 것을 알 수 있지만, 저장된 PNG를 슬쩍 보는 사람은 알 수 없어요.

따라서 취소는 삭제가 아니라 검증 엔드포인트에서 하는 선언이에요. 모든 복사본을 쫓아다니는 대신 원본 기록에 “VOID” 도장을 찍는 것이라고 생각하세요.

문서 자체를 더 자세히 보고 싶다면 각 필드를 차례로 설명하는 Open Badge JSON-LD 워크스루를 참고하세요.

취소, 재발급, 삭제: 알맞은 작업 고르기

무언가를 클릭하기 전에 세 가지 작업 중 상황에 맞는 것을 정하세요. 서로 대체할 수 없어요.

상황최선의 작업이유
잘못된 사람에게 발급했거나 오타가 있음삭제(전송 전이라면) 또는 취소 후 재발급삭제는 기록을 완전히 지우고, 취소는 감사 추적을 남김
학습자가 정책을 위반했거나 부정한 방법으로 자격을 얻음이유와 함께 취소취소된 상태로 검증 가능한 기록이 남아 분쟁 시 유리함
자격 증명이 단순히 종료일에 도달함아무것도 하지 않음. 발급할 때 만료일을 설정만료는 정상적인 수명 주기 이벤트이지 취소가 아님
프로그램 취소, 코호트 무효화일괄 취소하나의 작업, 하나의 이유를 모두에게 적용
세부 정보는 틀렸지만 자격 증명 자체는 유효함전송 전에 수정, 전송 후라면 취소 후 재발급수령자 경험을 깔끔하게 유지

두 가지 경험칙이에요.

  1. 실제로 발급한 것은 삭제보다 취소를 선택하세요. 삭제된 자격 증명의 공개 페이지는 not-found 오류를 반환해요. 취소된 자격 증명은 여전히 열리고 취소되었다고 분명히 표시되므로, 나중에 누가 무슨 일이 있었는지 물을 때 훨씬 좋은 증거가 돼요.
  2. 취소를 만료 대신 쓰지 마세요. 자격 증명이 2년만 유효하다면 발급할 때 만료일을 설정하세요. 조용히 만료되는 배지와 철회된 배지는 다르고, 검증 페이지는 어느 쪽인지 알려 줘야 해요.

대시보드에서 취소하기

몇 개 안 되는 자격 증명이라면 대시보드가 가장 빠르고 코드도 필요 없어요.

  1. 로그인한 뒤 사이드바에서 Awards를 열어요.
  2. 자격 증명을 찾아요. 목록에는 수령자, 배지 이름, 발급일, 만료일이 표시되고 수령자로 검색할 수 있어요.
  3. 행(또는 View)을 클릭해서 자격 증명 상세 모달을 열어요.
  4. Revoke를 클릭해요.
  5. 확인 대화상자에서 원하면 이유를 입력하고, Email the recipient that their credential was revoked를 선택할 수도 있어요.
  6. 확인해요.

Award detail modal

자격 증명은 목록에 그대로 남고 수령자 옆에 빨간 Revoked 칩이 표시돼서, 팀이 무엇이 철회되었는지 언제든 볼 수 있어요. 취소해도 플랜 할당량은 환불되지 않아요. 발급한 순간 이미 집계된 거예요.

이유 필드에 대해

이유는 선택 사항이지만 꼭 적으세요. 이유는 자격 증명과 함께 저장되고, 공개 Open Badges 어서션에 revocationReason으로 나타나며, 시스템이 받는 웹훅 페이로드에도 포함돼요. 어서션에서 공개되므로 외부 독자를 위해 쓰세요. “Issued in error”나 “Program cancelled”는 괜찮아요. “Jane이 14번 문제에서 부정행위를 함”은 안 돼요. 개인 정보는 자체 기록에 두고 공개 이유는 중립적으로 유지하세요.

수령자에게 이메일을 보내야 할까요?

대개는 보내는 게 좋아요. 자격 증명이 무효가 된 것을 고용주가 검증 링크를 클릭했을 때 비로소 알게 된 학습자가 여러분에게 불만을 갖는 건 당연해요. 알림이 옵트인인 이유는 테스트 어워드를 일괄 정리하는 것처럼 아무도 신경 쓸 필요가 없는 취소도 있기 때문이에요. 권장 기준은 이래요.

  • 이메일을 보낼 때: 취소가 아직 그 자격 증명을 내보이고 있을 수 있는 실제 사람에게 영향을 줄 때.
  • 이메일을 건너뛸 때: 내부 테스트 데이터를 정리하거나, 한 번도 전송되지 않은 자격 증명을 무효화할 때.

여러 자격 증명을 한 번에 취소하기

프로그램에서 자격 증명 하나만 따로 취소하는 경우는 드물고, 코호트 전체를 취소하는 경우가 더 많아요. Awards 목록에서는 이렇게 해요.

  1. 철회하려는 자격 증명의 체크박스를 선택해요.
  2. 일괄 작업 바에서 Revoke selected를 클릭해요.
  3. 이유를 추가하고 수령자에게 알릴지 정한 뒤 확인해요.

일괄 취소는 내구성 있는 백그라운드 작업으로 실행되므로 수백 개의 자격 증명도 브라우저 탭이 타임아웃되지 않아요. 이미 취소된 자격 증명은 배치를 실패시키지 않고 건너뛰며, 도중에 중단된 작업은 재개할 수 있어요. 같은 구조가 스프레드시트로 일괄 발급하는 기능에도 쓰이는데, 이는 CSV에서 Open Badges를 발급하는 방법에서 다뤄요.

API로 취소하기

학습 시스템이나 HR 플랫폼이 누가 더 이상 인증되지 않는지 결정한다면 프로그래밍 방식으로 취소할 수 있어요. 엔드포인트는 POST /awards/{awardId}/revoke이고, API 키(X-Api-Key: bws_<32-hex>) 또는 Cognito Bearer 토큰으로 인증해요. award ID는 경로에 넣고, 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

알아 두면 좋은 실용적인 세부 사항이에요.

  • 멱등성이 있어요. 이미 취소된 자격 증명을 다시 취소해도 같은 성공 응답이 반환되고 두 번째 알림은 보내지지 않아요. 재시도하는 작업에서 호출해도 안전해요.
  • 이유는 500자로 잘려요.
  • notify의 기본값은 false예요. 요청하지 않으면 이메일은 전송되지 않아요.
  • 일괄 취소는 action: "revoke"와 award ID 목록을 넣어 bulk 엔드포인트로 할 수 있고, 추적할 수 있는 작업 ID가 반환돼요. 전체 파라미터는 awards API 레퍼런스에 있어요.

API는 다른 시스템이 취소를 주도할 때만 필요해요. 일회성 작업이라면 대시보드가 더 빠르고, ID를 잘못 입력하는 실수를 막아 주는 확인 단계도 있어요.

수령자와 검증자에게 보이는 것

취소 후에 무엇이 얼마나 빨리 바뀌는지 알려드려요.

공개 검증 페이지. https://badges.ninja/awards/<award-id> 페이지에 자격 증명이 취소된 것으로 표시되고, 소셜 공유용 페이지 제목에는 “[Revoked]“가 앞에 붙어서 공유된 링크가 미리보기 카드에서 유효한 자격 증명처럼 보이지 않아요.

Open Badges v2.0 어서션. https://api.badges.ninja/certify-badge/award/<award-id>에 호스팅된 JSON에 "revoked": true가 붙고, 이유를 적었다면 "revocationReason"도 붙어요. 취소된 어서션은 약 30초만 캐시되고 유효한 어서션은 5분간 캐시되므로 변경 사항이 검증자에게 빠르게 전달돼요.

Open Badges 3.0 자격 증명. 취소하면 W3C Bitstring Status List에서 해당 자격 증명의 비트도 바뀌어요. 검증 가능한 자격 증명(verifiable credential) 지갑과 검증자는 이 방식으로 취소를 감지해요. 이 목록은 잠깐 캐시되므로 반영까지 약 1분 정도 걸린다고 보세요. 두 버전을 비교하고 있다면 Open Badges v2 vs v3를 참고하세요.

수령자 본인의 사본. 다운로드한 파일에는 아무 변화가 없어요. 노트북에 있는 배지 이미지는 똑같아 보여요. 바뀌는 것은 검증 결과예요. 링크를 클릭하거나 프로그래밍 방식으로 자격 증명을 확인하는 사람은 취소되었다는 답을 받아요. 알림을 보냈다면 수령자에게는 이유를 설명하는 이메일도 가요.

LinkedIn. LinkedIn 프로필에 추가된 자격 증명은 검증 페이지를 가리키는 링크와 메타데이터예요. LinkedIn은 여러분을 대신해 취소 여부를 확인하지 않으므로 프로필에 항목이 남아 있을 수 있지만, 링크를 따라가는 사람은 취소된 페이지에 도착해요. 알림을 보내고 수령자에게 항목을 삭제해 달라고 요청해야 하는 또 하나의 이유예요.

내부 시스템에 알리기: 웹훅

취소는 조직 내부에서 끝나는 경우가 드물어요. 학습자가 커뮤니티 접근 권한을 잃어야 할 수도 있고, 고용주 기록을 업데이트해야 할 수도 있고, CRM 태그를 제거해야 할 수도 있어요. Badges Ninja는 자격 증명이 취소되면 award URL과 이유를 담은 credential.revoked 웹훅 이벤트를 보내요.

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

이 이벤트를 구독하면 누가 업데이트를 기억하지 않아도 하위 시스템이 보조를 맞춰요. 설정 방법은 웹훅 문서에 있고, 더 넓은 이벤트 모델은 배지 이벤트용 웹훅 설정에서 다뤄요.

오늘 바로 도입할 수 있는 간단한 취소 정책

도구는 쉬운 절반이에요. 더 어려운 절반은 언제 취소할지, 누가 취소할 수 있는지를 미리 정하는 거예요. 짧게 문서화한 정책이 있으면 나중의 분쟁을 막을 수 있어요. 쓸 만한 템플릿은 이래요.

  1. 취소 사유. 나열하세요: 실수로 발급, 부정행위로 취득, 요건 미충족(예: 멤버십 만료), 프로그램 폐지.
  2. 결정 주체. 사람이 아니라 역할을 지정하세요. 취소 권한을 그 역할로 제한하세요.
  3. 통지. 자격 증명이 전달된 적이 없는 경우를 제외하고, 수령자에게 이유와 함께 이메일로 알린다고 명시하세요.
  4. 이의 제기. 수령자가 결정에 이의를 제기할 방법과 응답에 걸리는 기간을 알려 주세요. 이의가 받아들여지면 취소를 되돌리려 하지 말고 새 자격 증명을 재발급하세요. 그러면 이력이 깔끔하게 유지돼요.
  5. 기록. 누가 무엇을 왜 취소했는지를 중립적인 공개 이유와는 별도로 내부 메모로 남기세요.

정책은 자격 증명을 설명하는 페이지와 같은 곳에 게시해서, 취득자가 가입하기 전에 규칙을 알 수 있게 하세요.

피해야 할 흔한 실수

  • 취소하려다 삭제하기. 삭제는 영구적이라 되돌릴 수 없고 공개 페이지도 사라져요. 아무도 본 적 없는 자격 증명의 진짜 실수에만 사용하세요.
  • 이유에 비공개 정보 적기. 이유는 어서션에서 공개돼요.
  • 저장된 사본이 바뀌기를 기대하기. 취소는 검증 엔드포인트에 있어요. 수령자에게 프로필과 포트폴리오에서 자격 증명을 삭제하라고 안내하세요.
  • 만료 대신 취소하기. 기간이 정해진 자격 증명에는 만료일을 쓰세요.
  • 환불을 가정하기. 취소된 자격 증명도 플랜 할당량에 계속 집계돼요.
  • 하위 시스템을 잊기. 웹훅을 연결해서 접근 권한과 기록이 자격 증명 상태를 따라가게 하세요.

자주 묻는 질문

취소를 되돌릴 수 있나요? 인터페이스에서는 안 돼요. 실수로 취소했다면 수령자에게 새 자격 증명을 발급하세요. 취소된 자격 증명은 감사 추적의 일부로 남아요.

수령자가 해야 할 일이 있나요? 아니요. 알림을 선택했다면 이메일을 받고, 그렇지 않으면 검증 페이지에서 조용히 변경돼요.

전송된 적 없는 자격 증명도 취소할 수 있나요? 네, 다만 전송 전이고 단순한 실수라면 전송 전에 수정하거나, 아무도 본 적이 없다면 삭제하는 편이 나을 수 있어요.

취소할 수 있는 개수에 제한이 있나요? 일괄 취소는 재개할 수 있는 백그라운드 작업으로 실행되므로, 큰 배치도 하나씩이 아니라 한 번의 작업으로 처리돼요.

고용주에게도 자격 증명이 취소된 것이 보이나요? 공개 URL이나 어서션으로 검증하는 사람은 취소 상태와, 적었다면 그 이유를 보게 돼요.

마무리

Open Badge를 취소하는 일은 작은 동작이지만 신뢰에는 실질적인 영향을 줘요. 하나라면 대시보드에서, 코호트라면 일괄 취소로 하고, 다른 시스템이 결정권을 갖고 있다면 API나 웹훅을 활용하세요. 이유는 중립적으로 쓰고, 알아야 할 사람에게는 알리고, 취소가 바꾸는 것은 검증자에게 보이는 내용이지 수령자 손에 이미 있는 파일이 아니라는 점을 기억하세요.

첫 검증 가능한 자격 증명을 발급할 준비가 되셨나요? 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.

블로그로 돌아가기

관련 글