فك ترميز JWT
فك ترميز JSON Web Token والتحقق من توقيعه في متصفحك
يعمل في متصفحك
يُفك في متصفحك. لا يُرسل الرمز إلى أي مكان.
ما هو JWT؟
رمز JSON Web Token (JWT، RFC 7519) سلسلة مضغوطة آمنة للاستخدام في الروابط، من ثلاثة أجزاء تفصلها نقاط: ترويسة تبيّن طريقة التوقيع، وحمولة فيها مطالبات مثل معرّف المستخدم ووقت الانتهاء، وتوقيع. الترويسة والحمولة مرمّزتان بـ base64url فقط وليستا مشفّرتين، لذا يستطيع أي شخص يملك الرمز قراءتهما. يثبت التوقيع أن الرمز أنشأه من يملك السر أو المفتاح الخاص وأنه لم يُعدَّل. تفك الأداة الأجزاء وتحوّل exp وnbf وiat إلى تواريخ في منطقتك الزمنية، ويمكنها التحقق من التوقيع عبر Web Crypto في المتصفح.
حالات الاستخدام
- تصحيح تسجيل الدخول: معرفة المستخدم والأدوار والصلاحيات في رمز الوصول
- معرفة سبب رد واجهة API بالخطأ 401: هل انتهت صلاحية الرمز
- التأكد من أن الرمز موقّع بالسر أو المفتاح العام المتوقع
- فهم بنية رموز OAuth 2.0 ورموز ID في OpenID Connect
متى تستخدمها؟
الصق رمزًا من ترويسة Authorization أو ملف تعريف ارتباط أو التخزين المحلي، وتُحذف كلمة Bearer في البداية تلقائيًا. تظهر الترويسة والحمولة بصيغة JSON مع أزرار نسخ، وتظهر مطالبات الوقت كتواريخ مع المدة المتبقية أو المنقضية. للتحقق من التوقيع، الصق السر المشترك لـ HS256 وHS384 وHS512، أو المفتاح العام بصيغة PEM أو JWK لـ RS وPS وES وEdDSA. فك الرمز لا يثبت أنه أصلي: التوقيع الصحيح وحده يثبت ذلك.
أمثلة
رمز HS256 موقّع بسر
الإدخال
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkdldEl0IiwiaWF0IjoxNzAwMDAwMDAwLCJleHAiOjQxMDI0NDQ4MDB9.tam6-Oztg5zTqDX0sgLPaD76kIhxh_Xv75b6izxHgPA
المخرجات
- الترويسة
- {"alg":"HS256","typ":"JWT"}
- الحمولة
- {"sub":"1234567890","name":"GetIt","iat":1700000000,"exp":4102444800}
رمز وصول RS256 من مزوّد هوية
الإدخال
eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImsxIn0.eyJpc3MiOiJodHRwczovL2F1dGguZXhhbXBsZS5jb20iLCJhdWQiOiJhcGkiLCJzdWIiOiI0MiIsImlhdCI6MTcwMDAwMDAwMCwiZXhwIjoxNzAwMDAzNjAwfQ.c2lnbmF0dXJl
المخرجات
- الترويسة
- {"alg":"RS256","typ":"JWT","kid":"k1"}
- الحمولة
- {"iss":"https://auth.example.com","aud":"api","sub":"42","iat":1700000000,"exp":1700003600}
رمز غير موقّع (alg none)
الإدخال
eyJhbGciOiJub25lIn0.eyJzdWIiOiJ0ZXN0Iiwicm9sZSI6ImFkbWluIn0.
المخرجات
- الترويسة
- {"alg":"none"}
- الحمولة
- {"sub":"test","role":"admin"}
أسئلة وأجوبة
هل من الآمن لصق الرمز هنا؟
يُفك الرمز ويُتحقق منه في متصفحك ولا يُرسل إلى أي خادم. ومع ذلك عامل الرموز الحقيقية ككلمات المرور: استخدم رموز اختبار، ولا تلصق مفتاحًا خاصًا لبيئة الإنتاج في أي مكان.
هل يمكن قراءة JWT دون السر؟
نعم. الترويسة والحمولة مرمّزتان بـ base64url فقط، فيمكن لأي شخص قراءتهما. لا يلزم السر أو المفتاح الخاص إلا لإنشاء توقيع صحيح. لا تضع كلمات مرور أو أسرارًا أخرى في الحمولة.
لماذا يظهر أن التوقيع غير مطابق؟
إما أن السر أو المفتاح خاطئ، أو عُدّل الرمز بعد توقيعه، أو رمّزت الجهة المصدرة السر بـ base64. لرموز RS وES وPS تحتاج إلى المفتاح العام المطابق لـ kid في الترويسة، وغالبًا يكون في نقطة JWKS لدى الجهة المصدرة.
ماذا تعني exp وnbf وiat؟
هي أوقات بالثواني منذ 1970 (NumericDate). exp وقت انتهاء الصلاحية، وnbf وقت بدء الصلاحية، وiat وقت الإصدار. تسمح الخوادم عادةً بفارق ثوانٍ قليلة في الساعة.