ما 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 تتضمن قيمة salt عشوائية واسم المطالبة وقيمتها. أما إفصاحات عناصر المصفوفات فلا تتضمن الاسم.
  • 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 حتى آخر علامة تلدة)، والمفتاح الموجود في cnf ضمن بيانات الاعتماد هو الذي وقّعه. وحذف إفصاح أو إضافته يُفسد قيمة التجزئة.
  • فترة الصلاحية: وقتا انتهاء صلاحية الرمز المميز (exp) وبدايتها (nbf) مقارنةً بساعة جهازك.
  • خوارزمية التجزئة: تستخدم قيم التجزئة الخوارزمية المحددة في _sd_alg، أو SHA-256 عندما لا يحدد الرمز المميز أي خوارزمية. ويمكن للمتصفحات حساب SHA-256 وSHA-384 وSHA-512.

الخصوصية

يجري فك الترميز وجميع عمليات التحقق في متصفحك، لذا لا يُرسل الرمز المميز ولا المفاتيح إلى أي مكان. تحتوي بيانات الاعتماد الحقيقية على بيانات شخصية، لذا استخدم بيانات اعتماد تجريبية عند مشاركة لقطات الشاشة.