مولّد مفتاح JWT السري — HS256/384/512

ما هو مولّد مفتاح JWT السري؟

// The secret you generate here goes straight into your signing code.
// Node.js with jsonwebtoken — the JWT_SECRET env var holds the key.
import jwt from 'jsonwebtoken';

const secret = process.env.JWT_SECRET; // e.g. base64url value from this tool

// Sign a token with HS256 (HMAC-SHA-256).
const token = jwt.sign({ sub: 'user-42', role: 'member' }, secret, {
  algorithm: 'HS256',
  expiresIn: '15m'
});

// Verify it — pin the algorithm to a whitelist; never trust the token's alg.
const payload = jwt.verify(token, secret, { algorithms: ['HS256'] });

// ---------------------------------------------------------------
// Python with PyJWT — same secret, same algorithm pinning.
// import jwt
// token = jwt.encode({"sub": "user-42"}, key, algorithm="HS256")
// payload = jwt.decode(token, key, algorithms=["HS256"])  # whitelist!

// ---------------------------------------------------------------
// Equivalent-strength CLI generation (32 bytes for HS256):
//   openssl rand -base64 32
//   node -e "console.log(require('crypto').randomBytes(32).toString('base64url'))"
//   python -c "import secrets; print(secrets.token_urlsafe(32))"

الميزات الرئيسية

أمثلة محلولة

Algorithm: HS256 · Format: base64url

3sJ9aFq2kP7mWcZ1xL0nVtRbYdGhU8eAoI4QpNlKj0

Algorithm: HS512 · Format: base64url

k2Lp9XqA0mNbVcZ7rT4wYsHfGjUe8RoIdPlNkBvM3xQ1aWtCyZuS6FhEgJ (86 chars)

Click "Copy for .env"

JWT_SECRET=3sJ9aFq2kP7mWcZ1xL0nVtRbYdGhU8eAoI4QpNlKj0

Show the CLI command

openssl rand -base64 32

Toggle the eye icon

•••••••••••••••••••••••••••••••••••••••••••  ↔  3sJ9aFq2kP7m…

كيفية استخدام مولّد مفتاح JWT السري

1. 1

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

   انتقِ HS256 أو HS384 أو HS512. يطبّق المولّد فوراً الحد الأدنى لطول المفتاح وفق RFC 7518 §3.2 لتلك الصيغة من HMAC — 32 أو 48 أو 64 بايتاً — فلا تضطر أبداً إلى البحث عن الرقم أو المخاطرة بمفتاح أقصر من اللازم.

2. 2

   اختر صيغة الإخراج

   base64url هو الافتراضي — ترميز JWT الأصلي الآمن في الروابط دون حشو. بدّل إلى base64 القياسي إن توقّعه مُحمِّل، أو hex حين يقبل نظام أحرف 0–f فقط. الثلاثة تُرمّز البايتات العشوائية نفسها بإنتروبيا متطابقة.

3. 3

   اكشف المفتاح السري وانسخه

   يُقنَّع المفتاح السري افتراضياً لإبقائه خارج الشاشة أثناء عرض توضيحي أو مشاركة شاشة. انقر أيقونة العين لكشفه، ثم «نسخ» لأخذ القيمة الخام أو «نسخ لـ.env» لنسخ سطر JWT_SECRET=… جاهز لملف .env أو متغيّر CI.

4. 4

   أعد التوليد عند الحاجة

   انقر «إعادة التوليد» لمفتاح سري جديد مستقل مسحوب من crypto.getRandomValues. ولّد مفتاحاً لكل بيئة — لا تعد استخدام مفتاح التوقيع نفسه عبر التطوير والتجهيز والإنتاج أبداً.

5. 5

   استخدم مكافئ سطر الأوامر أو انتقل إلى التوقيع

   تُظهر لوحة سطر الأوامر أوامر openssl وNode وPython المطابقة بسطر واحد للتوفير المؤتمت. وبمفتاحك بيدك، وقّع رمزاً بـمنشئ JWT وأكّد التوقيع بـمحلّل JWT.

أخطاء شائعة في مفتاح JWT السري

JWT_SECRET=mySuperSecret123  →  low entropy, brute-forceable

JWT_SECRET=3sJ9aFq2kP7mWcZ1xL0nVtRbYdGhU8eAoI4QpNlKj0  →  32 random bytes

16-byte key with HS256  →  below the 32-byte minimum

32-byte key with HS256  →  meets RFC 7518 §3.2

Math.random()-based key  →  predictable, unsafe

crypto.getRandomValues key  →  full entropy

Service A: raw string · Service B: base64-decoded  →  signatures never match

Both services use the identical stored string  →  signatures verify

Same JWT_SECRET in dev, staging, prod  →  one leak breaks all

A unique secret per environment  →  blast radius contained

jwt.verify(token, secret)  →  accepts the token's alg

jwt.verify(token, secret, { algorithms: ['HS256'] })  →  pinned

من يستخدم هذه الأداة

توفير JWT_SECRET لخدمة جديدة

تطلق واجهة برمجية تُصدر رموزاً موقّعة بـHMAC؟ انتقِ الخوارزمية التي تستخدمها مكتبتك، وانسخ المفتاح السري كسطر JWT_SECRET=…، وأسقطه في بيئة الخدمة. ولّد مفتاحاً متمايزاً للتطوير والتجهيز والإنتاج — لا تشارك مفتاحاً سرياً واحداً عبر البيئات أبداً.

تدوير مفتاح سري مسرّب أو متقادم

حين يُشتبَه بتسريب مفتاح أو يحين موعد تدويره ببساطة، ولّد مفتاحاً سرياً جديداً هنا، وأسنِد له kid جديداً، وانشره بنافذة تداخل كي تواصل الرموز الحيّة التحقق حتى تنتهي صلاحيتها. وفي تسريب مؤكَّد، دوّر فوراً وأسقط المفتاح القديم من المجموعة المقبولة.

استبدال مفتاح ضعيف أو مكتوب يدوياً

ورثت قاعدة شيفرة JWT_SECRET فيها عبارة قصيرة أو قيمة مثال منسوخة؟ ذلك المفتاح قابل للكسر بالقوة الغاشمة دون اتصال. ولّد بديلاً بإنتروبيا كاملة من 32 بايتاً، وبدّله خلف نافذة تدوير، وأغلق ثغرة تزوير الرموز قبل أن تُستغَل.

أتمتة توليد المفاتيح في خط أنابيب

تحتاج إنشاء المفتاح في CI أو Dockerfile بدل يدوياً؟ استخدم أمر openssl أو Node أو Python بسطر واحد من لوحة سطر الأوامر لسكّ مفتاح متساوي القوة داخل سكربت التوفير، واستخدم هذه الصفحة لفهم أطوال البايتات والترميزات التي ينتجها كل أمر.

تعليم توقيع JWT بأمان

اشرح لفريق كيف يعمل HS256 دون كشف مفتاح إنتاج حقيقي أبداً — ولّد مفتاحاً سرياً يُتخلَّص منه على الشاشة (مقنَّعاً حتى تكشفه)، ووقّع رمزاً نموذجياً بـمنشئ JWT، وتحقّق منه بـمحلّل JWT كي تكون دورة التوقيع والتحقق كلها مرئية.

قارن أحجام مفاتيح HS256 وHS384 وHS512

تقرّر أي صيغة من HMAC تعتمدها؟ تنقّل بين الخوارزميات لترى كيف ينمو طول المفتاح المطلوب والسلسلة المرمَّزة — 43 و64 و86 حرف base64url — واختر مقايضة القوة مقابل حجم الرمز التي تناسب نظامك قبل أن تثبّتها في الإعداد.

توليد مفاتيح للتطوير المحلي

تحتاج مفتاحاً سرياً سريعاً وصالحاً لتشغيل تدفّق مصادقة محلي؟ ولّد واحداً بنقرة، وانسخه لـ.env، وقد انفكّ حظرك — بمفتاح من مولّد عشوائي آمن تعمويّاً حقيقي بدل قيمة نائبة ستنسى استبدالها قبل النشر.

كيف يعمل المولّد

crypto.getRandomValues (مولّد عشوائي آمن تعمويّاً)

تُولَّد الأسرار بملء Uint8Array بـcrypto.getRandomValues، مولّد Web Crypto العشوائي الزائف الآمن تعمويّاً. هو مصدر الإنتروبيا نفسه الذي يدعم توليد مفاتيح Web Crypto. لا يُستخدم Math.random أبداً في أي مكان — فهو متنبَّأ به إحصائياً وغير صالح لأي مفتاح تعموي.

تحجيم المفتاح وفق RFC 7518 §3.2

يتبع عدد البايتات لكل خوارزمية اشتراط JSON Web Algorithms بأن يكون مفتاح HMAC بحجم ناتج التجزئة على الأقل: 32 بايتاً لـHS256 (SHA-256)، و48 لـHS384 (SHA-384)، و64 لـHS512 (SHA-512). يضبط اختيار الخوارزمية الحد الأدنى؛ ولن يُصدر المولّد مفتاحاً دون عتبة المواصفة.

ترميزات RFC 4648 (base64url / base64 / hex)

تُرمَّز البايتات الخام بأبجديات RFC 4648. يستخدم base64url الأبجدية الآمنة في الروابط دون حشو (32 بايتاً ← 43 حرفاً)، ويستخدم base64 القياسي حشو + و/ و= (← 44 حرفاً)، ويكتب hex حرفين لكل بايت (← 64 حرفاً). تبديل الصيغ يعيد ترميز البايتات نفسها — الإنتروبيا الكامنة لا تتغير.

لماذا base64url هو الافتراضي

مكوّنات JWT نفسها مرمَّزة بـbase64url، والأبجدية الآمنة في الروابط دون حشو تعني أن مفتاحاً سرياً بـbase64url لا يحتاج أبداً إلى هروب في ترويسة أو رابط أو ملف إعداد. قد ينكسر + و/ وحشو = الأخير في base64 القياسي في تلك السياقات، لذا base64url هو الافتراضي المتحفّظ لـJWT_SECRET.

تنسيق «نسخ لـ.env»

يُصدر «نسخ لـ.env» JWT_SECRET=<value> في سطر واحد بلا علامات اقتباس محيطة — الشكل الذي تحلّله المُحمِّلات بنمط dotenv دون تعديل. لا يحوي المفتاح السري الخام أبداً أحرفاً تستلزم اقتباساً في ملف .env، فالسطر آمن للّصق كما هو.

أوامر سطر أوامر متساوية القوة، لا مطابقة بايتياً

أوامر openssl rand -base64 N وNode randomBytes(N).toString('base64url') وPython secrets.token_urlsafe(N) في لوحة سطر الأوامر تسحب جميعها N بايتاً عشوائياً آمناً للخوارزمية المختارة. تنتج مفاتيح متساوية القوة، لا السلسلة نفسها — يُصدر openssl base64 قياسياً بحشو، فتختلف الأبجدية والأحرف الأخيرة عن افتراضي هذه الأداة base64url.

أفضل ممارسات مفتاح JWT السري

طابِق طول المفتاح مع الخوارزمية

استخدم 32 بايتاً على الأقل لـHS256، و48 لـHS384، و64 لـHS512، كما تشترط RFC 7518 §3.2. يفعل هذا المولّد ذلك عنك، لكن إن حجّمت مفتاحاً يدوياً فلا تنزل أبداً دون طول ناتج التجزئة — مفتاح HMAC أقصر من اللازم يُضعِف التوقيع وقد ترفضه المكتبات الصارمة.

ولّد دائماً بمولّد عشوائي آمن تعمويّاً، لا بكلمة مرور

مفتاح JWT السري اعتماد آلة لا يحتاج أحد إلى حفظه، فأنفِق الإنتروبيا الكاملة: استخدم مفتاحاً عشوائياً آمناً تعمويّاً، لا عبارة مرور أو كلمة قاموسية أو سلسلة مكتوبة يدوياً. الأسرار التي يختارها البشر هي الهدف الأسهل لهجمات القوة الغاشمة دون اتصال التي تؤتمتها أدوات كسر JWT.

استخدم مفتاحاً سرياً فريداً لكل بيئة

يجب أن يكون للتطوير والتجهيز والإنتاج كلٍّ منها JWT_SECRET خاص به. مشاركة مفتاح واحد تعني أن تسريباً في بيئة منخفضة المخاطر يزوّر الرموز في كل مكان، وتجعل التدوير الكل أو لا شيء. ولّد مفتاحاً سرياً منفصلاً هنا لكل بيئة وخزّن كلاً منه في نطاق مدير أسرار خاص به.

ثبّت الخوارزمية عند التحقق

على جانب التحقق، مرّر دائماً قائمة بيضاء صريحة بالخوارزميات — algorithms: ['HS256'] في jsonwebtoken، وalgorithms=["HS256"] في PyJWT — ولا تثق أبداً بحقل alg داخل الرمز. قبول الخوارزمية التي يعلنها الرمز عن نفسه يتيح هجمات خلط الخوارزمية الكلاسيكية وalg:none للتزوير، مهما كان مفتاحك قوياً.

دوّر بترويسة kid ومفاتيح متداخلة

وسِم الرموز الموقّعة بمُعرّف مفتاح (kid) وانشر المفاتيح النشطة عبر نقطة نهاية JWKS كي تدوّر دون توقّف: وقّع الرموز الجديدة بالمفتاح الجديد مع استمرار قبول القديم حتى تنتهي صلاحية رموزه. وعند الاشتباه بتسريب، تخطَّ التداخل وألغِ المفتاح القديم فوراً.

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