Open Badge の有効期限と更新:期限付きクレデンシャルのライフサイクル管理

継続教育単位、認定資格、ライセンスにはいずれ期限が来ます。Open Badge に expirationDate を設定し、プログラムから更新する方法を、スキーマとワークフローで解説します。

Nacho Coll 著者: 更新日 23 分で読了
継続教育単位、認定資格、ライセンスにはいずれ期限が来ます。Open Badge に expirationDate を設定し、プログラムから更新する方法を、スキーマとワークフローで解説します。

一生有効なクレデンシャルもあります。学位は、10 年たったからといって事実でなくなるわけではありません。しかし、研修チームが発行するクレデンシャルの多くは正反対です。2 年有効のサイバーセキュリティ認定、年 1 回のフォークリフト安全講習、CPR カード、1 つの報告サイクルだけ有効な継続教育単位などです。これらのクレデンシャルは「ある日付の時点でその人は能力を備えていた」という声明であり、その声明には賞味期限があります。

デジタルクレデンシャルがいつまでも失効しないなら、雇用主や監査人に、実際とは違うことをそっと伝えていることになります。この記事では、Open Badges で有効期限がどう機能するのか、クレデンシャルが失効したとき検証者に何が見えるのか、そしてコードを書かなくても(書きたければ書けます)運用できる実用的な更新ワークフローを紹介します。

始める前に、名前についての注意

多くの人が「expirationDate」で検索します。Open Badges v2.0 仕様では、アサーション(バッジクラスではなく、授与そのもの)のフィールド名は expires です。ISO 8601 の日時文字列で表します。https://badges.ninja でクレデンシャルを発行するときに送る API フィールドも expires です。考え方は同じでも、多くの人が想像する名前とは違うので、JSON-LD ドキュメントを読むときやドキュメントを検索するときは覚えておいてください。

知っておきたい点が 2 つあります。

  • 有効期限はバッジではなく授与に付きます。同じバッジ(たとえば「年次安全研修」)でも、ある人には 3 月、別の人には 9 月の期限で発行できます。有効期間は各自が研修を修了した時点から数えるので、これが望ましい形です。
  • 設定は任意です。省略すれば、クレデンシャルは失効しません。

発行時に有効期限を設定する

有効期間を設定する方法は 3 つあります。最初の 2 つはコード不要なので、まずそちらから始めましょう。

ダッシュボードのフォーム。 クレデンシャルを作成するフォームには、受取人の名前とメールの隣に、任意の「Expires」日付フィールドがあります。日付を選んで発行するだけで完了です。

New Award form

一括授与。 コホート全体に発行する場合、一括授与ページで受取人の CSV を読み込み、バッチ全体に 1 つの有効期限を適用できます。同じ週に修了したクラスなら、全員が同じ失効日になります。大きなバッチは一時停止・再開もできます。ファイル形式は 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 は必須です。呼び出しに成功すると、HTTP 200 と { awardId } が返ります。検証 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」の日付が印刷されます。

はっきり言っておくべき点が 1 つあります。有効期限は、誰かが見た瞬間に評価されるもので、あなたの側で動くジョブが処理するわけではありません。クレデンシャルが失効する日に、あなたがすることは何もありません。何かが「オフになる」わけでもなく、検証ページが日付について事実を伝えるだけです。

失効が近いものを把握する

更新を管理するプログラムには、更新が近い人の一覧が必要です。ダッシュボードの授与ページには、各クレデンシャルの日付を示す Expires 列があり、クレデンシャルを開くと、Active、Expires on(日付)、Expired on(日付)のいずれかのバナーが表示されます。

Awards list

更新キャンペーンでは、対象の行を選んで Export CSV を使うのが最も簡単です。エクスポートには「Valid To」列が含まれます。スプレッドシートで開き、その列で並べ替えれば、1 分ほどで次の四半期の更新パイプラインができあがります。

正直にお伝えしておくと、プラットフォームは現時点で、「クレデンシャルの期限が近づいています」という自動メールを受取人に送る機能を持っていません。リマインドは、あなた自身のプロセスの一工程として扱ってください。よくあるパターンは、毎月 1 日にカレンダーの予定を入れておき、CSV をエクスポートして今後 60〜90 日以内の日付で絞り込み、普段使っているメールツールで該当者に更新手順を送る、というものです。クレデンシャルが数百件程度のたいていのプログラムなら、月 10 分で済み、通知システムを作るよりはるかに手間がかかりません。

自動化したい場合は、授与一覧のエンドポイント(GET /awards)が、50 件ずつのページでクレデンシャルを返し、各レコードに有効期限が含まれます。一覧をたどって 60 日以内に失効する人にメールを送るスケジュール済みスクリプトは、小さなプロジェクトで済みます。ただ、まずはスプレッドシートを試し、手作業が本当につらくなってから自動化してください。

更新のパターン

誰かが更新したとき、クレデンシャルをどう扱うべきでしょうか。妥当なパターンは 3 つあり、どれが適切かは認定プログラムの定義しだいです。

パターン 1:新しい授与を発行する(推奨)

最もすっきりした方法です。受講者が更新講習や再認定試験を終えたら、同じバッジから、新しい発行日と新しい有効期限で新しい授与を発行します。すると本人は、同じバッジのクレデンシャルを 2 つ持つことになります。期限切れと表示される古いものと、有効と表示される新しいものです。

これが通常は正しい理由は次のとおりです。

  • 各クレデンシャルが、いつ発行され、いつまで有効だったかという正確な履歴を記録します。
  • 古い公開 URL は引き続き動作し、「expired」と表示し続けます。これは正確です。ブックマークした人が誤解することはありません。
  • 新しい授与には、専用の検証 URL、PDF 証明書、Add to LinkedIn のエントリが付きます。本人は古い LinkedIn のエントリを置き換えることも、継続的な認定を示すために両方残すこともできます。
  • レポートでは、バッジごとの受取人あたりの授与数を数えるだけで、更新数を集計できます。

古いものと新しいもののつながりを保つには、バッジの条件や自社の記録に書いておきます。再認定バッジには「年次安全研修の更新。更新講習の修了後に有効」と書くことができます。自社のシステムで確実に紐づけたい場合は、新しい授与を発行するときに、古い awardId と新しい awardId を学習管理システムや人事データベースにまとめて保存してください。

パターン 2:有効期限をその場で編集する(送信前のみ)

プラットフォームはクレデンシャルのその場での編集に対応していますが、まだメール送信されておらず、取り消されてもいない間に限られます。その間であれば、授与の URL を変えずに、受取人の名前、メール、発行日、有効期限を修正できます。これは、設定時に有効期限を入力し間違えた場合などの誤りを直すためのもので、すでに受取人が持っているクレデンシャルを延長するためのものではありません。

クレデンシャルが受取人にメール送信されると、ロックされます。その後に変更が必要になったら、サポートされている方法は、取り消して新しいものを発行することです。これが 3 つ目のパターンにつながります。

パターン 3:取り消して再発行する

クレデンシャルをもはや有効とみなすべきでない場合に使います。たとえば、本人が期間の途中でライセンスを失った場合や、間違ったバッジで発行してしまった場合です。取り消しは失効より強いシグナルを送るため、通常の更新の手段ではありません。単に期間が終わったのではなく、そのクレデンシャルは信頼されるべきではなかった、という意味になるからです。どちらがどんな場合に適切かは、Open Badge を取り消す手順で解説しています。

覚えやすい目安があります。失効は期間が終わったこと、取り消しは何かが間違っていたことを意味します。 失効しただけのクレデンシャルを取り消してはいけません。そのまま期限切れにして、記録を残しましょう。

有効期間を決める

有効期限は方針の判断であり、間違えると実際に面倒が起きます。うまく運用しているプログラムから得たヒントを紹介します。

Credential typeTypical validityNotes
サイバーセキュリティまたは IT 認定2〜3 年ツールや脅威の変化が速い
年次安全研修12 か月規制要件に紐づくことが多い
応急処置と CPR2 年慣例ではなく、規制当局のルールに従う
継続教育単位報告サイクルの終わり更新をまとめられるよう、サイクルに合わせる
コース修了期限なし修了は事実。expires は付けない

実践的なヒントが 2 つあります。1 つ目は、できるだけカレンダー上のリズムに有効期限を揃えることです。コホート全員が同じ日に失効すれば、更新は 50 回の作業ではなく 1 回のキャンペーンで済みます。2 つ目は、実際には修了の記録にあたるクレデンシャルに、有効期限を付けないことです。「2025 年のカンファレンスに参加した」というバッジは、来年になっても事実でなくなるわけではなく、有効期限を付けても混乱を招くだけです。

実例:2 年有効のセキュリティ認定

400 人の従業員がいる会社で、セキュリティ意識認定を運営する研修チームを例に、ここまでをまとめます。

  1. バッジを一度だけ設計します。 ビジュアルデザイナーで名前を付け、条件(80 パーセント以上のスコアで試験に合格)を設定し、受取人が何に申し込むのか分かるよう、説明に有効期間を書きます。
  2. 有効期限付きで発行します。 試験のセッションごとに、合格者リストを一括授与でアップロードし、有効期限を 2 年後に設定します。各自に、検証リンク、PDF 証明書、Add to LinkedIn ボタンの付いたメールが届きます。
  3. 毎月確認します。 毎月 1 日に授与一覧をエクスポートし、「Valid To」で並べ替えて、今後 90 日以内に失効する全員を抽出します。
  4. 更新に招待します。 普段使っているメールツールで、該当者に再認定試験のリンクを送ります。
  5. 更新を発行します。 合格したら、同じバッジから新しい 2 年の有効期限で新しい授与を発行します。古いものは自動的に期限切れと表示されるので、何もしません。
  6. 監査にはリンクで答えます。 コンプライアンス部門から、ある人が現在認定を受けているか尋ねられたら、検証 URL を送ります。何も確認しなくても、現在の状態が表示されます。

専用ソフトウェアも、cron ジョブも、移行作業もありません。それがポイントです。ライフサイクル管理は、ほとんどの場合、妥当な日付を選ぶことと、毎月の習慣を持つことに尽きます。

よくある間違い

  • すべてに有効期限を付ける。 意味が本当に薄れていくクレデンシャルに限りましょう。そうしないと、メリットのない更新作業が増えるだけです。
  • 失効と取り消しを混同する。 失効したクレデンシャルを取り消すと、継続的な認定の履歴が消え、その人が一度も有効でなかったように見えてしまいます。
  • タイムゾーンを忘れる。 選んだ日付は、ある時点を表します。規則に「3 月末まで有効」とある場合は、方針の読み方に応じて、有効期限を 3 月の最終日か 4 月 1 日に設定し、一貫させてください。
  • 再発行ではなく編集するつもりでいる。 編集できるのは、クレデンシャルがメール送信される前だけです。更新は最初から新しい授与として計画しましょう。
  • リマインドの仕組みがない。 期限切れの通知は自動化されていないので、習慣はあなたが作る必要があります。毎月のエクスポートを、誰かのカレンダーに入れましょう。

次に読むもの

クレデンシャルが他のシステムに確認される場合は、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.

ブログに戻る

関連記事