Open Badge 만료와 갱신: 기간 제한이 있는 자격 증명의 수명 주기 관리
CE 학점, 인증, 면허는 모두 만료돼요. Open Badge에 expirationDate를 설정하고 프로그래밍 방식으로 갱신해 보세요. 스키마와 워크플로를 소개해요.
평생 유효한 자격 증명도 있어요. 학위는 10년이 지났다고 해서 사실이 아니게 되지 않죠. 하지만 교육팀이 발급하는 자격 증명의 상당수는 정반대예요. 2년짜리 사이버 보안 인증, 매년 받는 지게차 안전 보수 교육, CPR 카드, 보고 주기 하나 동안만 유효한 평생교육 학점 같은 것들이에요. 이런 자격 증명은 “어떤 날짜 시점에 이 사람은 역량이 있었다”는 선언이고, 그 선언에는 유통기한이 있어요.
디지털 자격 증명이 절대 만료되지 않는다면, 고용주와 감사인에게 사실이 아닌 내용을 슬며시 전하고 있는 셈이에요. 이 글에서는 Open Badges에서 만료가 어떻게 동작하는지, 자격 증명이 만료되면 검증자에게 무엇이 보이는지, 그리고 원하지 않는 한 코드를 쓸 필요가 없는 실용적인 갱신 워크플로를 차근차근 살펴봐요.
시작하기 전에 이름에 대한 메모
많은 분이 “expirationDate”로 검색해요. Open Badges v2.0 사양에서 어서션(배지 클래스가 아니라 수여 그 자체)의 해당 필드는 expires라고 불러요. ISO 8601 날짜-시간 문자열이에요. https://badges.ninja에서 자격 증명을 발급할 때 보내는 API 필드도 expires예요. 개념은 같지만 대부분이 짐작하는 이름과 달라요. JSON-LD 문서를 읽거나 문서를 검색할 때 기억해 두세요.
알아 둘 점이 두 가지 있어요.
- 만료는 배지가 아니라 수여에 붙어요. 같은 배지(예를 들어 “Annual Safety Training”)라도 어떤 사람에게는 3월, 다른 사람에게는 9월 만료로 발급할 수 있어요. 유효 기간은 각자 교육을 마친 시점부터 세는 것이 맞으니까, 원하는 동작이에요.
- 선택 사항이에요. 생략하면 자격 증명은 만료되지 않아요.
발급할 때 만료일 설정하기
유효 기간을 설정하는 방법은 세 가지예요. 코드가 필요 없는 앞의 두 가지부터 시작하세요.
대시보드 양식. 자격 증명을 만들 때, 양식에는 수령인 이름과 이메일 옆에 선택 항목인 “Expires” 날짜 필드가 있어요. 날짜를 고르고 발급하면 끝이에요.

일괄 수여. 한 기수 전체에 발급한다면, 일괄 수여 페이지에서 수령인 CSV를 받아 배치 전체에 만료일 하나를 적용해요. 같은 주에 수료한 반은 같은 만료일을 갖게 돼요. 큰 배치는 일시 중지했다가 다시 시작할 수도 있어요. 파일 형식은 CSV로 Open Badges 발급하기 안내에서 다뤄요.
API. 자동화가 필요하다면, 예를 들어 시험에 합격하면 자격 증명을 발급하는 학습 관리 시스템 훅 같은 경우에, POST /awards 본문에 expires를 추가하세요. issuedOn과 같은 형식, 즉 에포크 밀리초나 ISO 날짜 문자열을 받아요.
// Issue a 2-year certification
const issuedOn = Date.now();
const twoYears = 2 * 365 * 24 * 60 * 60 * 1000;
const res = await fetch("https://api.badges.ninja/awards", {
method: "POST",
headers: { "X-Api-Key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
badgeId: "your-badge-id",
recipient: { name: "Jane Smith", email: "jane@example.com" },
issuedOn,
expires: issuedOn + twoYears,
}),
});
const { awardId } = await res.json(); // 200 OK
const verifyUrl = `https://badges.ninja/awards/${awardId}`;
같은 호출을 Python으로 쓰면 이래요.
import time, requests
issued = int(time.time() * 1000)
two_years = 2 * 365 * 24 * 60 * 60 * 1000
res = requests.post(
"https://api.badges.ninja/awards",
headers={"X-Api-Key": API_KEY},
json={
"badgeId": "your-badge-id",
"recipient": {"name": "Jane Smith", "email": "jane@example.com"},
"issuedOn": issued,
"expires": issued + two_years,
},
)
award_id = res.json()["awardId"] # 200 OK
수령인 이름은 5자 이상이어야 하고, issuedOn은 필수이며, 호출에 성공하면 { awardId }와 함께 HTTP 200을 반환해요. 검증 URL은 응답에 들어 있지 않아요. 위 예시처럼 ID로 직접 만들어야 해요. 전체 요청 규격은 awards API 레퍼런스에 있어요.
내부적으로 플랫폼은 보낸 값을 ISO 8601 문자열로 정규화해서, Open Badges 어서션에 expires로 저장해요.
검증자에게 보이는 것
가장 중요한 부분이에요. 아무도 확인하지 않는 만료일은 장식에 불과하니까요.
모든 수여에는 https://badges.ninja/awards/<awardId>에 공개 검증 페이지가 있고, 가입 없이 볼 수 있어요. 이 페이지는 불러올 때마다 만료일을 오늘 날짜와 비교해요.
- 만료일 이전: 페이지가 자격 증명을 유효한 것으로 표시하고, 날짜가 적힌 “valid until” 줄을 보여 줘요.
- 만료일 이후: 페이지가 날짜가 적힌 “Expired on” 안내로 바뀌어요. 자격 증명은 그대로 남아 있어서 이력은 유지되지만, 현재 유효한 것으로 착각할 일은 없어요.
- 자격 증명이 취소된 경우: 취소가 만료보다 우선해요. 취소된 자격 증명은 단순히 만료된 것이 아니라 취소된 것으로 표시돼요.
기계 검증자는 https://api.badges.ninja/certify-badge/award/<awardId>의 Open Badge v2.0 JSON-LD 문서에서 같은 정보를 얻어요. 어서션에 expires 필드가 들어 있어요. 표준을 읽을 수 있는 도구라면 어디서든 자체 정책을 적용할 수 있어요. 인사 시스템은 만료된 자격 증명을 아예 거부할 수 있고, 동문 디렉터리는 “과거 인증자”로 보여 줄 수도 있어요.
자격 증명은 날짜를 바깥으로도 전달해요. 수여 페이지의 “Add to LinkedIn” 버튼은 LinkedIn 인증 항목에 만료 월과 연도를 채워 넣어서, 그 사람의 프로필에도 여러분이 설정한 만료일이 그대로 반영돼요. 다운로드할 수 있는 PDF 인증서에도 발급일 옆에 “Expires” 날짜가 인쇄돼요.
분명히 해 둘 결과가 하나 있어요. 만료는 누군가 보는 순간에 평가되고, 여러분 쪽에서 도는 작업이 처리하지 않아요. 자격 증명이 만료되는 날에 여러분이 할 일은 없어요. 무언가가 “꺼지는” 것이 아니라, 검증 페이지가 날짜에 대해 사실을 알려 줄 뿐이에요.
곧 만료될 항목 파악하기
갱신을 관리하는 프로그램에는 갱신이 다가오는 사람의 목록이 필요해요. 대시보드의 수여 페이지에는 각 자격 증명의 날짜를 보여 주는 Expires 열이 있고, 자격 증명을 열면 Active, Expires on(날짜), Expired on(날짜) 중 하나를 알리는 배너가 보여요.

갱신 캠페인에는 관심 있는 행을 선택해서 Export CSV를 쓰는 게 가장 쉬워요. 내보낸 파일에는 “Valid To” 열이 들어 있어요. 스프레드시트에서 열어 그 열로 정렬하면, 약 1분 만에 다음 분기의 갱신 파이프라인이 완성돼요.
한 가지 한계는 솔직하게 말씀드릴게요. 현재 플랫폼은 수령인에게 “자격 증명이 곧 만료돼요”라는 자동 이메일을 알아서 보내지 않아요. 알림은 여러분의 프로세스에서 한 단계로 처리하세요. 흔한 방식은 매달 1일에 캘린더 일정을 잡는 거예요. CSV를 내보내고, 앞으로 60~90일 안의 날짜로 걸러서, 평소 쓰는 이메일 도구로 해당자에게 갱신 안내를 보내요. 자격 증명이 수백 건인 대부분의 프로그램에서는 한 달에 10분이면 되고, 알림 시스템을 만드는 것보다 훨씬 수월해요.
자동화하고 싶다면, 수여 목록 엔드포인트(GET /awards)가 50건씩 페이지로 자격 증명을 반환하고, 각 레코드에 만료일이 포함돼요. 목록을 훑으면서 60일 안에 만료되는 사람에게 이메일을 보내는 예약 스크립트는 작은 프로젝트예요. 다만 먼저 스프레드시트를 써 보고, 수작업이 정말 힘들어질 때 자동화하세요.
갱신 패턴
누군가 갱신하면 자격 증명은 어떻게 되어야 할까요? 합리적인 패턴은 세 가지이고, 어느 쪽이 맞는지는 인증 프로그램을 어떻게 정의했는지에 달려 있어요.
패턴 1: 새 수여 발급하기(권장)
가장 깔끔한 방식이에요. 수료자가 보수 교육이나 재인증 시험을 마치면, 같은 배지로 새 발급일과 새 만료일을 가진 새 수여를 발급해요. 그러면 같은 배지의 자격 증명을 두 개 갖게 돼요. 만료로 표시되는 이전 것과, 유효로 표시되는 새것이에요.
이 방식이 보통 맞는 이유는 이래요.
- 각 자격 증명이 정직한 이력을 기록해요. 이 날짜에 발급되었고, 저 날짜까지 유효했다는 식으로요.
- 이전 공개 URL은 계속 동작하고 계속 “expired”라고 알려 줘요. 정확한 표시예요. 북마크해 둔 사람이 오해할 일이 없어요.
- 새 수여에는 고유한 검증 URL, PDF 인증서, Add to LinkedIn 항목이 생겨요. 이전 LinkedIn 항목을 바꿔도 되고, 인증이 끊기지 않았음을 보여 주려고 둘 다 두어도 돼요.
- 리포트에서는 배지별로 수령인당 수여 건수를 세기만 하면 갱신 건수를 셀 수 있어요.
이전 것과 새것의 연결을 남기려면 배지 기준이나 자체 기록에 적어 두세요. 재인증 배지에 “Annual Safety Training 갱신, 보수 교육 이수 후 유효”라고 쓸 수 있어요. 자체 시스템에서 확실한 연결이 필요하다면, 새 수여를 발급할 때 이전 awardId와 새 awardId를 학습 관리 또는 인사 데이터베이스에 함께 저장하세요.
패턴 2: 만료일을 그 자리에서 수정하기(발송 전에만)
플랫폼은 자격 증명을 그 자리에서 수정하는 기능을 지원하지만, 아직 이메일이 발송되지 않았고 취소되지 않은 동안에만 가능해요. 그 기간에는 수여의 URL을 바꾸지 않고 수령인 이름, 이메일, 발급일, 만료일을 고칠 수 있어요. 설정할 때 만료일을 잘못 입력한 경우 같은 실수를 바로잡기 위한 기능이고, 이미 누군가 가진 자격 증명을 연장하기 위한 기능이 아니에요.
자격 증명이 수령인에게 이메일로 발송되면 잠겨요. 그 뒤에 바꿔야 한다면, 지원되는 방법은 취소하고 새로 발급하는 거예요. 그게 세 번째 패턴으로 이어져요.
패턴 3: 취소 후 재발급
자격 증명을 더 이상 유효한 것으로 봐서는 안 될 때 써요. 예를 들어 그 사람이 기간 도중에 면허를 잃었거나, 잘못된 배지로 발급했을 때예요. 취소는 만료보다 강한 신호를 보내기 때문에, 일반적인 갱신 경로가 아니에요. 단순히 기간이 끝난 것이 아니라 그 자격 증명을 신뢰해서는 안 되었다는 뜻이니까요. 각각 언제 적절한지는 Open Badge 취소 단계별 안내에서 다뤄요.
좋은 기준이 하나 있어요. 만료는 기간이 끝났다는 뜻이고, 취소는 뭔가 잘못되었다는 뜻이에요. 만료되었다는 이유만으로 자격 증명을 취소하지 마세요. 그냥 만료되게 두고 기록을 남기세요.
유효 기간 정하기
만료일은 정책 결정이고, 잘못 정하면 실제로 골치 아픈 일이 생겨요. 잘 운영되는 프로그램들에서 본 조언을 소개해요.
| Credential type | Typical validity | Notes |
|---|---|---|
| 사이버 보안 또는 IT 인증 | 2~3년 | 도구와 위협이 빠르게 바뀌어요 |
| 연간 안전 교육 | 12개월 | 규제 요건과 연결되는 경우가 많아요 |
| 응급처치와 CPR | 2년 | 관행이 아니라 규제 기관의 규칙을 따르세요 |
| 평생교육 학점 | 보고 주기 종료 시점 | 갱신을 한데 묶을 수 있도록 주기에 맞추세요 |
| 과정 수료 | 만료 없음 | 수료는 사실이에요. expires는 비워 두세요 |
실용적인 팁이 두 가지 있어요. 첫째, 가능하면 만료일을 달력의 리듬에 맞추세요. 한 기수 전원이 같은 날 만료되면, 갱신이 쉰 번의 작업이 아니라 한 번의 캠페인이 돼요. 둘째, 사실상 수료 기록인 자격 증명에는 만료일을 두지 마세요. “2025 컨퍼런스에 참석했다”는 배지는 내년이 되었다고 덜 사실이 되지 않고, 거기에 만료일을 붙이면 혼란만 생겨요.
실제 사례: 2년짜리 보안 인증
직원 400명인 회사에서 보안 인식 인증을 운영하는 교육팀을 예로 정리해 볼게요.
- 배지를 한 번만 설계해요. 비주얼 디자이너에서 이름을 붙이고, 기준(80퍼센트 이상 점수로 시험 합격)을 정하고, 수령인이 무엇에 등록하는지 알 수 있도록 설명에 유효 기간을 적어요.
- 만료일을 두고 발급해요. 시험 회차마다 합격자 목록을 일괄 수여로 업로드하고, 만료일을 2년 뒤로 설정해요. 각자 검증 링크, PDF 인증서, Add to LinkedIn 버튼이 담긴 이메일을 받아요.
- 매달 확인해요. 매월 1일에 수여 목록을 내보내고 “Valid To”로 정렬해서, 앞으로 90일 안에 만료되는 모든 사람을 뽑아요.
- 갱신을 안내해요. 평소 쓰는 이메일 도구로 그분들에게 재인증 시험 링크를 보내요.
- 갱신을 발급해요. 합격하면 같은 배지로 새 2년 만료일의 새 수여를 발급해요. 이전 것은 저절로 만료로 표시되니까 아무것도 하지 않아요.
- 감사에는 링크로 답해요. 컴플라이언스 팀이 어떤 사람이 현재 인증 상태인지 물으면 검증 URL을 보내요. 직접 확인하지 않아도 현재 상태가 나와요.
맞춤 소프트웨어도, cron 작업도, 마이그레이션도 없어요. 그게 핵심이에요. 수명 주기 관리는 대부분 합리적인 날짜를 고르고 매달의 습관을 들이는 일이에요.
흔한 실수
- 모든 것에 만료일을 두기. 의미가 정말로 흐려지는 자격 증명에만 쓰세요. 그렇지 않으면 이득 없는 갱신 작업만 늘어요.
- 만료와 취소를 혼동하기. 만료된 자격 증명을 취소하면 지속적인 인증의 이력이 사라지고, 그 사람이 한 번도 유효한 적이 없는 것처럼 보여요.
- 시간대를 잊기. 고른 날짜는 하나의 시점이 돼요. 규정에 “3월 말까지 유효”라고 되어 있다면, 정책을 어떻게 읽느냐에 따라 만료일을 3월 마지막 날이나 4월 1일로 설정하고, 일관되게 유지하세요.
- 재발급 대신 수정할 계획 세우기. 수정은 자격 증명이 이메일로 발송되기 전에만 가능해요. 갱신은 처음부터 새 수여로 계획하세요.
- 알림 프로세스가 없기. 만료 알림이 자동이 아니라서, 습관은 여러분이 만들어야 해요. 매달의 내보내기를 누군가의 캘린더에 넣어 두세요.
다음으로 읽을 글
여러분의 자격 증명을 다른 시스템이 확인한다면, expires를 담은 문서가 어떻게 구성되는지 알아 두면 좋아요. Open Badge JSON-LD 예제 살펴보기에서 어서션의 모든 필드를 하나씩 짚어 봐요. 이 모든 것을 위해 자격 증명마다 플랫폼에 계속 비용을 낼지 고민 중이라면, Credly 대안 비교에서 비용을 정리해 두었어요.
첫 검증 가능한 자격 증명을 발급할 준비가 되셨나요? badges.ninja에서 무료로 시작하기 — 비주얼 디자이너, 공개 검증 페이지, PDF 인증서, Open Badge v2.0 출력. 신용카드는 필요 없어요.
이 글이 만들어진 과정
이 블로그의 일부 게시물은 AI 어시스턴트의 도움으로 초안이 작성된 후, 게시 전에 Badges Ninja 팀이 검토, 사실 확인, 편집합니다. 모든 코드 샘플과 가격은 실제 제품과 대조해 검증됩니다. 저희의 편집 및 AI 프로세스에 대해 더 알아보려면 저희 편집 프로세스 페이지를 확인해 보세요 .

작성자 소개
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.


