Open Badge 的过期与续期:限时凭证的生命周期管理

继续教育学分、认证和执照都会过期。为 Open Badges 设置 expirationDate,并以编程方式续期。数据结构 + 工作流程。

Nacho Coll 作者 更新于 19 分钟阅读
继续教育学分、认证和执照都会过期。为 Open Badges 设置 expirationDate,并以编程方式续期。数据结构 + 工作流程。

有些凭证是终身有效的。学位不会因为过了十年就变得不真实。但培训团队颁发的凭证中,有相当一部分恰恰相反:两年有效的网络安全认证、每年一次的叉车安全复训、心肺复苏(CPR)证书、只在一个报告周期内有效的继续教育学分。这类凭证表明的是某人在某个日期具备相应能力,而这个声明是有保质期的。

如果你的数字凭证永不过期,你其实是在悄悄地向雇主和审计人员传递一个不真实的信息。本文将介绍 Open Badges 中过期是如何运作的、凭证失效时验证者会看到什么,以及一套实用的续期工作流程——除非你想写代码,否则完全不需要。

开始之前的一点命名说明

你会看到有人搜索 “expirationDate”。在 Open Badges v2.0 规范中,断言(assertion,即颁发本身,区别于徽章类别 badge class)上的字段叫做 expires。它是一个 ISO 8601 日期时间字符串。在 https://badges.ninja 颁发凭证时你发送的 API 字段也叫 expires。意思相同,只是名字和大多数人猜的不一样,所以在阅读 JSON-LD 文档或查阅文档时请记住这一点。

有两点值得了解:

  • 过期时间属于颁发记录,而不是徽章本身。同一枚徽章(比如“年度安全培训”)可以颁发给一个人并设置在 3 月过期,颁发给另一个人则在 9 月过期。这正是你想要的,因为有效期是从每个人完成培训的时间开始计算的。
  • 它是可选的。不设置,凭证就永不过期。

颁发时设置过期时间

设置有效期有三种方式。先从前两种开始,因为它们不需要写代码。

控制台表单。 创建凭证时,表单中接收者姓名和邮箱旁边有一个可选的 “Expires” 日期字段。选好日期,然后颁发即可。就这么简单。

New Award form

批量颁发。 如果你要向整个班级颁发,批量颁发页面接受包含接收者的 CSV 文件,并对整批应用同一个过期日期,因此同一周结业的班级会有相同的失效日期。大批量任务可以暂停和恢复。我们关于通过 CSV 颁发 Open Badges 的教程介绍了文件格式。

API。 对于自动化场景,例如学习管理系统在某人通过考试时触发钩子来颁发凭证,请在 POST /awards 的请求体中添加 expires。它接受与 issuedOn 相同的格式:epoch 毫秒数或 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

接收者姓名至少需要五个字符,issuedOn 是必填项,调用成功会返回 HTTP 200 以及 { awardId }。验证 URL 不在响应中;你需要像上面所示那样根据 id 自行拼接。完整的请求规范见颁发记录 API 参考。

在后台,平台会把你发送的内容规范化为 ISO 8601 字符串,并以 expires 的形式存储在 Open Badges 断言中。

验证者会看到什么

这是最重要的部分,因为没人检查的过期日期只是摆设。

每个颁发记录都有一个公开的验证页面 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 某个日期。

Awards list

对于续期活动,最简单的做法是选中你关心的行,然后使用 Export CSV。导出的文件包含一列 “Valid To”。在电子表格中打开它,按该列排序,大约一分钟就能得到下个季度的续期名单。

需要坦率地说明一个限制:平台目前不会自动向接收者发送“你的凭证即将过期”的邮件。请把提醒当作你自己流程中的一个步骤。常见做法是在每月 1 号设一个日历提醒:导出 CSV,筛选出未来 60 到 90 天内到期的日期,然后用你平时的邮件工具向这些人发送续期说明。对于拥有几百个凭证的大多数项目来说,这每月只需十分钟,比搭建通知系统省事得多。

如果你确实想自动化,颁发记录列表接口(GET /awards)每页返回 50 个凭证,每条记录都包含其过期时间。写一个定时脚本,遍历列表并给 60 天内到期的人发邮件,只是个小项目。不过请先试试电子表格,只有当手动步骤真正让你头疼时再去自动化。

续期模式

有人续期时,凭证应该怎么处理?有三种合理的模式,具体选哪种取决于你的认证项目是如何定义的。

模式 1:颁发新的凭证(推荐)

这是最清晰的做法。当事人完成复训或重新认证考试后,你基于同一枚徽章颁发一个新的颁发记录,带有新的颁发日期和新的过期日期。这样他们就持有两份使用同一枚徽章的凭证:旧的显示为已过期,新的显示为有效。

为什么这通常是正确的做法:

  • 每份凭证都如实记录历史:何时颁发,有效期至何时。
  • 旧的公开 URL 仍然有效,并继续显示“已过期”,这是准确的。收藏过它的人不会被误导。
  • 新的颁发记录有自己的验证 URL、PDF 证书和 Add to LinkedIn 条目。当事人可以替换旧的 LinkedIn 条目,也可以两者都保留以显示持续认证。
  • 你的报表只需统计每位接收者在某枚徽章下的颁发数量,就能统计续期次数。

要保留新旧之间的关联,可以把它写进徽章标准或你自己的记录里。重新认证徽章可以写明“年度安全培训的续期,完成复训后有效。”如果你需要在自己的系统中建立硬关联,请在颁发新凭证时,将新旧 awardId 一起存入你的学习管理系统或人力资源数据库。

模式 2:原地编辑过期时间(仅限发送之前)

平台支持原地编辑凭证,但仅限于尚未通过邮件发送且尚未被撤销的情况。在这个窗口内,你可以修改接收者姓名、邮箱、颁发日期或过期日期,而无需改变该颁发记录的 URL。这用于纠正错误,例如设置时输入了错误的过期日期,而不是用来延长某人已经持有的凭证。

凭证一旦通过邮件发送给接收者,就会被锁定。如果之后需要更改,受支持的做法是撤销它并颁发一个新的。这就引出了第三种模式。

模式 3:撤销并重新颁发

当凭证完全不应再被视为有效时使用,例如当事人在有效期内丢失了执照,或者你颁发时选错了徽章。这不是常规的续期途径,因为撤销传达的信号比过期更强烈:它表示这份凭证本不该被信任,而不仅仅是其期限已结束。我们关于撤销 Open Badge 的分步指南介绍了两者各自适用的场景。

一条很好的经验法则:过期意味着期限结束;撤销意味着出了问题。 不要仅仅因为凭证失效就撤销它。让它过期,并保留记录。

选择有效期

过期日期是一项政策决策,定错了会带来实实在在的麻烦。以下是我们见过运行良好的项目所采用的一些指导原则:

凭证类型典型有效期说明
网络安全或 IT 认证2 至 3 年工具和威胁变化很快
年度安全培训12 个月通常与监管要求挂钩
急救与心肺复苏2 年遵循监管机构的规定,而不是惯例
继续教育学分报告周期结束与周期对齐,使续期可以集中处理
课程结业无过期时间结业是一个事实;不要设置 expires

两个实用建议。第一,尽可能将过期日期与日历节奏对齐。如果一个班级的所有人都在同一天失效,续期就变成一次活动,而不是五十次。第二,不要给本质上只是完成记录的凭证设置过期时间。写着“参加了 2025 年大会”的徽章不会因为明年而变得不那么真实,给它设置过期日期只会造成困惑。

实战示例:两年有效的安全认证

下面以一个为 400 名员工的公司运营安全意识认证的培训团队为例,把以上内容串起来。

  1. 一次性设计好徽章,使用可视化设计器。为它命名,设定标准(考试得分 80% 或以上方可通过),并在描述中说明有效期,让接收者知道自己要承担什么。
  2. 带过期时间颁发。 每次考试结束后,通过批量颁发上传通过名单,并把过期时间设为两年后。每个人都会收到一封邮件,包含验证链接、PDF 证书和 Add to LinkedIn 按钮。
  3. 每月检查。 每月 1 号,导出颁发记录列表,按 “Valid To” 排序,挑出未来 90 天内到期的所有人。
  4. 邀请他们续期。 用你平时的邮件工具向这些人发送重新认证考试的链接。
  5. 颁发续期凭证。 有人通过后,基于同一枚徽章颁发新的颁发记录,设置新的两年过期时间。旧的会自动显示为已过期;无需对它做任何操作。
  6. 用一个链接回答审计人员。 当合规部门询问某人当前是否持证时,你只需发送验证 URL。它会显示当前状态,无需你查任何东西。

无需定制软件,无需 cron 任务,无需迁移。这正是重点:生命周期管理主要就是选择合理的日期,并养成每月检查的习惯。

常见错误

  • 给所有凭证都设置过期时间。 只对含义确实会随时间减弱的凭证使用。否则你只是制造了没有收益的续期工作。
  • 混淆过期与撤销。 撤销已失效的凭证会破坏持续认证的历史,让此人看起来从未有效过。
  • 忘记时区。 你选择的日期会变成一个时间点。如果法规规定“有效期至三月底”,请根据你的政策解读,将过期时间设为三月的最后一天或四月的第一天,并保持一致。
  • 打算编辑而不是重新颁发。 编辑仅在凭证通过邮件发送之前可用。从一开始就把续期规划为新的颁发记录。
  • 没有提醒流程。 由于过期通知不是自动发送的,这个习惯必须由你来养成。把每月导出放进某个人的日历里。

下一步

如果你的凭证将被其他系统检查,值得了解一下承载 expires 的文档结构:Open Badge JSON-LD 示例详解逐一讲解了断言的每个字段。而如果你正在权衡是否要继续为这一切按凭证向平台付费,我们的 Credly 替代方案对比列出了各项成本。

准备好颁发你的第一份可验证凭证了吗? 在 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.

返回博客

相关文章