طريقة استخدام أداة فك ترميز JWT
- الصق الرمزالصق رمز JWT في المربع. تُحذف البادئة “Bearer ” وفواصل الأسطر تلقائيًا.
- اقرأ المحتوىيُفك ترميز الـ header والـ payload بألوان مميزة، مع شرح كل مطالبة بلغة بسيطة.
- تحقّق من التواريختُحوَّل تواريخ الانتهاء (exp) والإصدار (iat) و“غير صالح قبل” (nbf) إلى تواريخ، مع شارة واضحة: منتهي الصلاحية / غير منتهي الصلاحية.
- تحقّق من التوقيعلرموز HS256 أو HS384 أو HS512، أدخل السر المشترك لتتأكد أن الرمز أصلي.
المزايا
- فك ترميز فوريتتحدث النتائج عند اللصق. لا أزرار ولا انتظار.
- مطالبات مقروءةتُعرض المطالبات القياسية مثل iss وsub وaud وexp مع تسميتها وشرحها.
- حالة الانتهاءاعرف بنظرة هل انتهت صلاحية الرمز أم لم يصبح صالحًا بعد.
- فحص التوقيعتحقّق من الرموز الموقّعة بـ HMAC باستخدام WebCrypto داخل متصفحك.
ما هو JWT؟
JSON Web Token (JWT) طريقة مضغوطة وآمنة للروابط لنقل ادعاءات (claims) بين طرفين. يُستخدم كثيرًا في جلسات تسجيل الدخول ومصادقة الواجهات البرمجية والدخول الموحد (OAuth 2.0 وOpenID Connect)، بما في ذلك كثير من بوابات الدخول الحكومية والمصرفية. يتكون JWT من ثلاثة أجزاء مفصولة بنقاط:
- الترويسة: نوع الرمز وخوارزمية التوقيع، مثل HS256 أو RS256.
- المحتوى (payload): الادعاءات، مثل هوية المستخدم ووقت انتهاء الرمز.
- التوقيع: يثبت أن الرمز أنشأه من يملك المفتاح وأنه لم يُعدّل.
الترويسة والمحتوى مرمّزان فقط بـ Base64URL، لا مشفران. يستطيع أي شخص يملك الرمز قراءتهما، وهذا بالضبط ما تفعله هذه الأداة. لا تضع أبدًا كلمات مرور أو أسرارًا في محتوى JWT. وتتحدث النتائج فور اللصق، بلا أزرار أو انتظار. وإذا احتوى المحتوى على أسماء عربية، مثل name أو given_name، فستظهر بالعربية بشكل صحيح لأن المحتوى مرمّز بـ UTF-8.
الادعاءات القياسية
| الادعاء | المعنى |
|---|---|
| iss | المُصدر: من أنشأ الرمز |
| sub | الموضوع: عادة معرّف المستخدم |
| aud | الجمهور: لأي تطبيق أو واجهة برمجية الرمز |
| exp | تاريخ الانتهاء، كطابع زمني يونكس بالثواني |
| nbf | ليس قبل: الرمز غير صالح قبل هذا التاريخ |
| iat | وقت الإصدار: متى أُنشئ الرمز |
| jti | معرّف JWT: معرّف فريد لمنع إعادة الاستخدام |
تظهر التواريخ بصيغة مقروءة، مع وسم «منتهي الصلاحية» أو «غير منتهي الصلاحية» حسب الوقت الحالي في جهازك. ولتحويل طابع زمني آخر استخدم محوّل الطابع الزمني.
فك الترميز ليس تحققًا
فك الترميز يعرض فقط ما يقوله الرمز. قبل الوثوق به يجب على الخادم التحقق من التوقيع، وفحص exp وnbf، والتأكد من المُصدر والجمهور. والرموز التي تحمل "alg": "none" لا توقيع لها ويجب رفضها دائمًا.
- HS256 وHS384 وHS512 تستخدم سرًا مشتركًا للتوقيع والتحقق. اكتب السر أعلاه للتحقق؛ يتم الفحص عبر WebCrypto في متصفحك. وإذا كان السر مرمّزًا، فحدد «السر بصيغة Base64».
- RS256 وES256 وPS256 وما شابهها توقّع بمفتاح خاص وتُتحقق بمفتاح عام، ينشره المُصدر عادة في نقطة JWKS. تحقق من هذه الرموز في الخادم بمكتبة موثوقة.
نصائح أمنية
- اجعل رموز الوصول قصيرة العمر (دقائق لا أيام) واستخدم رموز التحديث للجلسات الطويلة.
- استخدم سرًا طويلًا وعشوائيًا مع خوارزميات HMAC؛ السر القصير أو السهل التخمين يمكن كسره دون اتصال. يستطيع مولّد كلمات المرور إنشاء واحد.
- الصق رموز بيئة الإنتاج فقط في أدوات تعمل محليًا مثل هذه.