يتكون رمز JSON Web Token المتوافق مع معيار RFC 7519 والمنقول بصيغة التسلسل المدمج JWS من ثلاث سلاسل Base64URL غير مبطنة مفصولة بنقاط: <header>.<payload>.<signature>. إذا نسخت قيمة ترويسة HTTP مثل Authorization: Bearer <token>، فسيقوم مفكك التشفير بإزالة بادئة المخطط Bearer تلقائياً قبل التقسيم عند النقطة ..
تأمل هذا الرمز القياسي المدمج والموقع بخوارزمية HS256:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
1. فك تشفير ترويسة JOSE المحمية
يؤدي فك تشفير Base64URL للمقطع الأول (eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9) إلى إنتاج 27 بايت بتنسيق UTF-8 تصف الخوارزمية التشفيرية ونوع الوسائط:
{
"alg": "HS256",
"typ": "JWT"
}
2. فك تشفير حمولة المطالبات وطوابع وقت NumericDate
يكشف فك تشفير Base64URL للمقطع الثاني (eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ) عن مجموعة مطالبات JSON:
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
هنا يتم تحويل الحقل iat (1516239022) إلى 2018-01-18T01:30:22Z بالتوقيت العالمي المنسق UTC. عند فحص رمز وصول خاص ببيئة الإنتاج يتضمن حدود دورة الحياة الكاملة، يقيّم الفاحص كل مطالبة NumericDate مقارنة بساعة النظام الحالية لديك:
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"iat": 1735689600,
"nbf": 1735689600,
"exp": 1735693200
}
iat(1735689600): صدر في2025-01-01T00:00:00Z.nbf(1735689600): غير صالح قبل2025-01-01T00:00:00Z.exp(1735693200): تنتهي صلاحيته في2025-01-01T01:00:00Z(فترة صلاحية TTL مدتها 3,600 ثانية بالضبط).
3. التحقق المحلي من توقيع HMAC-SHA256
يثبت فك التشفير فقط أن المقطعين الأولين يمثلان كائن JSON صالحاً مرمزاً بصيغة Base64URL؛ لكنه لا يثبت أن المطالبات لم يتم التلاعب بها. عندما تزود المفتاح السري المشترك your-256-bit-secret للمثال الأول أعلاه، يمرر المتحقق مدخل التوقيع النصي ASCII الدقيق (eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ) وتوقيع Base64URL المكون من 43 حرفاً (SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c) إلى الدالة crypto.subtle.verify("HMAC", key, signatureBytes, signingInputBytes). أي تعديل ولو لبت واحد في حمولة JSON المفككة سيغير وسم MAC المتوقع المكون من 32 بايت ويؤدي فوراً إلى فشل مطابقة التوقيع.