مدقق توقيع 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)
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 / RS512 | RSA غير متماثل (PKCS#1) | توقيع بحجم معامل RSA | التوافق الواسع مع أنظمة OIDC و JWKS |
| PS256 / PS384 / PS512 | RSA-PSS غير متماثل | تبطين احتمالي حديث | التطبيقات الحديثة عالية المتطلبات |
| ES256 / ES384 / ES512 | ECDSA إهليلجي (P-256..521) | صيغة IEEE P1363 r||s خام | رموز مضغوطة لتطبيقات الجوال والـ API |
أمثلة برمجية (Node.js و Python و Java)
استخدم هذه الشيفرات البرمجية في خادمك للتحقق الصارم مع تثبيت الخوارزمية المتوقعة:
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());
}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"]},
)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.