Срок действия и продление Open Badges: управление жизненным циклом ограниченных по времени credentials

Баллы непрерывного образования, сертификации и лицензии истекают. Задавайте expirationDate в Open Badges и продлевайте их программно. Схема + рабочий процесс.

Nacho Coll Автор Обновлено 10 мин чтения
Баллы непрерывного образования, сертификации и лицензии истекают. Задавайте expirationDate в Open Badges и продлевайте их программно. Схема + рабочий процесс.

Одни credentials действуют всю жизнь. Диплом не перестаёт быть правдой оттого, что прошло десять лет. Но значительная часть credentials, которые выдают учебные отделы, — ровно наоборот: двухлетняя сертификация по кибербезопасности, ежегодный курс по технике безопасности для водителей погрузчиков, карточка по СЛР, балл непрерывного образования, действительный только в одном отчётном цикле. Такие credentials — это утверждение, что человек был компетентен на определённую дату, и у этого утверждения есть срок годности.

Если ваши цифровые credentials никогда не истекают, вы тихо сообщаете работодателям и аудиторам то, что неправда. В этой статье разберём, как срок действия работает в Open Badges, что видит верификатор, когда credential истёк, и практичный процесс продления, для которого не нужно писать код — если вы сами этого не захотите.

Одно замечание об именах перед началом

Люди ищут «expirationDate». В спецификации Open Badges v2.0 поле assertion (самой выдачи, в отличие от класса значка) называется expires. Это строка даты и времени в формате ISO 8601. Поле API, которое вы отправляете при выдаче credential на https://badges.ninja, тоже называется expires. Та же идея, но имя не такое, как большинство предполагает, — держите это в голове, когда читаете документ JSON-LD или ищете в документации.

Два важных момента:

  • Срок действия относится к выдаче, а не к значку. Один и тот же значок (скажем, «Annual Safety Training») можно выдать одному человеку со сроком в марте, а другому — в сентябре. Именно это и нужно, ведь срок отсчитывается от момента, когда каждый прошёл обучение.
  • Он необязателен. Не укажете — credential не истечёт никогда.

Как задать срок при выдаче

Есть три способа задать срок действия. Начните с первых двух — они не требуют кода.

Форма в панели управления. При создании credential в форме рядом с именем и email получателя есть необязательное поле даты «Expires». Выберите дату и выдайте. Вот и вся работа.

New Award form

Массовая выдача. Если вы выдаёте целой группе, страница массовых выдач принимает CSV с получателями и применяет одну дату окончания ко всей партии, так что класс, закончивший обучение в одну неделю, получает одну дату истечения. Большую партию можно приостановить и возобновить. Формат файла описан в нашей инструкции по выдаче Open Badges из CSV.

API. Для автоматизации, например хука системы управления обучением, который выдаёт credential, когда человек сдаёт экзамен, добавьте expires в тело POST /awards. Поле принимает те же форматы, что и 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

Имя получателя должно содержать не менее пяти символов, issuedOn обязательно, а успешный вызов возвращает HTTP 200 с { awardId }. URL верификации в ответе нет; вы собираете его из идентификатора, как показано. Полный контракт запроса — в справочнике API awards.

За кулисами платформа приводит всё, что вы отправили, к строке ISO 8601 и сохраняет её в assertion Open Badges как expires.

Что видит верификатор

Это самое важное, ведь дата окончания, которую никто не проверяет, — просто украшение.

У каждой выдачи есть публичная страница верификации https://badges.ninja/awards/<awardId>, для просмотра которой регистрация не нужна. При каждой загрузке страница сравнивает дату окончания с сегодняшней:

  • До даты окончания: страница показывает credential как действительный и выводит строку «действителен до» с датой.
  • После даты окончания: страница переключается на уведомление «Истёк» с датой. Credential остаётся на месте, история сохраняется, но принять его за действующий невозможно.
  • Если credential отозван: отзыв имеет приоритет над истечением. Отозванный credential отображается как отозванный, а не просто как истёкший.

Машинные верификаторы получают ту же информацию из документа Open Badge v2.0 JSON-LD по адресу https://api.badges.ninja/certify-badge/award/<awardId>, где в assertion есть поле expires. Любой инструмент, читающий стандарт, может применить собственную политику. HR-система может отклонить истёкший credential целиком, а каталог выпускников — показать его как «ранее сертифицирован».

Credential также передаёт дату дальше. Кнопка «Add to LinkedIn» на странице выдачи заполняет месяц и год окончания в записи о сертификации в LinkedIn, так что профиль человека отражает ту же дату, что задали вы. В загружаемом PDF-сертификате рядом с датой выдачи тоже печатается дата «Expires».

Следствие, которое стоит назвать прямо: истечение вычисляется в момент, когда кто-то смотрит, а не заданием, которое выполняется на вашей стороне. В день окончания срока вам ничего делать не нужно. Ничего не «отключается»; страница верификации просто говорит правду о дате.

Что скоро истечёт

Программам, отслеживающим продления, нужен список тех, кому скоро продлевать. На странице awards в панели управления есть столбец Expires с датой каждого credential, а при открытии credential показывается баннер: Active, Expires on a date или Expired on a date.

Awards list

Для кампании по продлению проще всего выбрать нужные строки и нажать Export CSV. В экспорт входит столбец «Valid To». Откройте его в таблице, отсортируйте по этому столбцу — и примерно за минуту у вас готов план продлений на следующий квартал.

Об одном ограничении скажем честно: платформа сейчас сама не отправляет получателям автоматические письма «срок вашего credential скоро истекает». Считайте напоминание шагом вашего собственного процесса. Типичный приём — запись в календаре на первое число каждого месяца: выгрузить CSV, отфильтровать даты в ближайшие 60–90 дней и отправить этим людям инструкции по продлению из вашего обычного почтового инструмента. Для большинства программ с несколькими сотнями credentials это десять минут в месяц, и работы гораздо меньше, чем при создании системы уведомлений.

Если всё же хотите автоматизировать, эндпоинт списка awards (GET /awards) возвращает ваши credentials страницами по 50, и каждая запись содержит срок окончания. Запланированный скрипт, который обходит список и пишет всем, у кого срок истекает в течение 60 дней, — небольшой проект. Но сначала попробуйте таблицу и автоматизируйте, только когда ручной шаг действительно мешает.

Схемы продления

Что должно произойти с credential, когда человек продлевает его? Есть три разумные схемы, и правильная зависит от того, как определена ваша программа сертификации.

Схема 1: выдать новую выдачу (рекомендуется)

Это самый чистый подход. Человек проходит курс повторения или экзамен на пересертификацию, а вы выдаёте новую выдачу того же значка с новой датой выдачи и новой датой окончания. Теперь у него два credentials с одним значком: старый, отображаемый как истёкший, и новый, отображаемый как действующий.

Почему это обычно правильно:

  • Каждый credential честно фиксирует историю: выдан в такую-то дату, действителен до такой-то.
  • Старый публичный URL продолжает работать и продолжает сообщать «истёк», что соответствует действительности. Никто, сохранивший его в закладках, не введён в заблуждение.
  • Новая выдача получает собственный URL верификации, PDF-сертификат и запись Add to LinkedIn. Человек может заменить старую запись в LinkedIn или оставить обе, показывая непрерывную сертификацию.
  • В отчётах продления считаются просто как число выдач одного значка на получателя.

Чтобы сохранить связь между старым и новым, укажите её в критериях значка или в собственных записях. Значок пересертификации может гласить: «Продление Annual Safety Training, действителен после прохождения курса повторения». Если нужна жёсткая связь в вашей системе, сохраняйте старый и новый awardId вместе в базе системы обучения или HR при выдаче нового.

Схема 2: изменить срок на месте (только до отправки)

Платформа позволяет редактировать credential на месте, но только пока он не отправлен по email и не отозван. В этом окне можно исправить имя получателя, email, дату выдачи или дату окончания, не меняя URL выдачи. Это для исправления ошибок, например неверно введённой при настройке даты окончания, а не для продления credential, который у человека уже есть.

После отправки credential получателю по email он блокируется. Если после этого его нужно изменить, поддерживаемый путь — отозвать его и выдать новый. Это подводит нас к третьей схеме.

Схема 3: отозвать и выдать заново

Используйте её, когда credential вообще не должен считаться действительным, например человек потерял лицензию посреди срока или вы выдали его не с тем значком. Это не обычный путь продления, потому что отзыв сигнализирует сильнее, чем истечение: он говорит, что credential не следовало доверять, а не просто что его срок закончился. Наша пошаговая инструкция по отзыву Open Badge объясняет, когда уместно что.

Хорошее правило: истечение означает, что срок закончился; отзыв означает, что что-то было не так. Не отзывайте credentials только потому, что они истекли. Дайте им истечь и сохраните запись.

Как выбрать срок действия

Сроки окончания — это решения политики, и ошибки в них создают реальные проблемы. Несколько советов из программ, которые работают хорошо:

Тип credentialТипичный срокПримечания
Сертификация по кибербезопасности или IT2–3 годаИнструменты и угрозы быстро меняются
Ежегодное обучение технике безопасности12 месяцевЧасто привязано к нормативному требованию
Первая помощь и СЛР2 годаСледуйте правилу вашего регулятора, а не обычаю
Балл непрерывного образованияКонец отчётного циклаСовместите с циклом, чтобы продления шли пакетом
Завершение курсаБез срокаЗавершение — это факт; не указывайте expires

Два практических совета. Во-первых, по возможности привязывайте даты окончания к календарному ритму. Если вся группа истекает в один день, продление превращается в одну кампанию вместо пятидесяти. Во-вторых, не ставьте срок на credentials, которые на деле являются записями о завершении. Значок «участвовал в конференции 2025 года» не становится менее правдивым в следующем году, а дата окончания на нём лишь вносит путаницу.

Разбор примера: двухлетняя сертификация по безопасности

Соберём всё вместе для учебной команды, которая проводит сертификацию по информационной безопасности в компании на 400 сотрудников.

  1. Один раз разработайте значок в визуальном дизайнере. Назовите его, задайте критерии (сдать экзамен с результатом не менее 80 процентов) и опишите срок действия в описании, чтобы получатели знали, на что подписываются.
  2. Выдавайте со сроком. После каждой экзаменационной сессии загружайте список сдавших через массовые выдачи со сроком окончания через два года. Каждый получает письмо со ссылкой на верификацию, PDF-сертификатом и кнопкой Add to LinkedIn.
  3. Проверяйте ежемесячно. Первого числа выгружайте список awards, сортируйте по «Valid To» и отбирайте всех, у кого срок истекает в ближайшие 90 дней.
  4. Приглашайте продлить. Отправляйте этим людям ссылку на экзамен по пересертификации из вашего обычного почтового инструмента.
  5. Выдайте продление. Когда человек сдаёт, выдайте новую выдачу того же значка с новым сроком в два года. Старая сама отобразится как истёкшая; ничего с ней делать не нужно.
  6. Отвечайте аудиторам ссылкой. Когда комплаенс спрашивает, сертифицирован ли человек сейчас, вы отправляете URL верификации. Он показывает актуальный статус, и вам ничего не нужно проверять.

Никакого самописного ПО, cron-заданий, миграций. В этом и суть: управление жизненным циклом — это в основном выбор разумных дат и ежемесячная привычка.

Типичные ошибки

  • Срок на всём подряд. Оставьте его для credentials, смысл которых действительно устаревает. Иначе вы создаёте работу по продлению без пользы.
  • Путаница между истечением и отзывом. Отзыв истёкших credentials уничтожает историю непрерывной сертификации и создаёт впечатление, что человек никогда не был действителен.
  • Забытый часовой пояс. Выбранная дата становится моментом времени. Если норма гласит «действительно до конца марта», установите срок на последний день марта или первый день апреля — в зависимости от трактовки вашей политики — и будьте последовательны.
  • Расчёт на правку вместо повторной выдачи. Редактирование доступно только до отправки credential по email. Планируйте продления как новые выдачи с самого начала.
  • Нет процесса напоминаний. Поскольку уведомления об истечении не автоматизированы, привычка должна быть вашей. Поставьте ежемесячную выгрузку в чей-нибудь календарь.

Что почитать дальше

Если ваши credentials будут проверять другие системы, стоит узнать, как устроен документ, несущий expires: разбор примера Open Badge JSON-LD проходит по каждому полю assertion. А если вы решаете, продолжать ли платить платформе за каждый credential, сравнение альтернатив Credly показывает расходы.

Готовы выдать свой первый верифицируемый credential? Начните бесплатно на 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.

Назад в блог

Похожие статьи