Что такое SD-JWT?

SD-JWT (Selective Disclosure for JSON Web Tokens) — это подписанный токен, в котором часть утверждений скрыта. Издатель подписывает только хеши этих утверждений с солью, так называемые дайджесты. Затем владелец решает, какие утверждения раскрыть, и отправляет вместе с токеном их раскрытия. Проверяющая сторона видит утверждения, выбранные владельцем, может убедиться, что каждое из них соответствует хешу, подписанному издателем, и ничего не узнаёт об остальных.

SD-JWT VC строит на его основе проверяемые учётные данные: тип vct указывает, что это за учётные данные, а ключ cnf привязывает их к устройству владельца. Это один из двух форматов учётных данных европейских кошельков цифровой идентификации, которые каждая страна ЕС должна предложить своим гражданам до декабря 2026 года; его также использует OpenID for Verifiable Credentials.

Как выглядит SD-JWT

SD-JWT — это строка из частей, разделённых тильдами (~):

  • JWT, подписанный издателем, — header.payload.signature.
  • По одному раскрытию на каждое раскрытое утверждение; каждое раскрытие — это JSON-массив в кодировке Base64url из случайной соли, имени утверждения и его значения. В раскрытиях элементов массива имя не указывается.
  • Необязательный JWT привязки ключа в конце, который владелец подписывает, чтобы показать, что презентация принадлежит ему и предназначена для этой проверяющей стороны. Если его нет, строка заканчивается тильдой.

Как пользоваться

Вставьте SD-JWT. Переносы строк и пробелы игнорируются, поэтому подойдёт и разбитый на строки токен, скопированный из журнала.

Чтобы проверить подпись издателя, введите открытый ключ издателя в виде JWK, набора JWK (используется ключ с kid токена), открытого ключа PEM или сертификата X.509. Подойдёт и вставленный закрытый JWK — используется только его открытая часть. Если поле ключа пустое, используется сертификат из x5c в заголовке токена, если он там есть.

Что вы увидите

  • Проверки подписи, раскрытий, привязки ключа, срока действия и алгоритма хеширования.
  • Заголовок JWT издателя с алгоритмом, типом (dc+sd-jwt для SD-JWT VC) и идентификатором ключа.
  • Подписанная полезная нагрузка с хешами (_sd) скрытых утверждений и заполнителями {"...": digest} для скрытых элементов массива.
  • Утверждения с раскрытиями — полезная нагрузка, в которой каждое раскрытие подставлено на своё место, так, как её прочитала бы проверяющая сторона.
  • Раскрытия — таблица, где для каждого раскрытия указаны утверждение, значение, место в утверждениях и хеш.
  • JWT привязки ключа — его заголовок и полезная нагрузка с аудиторией (aud), nonce и sd_hash.

Что означают проверки

  • Подпись: JWT издателя подписан введённым вами ключом. Если инструмент использует сертификат из заголовка, проверка показывает, что токен соответствует собственному сертификату. Принадлежит ли этот сертификат доверенному издателю, например указанному в доверенных списках ЕС, эта проверка не устанавливает.
  • Раскрытия: хеш каждого раскрытия встречается в подписанном токене ровно один раз. У изменённого раскрытия другой хеш, поэтому оно больше не совпадает, а раскрытие, отправленное дважды, помечается.
  • Привязка ключа: sd_hash в JWT привязки ключа — это хеш именно этой презентации (SD-JWT до последней тильды), и подписан JWT ключом из cnf учётных данных. Удаление или добавление раскрытия нарушает хеш.
  • Срок действия: время истечения (exp) и начала действия (nbf) токена сравнивается с часами вашего устройства.
  • Алгоритм хеширования: для хешей используется алгоритм из _sd_alg, а если токен его не указывает — SHA-256. Браузеры умеют вычислять SHA-256, SHA-384 и SHA-512.

Конфиденциальность

Декодирование и все проверки выполняются в вашем браузере, поэтому токен и ключи никуда не отправляются. Настоящие учётные данные содержат персональные данные, поэтому, когда делитесь снимками экрана, используйте тестовые учётные данные.