فحص WebCrypto

مدقق توقيع JWT وفحص الصلاحية

تحقق من التوقيع التشفيري لرموز JWT لخوارزميات HS256 و RS256 و PS256 و ES256 مع فحص مطالبات exp و nbf محلياً بالكامل داخل متصفحك باستخدام واجهة WebCrypto. لا يتم إرسال الرموز أو المفاتيح إلى أي خادم خارجي نهائياً.

كيف تعمل الأداة تقنياً

يتكون رمز JWS المدمج من ثلاثة أجزاء مرمزة بصيغة Base64URL وتفصل بينها نقاط: الترويسة (Header)، والحمولة (Payload)، والتوقيع الرقمي المحسوب على البايتات النصية للجزأين الأول والثاني. وعلى عكس مجرد فك الترميز، يتحقق هذا المدقق رياضياً من صحة التوقيع داخل ذاكرة المتصفح عبر واجهة WebCrypto (crypto.subtle) دون إرسال أي مفاتيح أو رموز عبر الإنترنت.

بالنسبة لخوارزميات HMAC المتماثلة (HS256 و HS384 و HS512)، يقرأ الفاحص المفتاح السري بصيغة نص UTF-8 أو hex أو Base64 أو Base64URL وينبهك عند قصر المفتاح عن الحد الأدنى في RFC 7518 القسم 3.2. أما التواقيع غير المتماثلة فتستورد مفاتيح SPKI PEM أو JWK/JWKS العامة للتحقق من RSASSA-PKCS1-v1_5 و RSA-PSS وتواقيع ECDSA بصيغة r||s الخام، مع رفض alg: "none" تلقائياً وتوضيح قيود المتصفح مع EdDSA و ES256K.

شرح عملي خطوة بخطوة مع مثال حقيقي

اتبع هذه الخطوات الأربع للتحقق من سلامة التوقيع التشفيري وصلاحية التوقيت الزمني لأي رمز JWT محلياً.

1. ألصق رمز JWT الثلاثي الأجزاء

أدخل الرمز المكون من الترويسة والحمولة والتوقيع في الحقل المخصص، أو حمّل أحد أمثلة RFC 7515 الرسمية للتجربة الفورية.

2. حدّد الخوارزمية المتوقعة

استخدم الاكتشاف التلقائي للفحص السريع أو اختر خوارزمية محددة مثل RS256 أو ES256 لمحاكاة التثبيت الصارم في الخوادم.

3. أدخل المفتاح السري أو المفتاح العام

لرموز HMAC اختر ترميز المفتاح المطابق لنظامك، وللخوارزميات غير المتماثلة ألصق مفتاحاً عاماً بصيغة SPKI PEM أو JWK أو JWKS.

4. افحص حالة التوقيع وهامش التوقيت

اضبط ثواني سماحية انحراف الساعة عند الحاجة ثم راجع حالة التوقيع ومطالبات exp و nbf و iat بالتفصيل.

مثال عملي: متجه اختبار RFC 7515 الملحق A.1 (HS256)

الرمز والمفتاح السري k بصيغة Base64URL:Token: eyJ0eXAiOiJKV1QiLA0KICJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJqb2UiLA0KICJleHAiOjEzMDA4MTkzODAsDQogImh0dHA6Ly9leGFtcGxlLmNvbS9pc19yb290Ijp0cnVlfQ.dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk | Key: AyM1SysPpbyDfgZld3umj1qzKObwVMkoqQ-EstJQLr_T-1qS0gZH75aKtMN3Yj0iPS4hcgUuTwjAzZr1Z9CAow
النتيجة الفعلية:التوقيع صحيح (HS256، توقيع 32 بايت، مفتاح 512 بت) · exp=1300819380 (منتهي الصلاحية في 2011) · المطالبات iss="joe".

يظل التوقيع صحيحاً رياضياً حتى بعد انتهاء تاريخ الصلاحية، مما يميز فوراً بين خطأ المفاتيح وانتهاء مهلة الرمز.

الأخطاء الشائعة وتنبيهات الأمان

الوثوق بقيمة alg داخل الترويسة دون تثبيتها في الخادم

يمكن للمهاجم تغيير RS256 إلى HS256 والتوقيع باستخدام المفتاح العام المعلن إذا لم يفرض الخادم قائمة سماح صريحة للخوارزميات.

قبول الرموز غير الموقعة alg: "none"

تسمح بعض الإعدادات الضعيفة بقبول رموز بلا توقيع عندما تكون الخوارزمية none. يجب حظرها دائماً في كل الواجهات البرمجية.

اختيار مفاتيح HMAC أقصر من معيار RFC 7518

تتطلب HS256 مفتاحاً بطول 256 بت على الأقل، و HS384 بطول 384 بت، و HS512 بطول 512 بت لتفادي هجمات التخمين.

إدخال المفاتيح الخاصة أثناء التحقق من التوقيع

لا يحتاج التحقق غير المتماثل إلا إلى المفتاح العام SPKI PEM أو JWK العام؛ احتفظ بالمفتاح الخاص بعيداً عن المتصفحات تماماً.

مقارنة خوارزميات التوقيع القياسية لرموز JWT

الخوارزميةنوع المفتاحبنية التوقيعالاستخدام الموصى به
HS256 / HS384 / HS512مفتاح سري متماثل مشتركبصمة HMAC-SHA (32–64 بايت)خادم واحد أو خدمات داخلية موثوقة
RS256 / RS384 / RS512RSA غير متماثل (PKCS#1)توقيع بحجم معامل RSAالتوافق الواسع مع أنظمة OIDC و JWKS
PS256 / PS384 / PS512RSA-PSS غير متماثلتبطين احتمالي حديثالتطبيقات الحديثة عالية المتطلبات
ES256 / ES384 / ES512ECDSA إهليلجي (P-256..521)صيغة IEEE P1363 r||s خامرموز مضغوطة لتطبيقات الجوال والـ API

أمثلة برمجية (Node.js و Python و Java)

استخدم هذه الشيفرات البرمجية في خادمك للتحقق الصارم مع تثبيت الخوارزمية المتوقعة:

Node.js (TypeScript)
import { createHmac, timingSafeEqual } from 'node:crypto';

export function verifyHs256(token: string, secret: Buffer) {
  if (secret.length < 32) throw new Error('Key < 256 bits');
  const [hdr, pay, sig] = token.split('.');
  const { alg } = JSON.parse(Buffer.from(hdr, 'base64url').toString());
  if (alg !== 'HS256') throw new Error('Invalid alg');
  const expected = createHmac('sha256', secret).update(`${hdr}.${pay}`).digest();
  const actual = Buffer.from(sig, 'base64url');
  if (expected.length !== actual.length || !timingSafeEqual(expected, actual)) throw new Error('Bad signature');
  return JSON.parse(Buffer.from(pay, 'base64url').toString());
}
Python
import jwt

def verify_rs256(token: str, public_pem: str, aud: str) -> dict:
    return jwt.decode(
        token, public_pem, algorithms=["RS256"],
        audience=aud, leeway=30, options={"require": ["exp", "sub"]},
    )
Java
DecodedJWT jwt = JWT.require(Algorithm.ECDSA256(ecPublicKey, null))
    .withIssuer("https://auth.example.com")
    .acceptLeeway(15)
    .build()
    .verify(token);

الأسئلة الشائعة

ما الفرق بين فك تشفير JWT والتحقق من التوقيع؟

فك التشفير يحول Base64URL إلى نص JSON فقط ليقرأه أي شخص، بينما التحقق يفحص التوقيع رياضياً بالمفتاح الموثوق لإثبات عدم العبث بالبيانات.

لماذا يحذر المدقق عند ترك الخوارزمية على الوضع التلقائي؟

الوضع التلقائي مفيد للتجربة المحلية، لكن الخوادم يجب أن تثبت الخوارزمية المتوقعة مسبقاً لمنع هجمات خلط الخوارزميات.

لماذا لا يدعم هذا المدقق خوارزميتي EdDSA و ES256K؟

تعتمد الأداة بالكامل على واجهة WebCrypto القياسية دون مكتبات خارجية، ولا تدعم المتصفحات معيار ES256K أو جميع صيغ EdDSA بشكل موحد.

ماذا يعني نجاح التوقيع مع ظهور تنبيه انتهاء الصلاحية؟

يعني أن الرمز وُقّع فعلاً بمفتاحك السليم ولم يُعدَّل، لكن الوقت الحالي تجاوز قيمة exp المحددة مع هامش السماحية.

هل يمكن لصق مستند JWKS كامل بدلاً من مفتاح واحد؟

نعم، وإذا احتوت ترويسة الرمز على معرف kid مطابق فسيختار المدقق المفتاح الصحيح من مصفوفة keys تلقائياً.

هل تُرسَل الرموز أو المفاتيح إلى خادم خارجي؟

مطلقاً؛ تجري كافة حسابات التوقيع وفحص التواريخ في ذاكرة متصفحك فقط دون أي اتصال شبكي.

عن الكاتب

تطوّر Avada Labs أدوات مجانية للمطورين، من بينها هذا الموقع، بخبرة تمتد لست سنوات في تطوير الويب والأدوات البرمجية. المشاريع والشيفرة المصدرية متاحة على GitHub.

مدقق توقيع JWT – فحص HS256 و RS256 و ES256 محلياً