PEM / JWK / JWKS

مولد أزواج مفاتيح RSA و EC

قم بتوليد أزواج المفاتيح غير المتماثلة RSA و ECDSA محلياً في متصفحك باستخدام واجهة WebCrypto دون أي اتصال بالخادم. صدّر المفتاح الخاص بصيغة PKCS#8 والمفتاح العام بصيغة SPKI مع JSON JWK وبصمة kid القياسية وفق RFC 7638 وحزمة JWKS العامة.

كيف تعمل الأداة تقنياً

يستبدل التوقيع غير المتماثل لرموز JWT المفتاح السري المشترك بزوج رياضي مكوّن من مفتاح خاص ومفتاح عام يتم إنشاؤهما محلياً في المتصفح عبر واجهة WebCrypto (crypto.subtle.generateKey). يوقّع خادم المصادقة الرموز بالمفتاح الخاص بينما تتحقق بوابات الـ API والخدمات المصغرة من صحة الرمز عبر المفتاح العام فقط.

تُصدّر الأداة المفتاح الخاص بصيغة PKCS#8 PEM والمفتاح العام بصيغة SPKI PEM بلفّ قياسي كل 64 حرفاً، مع كائنات JWK وفق معيار RFC 7517 متضمنة قيم alg و use، وحساب بصمة SHA-256 وفق RFC 7638 على الحقول العامة المرتبة أبجدياً لإنتاج معرف kid ثابت، مع إخراج حزمة JWKS عامة تماماً خالية من أي معامل خاص.

شرح عملي خطوة بخطوة مع مثال حقيقي

أنشئ وصدّر أزواج مفاتيح RSA و ECDSA بصيغ PEM و JWK و JWKS محلياً خلال أربع خطوات واضحة.

1. اختر عائلة الخوارزمية المناسبة

حدد RSASSA-PKCS1-v1_5 (RS256/384/512) أو RSA-PSS (PS256/384/512) أو RSA-OAEP لتشفير JWE، أو اختر ECDSA للمنحنيات الإهليلجية المضغوطة.

2. اضبط طول المفتاح أو المنحنى

اختر حجم 2048 أو 3072 أو 4096 بت مع دالة SHA لمفاتيح RSA، أو اختر أحد المنحنيات P-256 و P-384 و P-521 لخوارزمية ECDSA.

3. ولّد المفاتيح واحسب بصمة RFC 7638

ينفذ المتصفح عملية التوليد غير المتزامنة في الذاكرة المحلية ويحسب بصمة kid التلقائية عبر SHA-256 وفق المعيار الرسمي.

4. انسخ أو نزّل المخرجات أو أوامر OpenSSL

احفظ مفتاح PKCS#8 في خزنة الأسرار، وانشر ملف JWKS العام فقط، أو نفّذ أوامر OpenSSL المكافئة على جهاز غير متصل بالشبكة.

مثال قياسي: بصمة JWK وفق RFC 7638 القسم 3.1

الحقول العامة المرتبة أبجدياً (e, kty, n):{"e":"AQAB","kty":"RSA","n":"0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAFbWhM78LhWx..."}
بصمة معرف المفتاح kid بصيغة Base64URL:kid: "NzbLsXh8uDCcd-6MNwXF4W_7noWXFZAfHkxZsRGC9Xs"

تضمن الصيغة المرتبة الخالية من الفراغات قبل التجزئة بـ SHA-256 أن تحصل أي مكتبة قياسية على المعرف ذاته تماماً.

الأخطاء الشائعة وتنبيهات الأمان

تسريب الحقول الخاصة داخل ملف JWKS العام

يجب أن يضم نقطة /.well-known/jwks.json الحقول العامة فقط (n و e لـ RSA؛ و crv و x و y لـ EC). تسريب d أو p أو q يمكّن المهاجمين من تزوير كل الرموز.

الخلط بين صيغتي PKCS#1 و PKCS#8 في PEM

تعتمد واجهة WebCrypto والمنصات الحديثة تنسيق PKCS#8 للمفتاح الخاص و SPKI للمفتاح العام، لذلك تأكد من دعم مكتبتك لهذه الترويسات.

توليد مفاتيح الجذر الحساسة في المتصفح وحده

رغم عدم إرسال أي بايت خارج المتصفح، يُنصح بتوليد مفاتيح الإنتاج الجذرية الحساسة في بيئة معزولة أو عبر نظام KMS/HSM مثل AWS KMS و Vault.

تجاهل حقل kid أثناء تدوير المفاتيح

يساعد معرف kid الفريد خدمات التحقق على انتقاء المفتاح الصحيح من JWKS مباشرة بدلاً من تجربة كل المفاتيح عند التبديل.

مقارنة صيغ PEM و JWK و JWKS

الصيغةالنطاقالترويسة أو الحقولأفضل استخدام
PKCS#8 PEMمفتاح توقيع خاصBEGIN PRIVATE KEYتخزين الأسرار ومتغيرات البيئة المحمية
SPKI PEMمفتاح تحقق عامBEGIN PUBLIC KEYبوابات API والإعدادات الثابتة في الخوادم
JWK (JSON)مفتاح مفرد بصيغة JSONkty, alg, use, kid, n/e أو x/yتكامل WebCrypto ومكتبات RFC 7517
JWKS العامحزمة مفاتيح للتدوير{ "keys": [ publicJwk... ] }نقاط توزيع المفاتيح العامة OIDC

أمثلة برمجية (Node.js و Python و Java)

استخدم الشيفرات التالية لتوليد أزواج مكافئة وبصمات RFC 7638 برمجياً في الخادم:

Node.js (TypeScript)
import { generateKeyPairSync, createHash } from 'node:crypto';

const { publicKey, privateKey } = generateKeyPairSync('rsa', {
  modulusLength: 2048,
  publicKeyEncoding: { type: 'spki', format: 'pem' },
  privateKeyEncoding: { type: 'pkcs8', format: 'pem' },
});
const jwk = publicKey.export({ format: 'jwk' });
const kid = createHash('sha256')
  .update(JSON.stringify({ e: jwk.e, kty: 'RSA', n: jwk.n }))
  .digest('base64url');
Python
from cryptography.hazmat.primitives.asymmetric import ec
from cryptography.hazmat.primitives import serialization

priv = ec.generate_private_key(ec.SECP256R1())
priv_pem = priv.private_bytes(
    serialization.Encoding.PEM, serialization.PrivateFormat.PKCS8, serialization.NoEncryption()
)
pub_pem = priv.public_key().public_bytes(
    serialization.Encoding.PEM, serialization.PublicFormat.SubjectPublicKeyInfo
)
Java
KeyPairGenerator gen = KeyPairGenerator.getInstance("EC");
gen.initialize(new ECGenParameterSpec("secp256r1"));
KeyPair kp = gen.generateKeyPair();
String spkiB64 = Base64.getMimeEncoder(64, new byte[]{'\n'})
    .encodeToString(kp.getPublic().getEncoded());

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

أيهما أفضل لتوقيع JWT: مفاتيح RSA 2048 أم ECDSA P-256؟

يمنحك ECDSA P-256 (ES256) تواقيع أقصر بكثير وسرعة تحقق أعلى بقوة أمنية تكافئ تقريباً RSA 3072، بينما تبقى RSA 2048+ مفيدة للتوافق مع الأنظمة القديمة.

لماذا يستغرق توليد RSA 4096 وقتاً أطول من P-256؟

يتطلب توليد RSA 4096 البحث عن عددين أوليين بطول 2048 بت والتحقق منهما حسابياً، في حين يختار P-256 قيمة عشوائية واحدة بطول 256 بت.

هل تتضمن مخرجات JWKS العامة أي بيانات خاصة؟

كلا إطلاقاً؛ يحذف التبويب المخصص كل الحقول الخاصة مثل d و p و q و dp و dq و qi لضمان سلامة نشر الحزمة عبر HTTPS.

كيف تُحسب بصمة kid المعروضة؟

وفق معيار RFC 7638: تُرتّب الحقول العامة الإلزامية أبجدياً دون مسافات، ثم تُحسب بصمة SHA-256 وتُرمّز بصيغة Base64URL.

ما الفرق بين RSA-OAEP و RSA-PSS؟

تُستخدم RSA-PSS لتوقيع رموز JWS (use: sig)، بينما تُستخدم RSA-OAEP لتشفير مفاتيح الجلسة داخل رموز JWE المشفرة (use: enc).

هل يُنصح باستخدام هذه المفاتيح مباشرة لمفاتيح الجذر في الإنتاج؟

المفاتيح مولّدة محلياً بأمان عبر WebCrypto وتصلح للتطوير والاختبار، لكن لمفاتيح الإنتاج عالية الحساسية يُفضّل استخدام KMS أو التوليد دون إنترنت.

عن الكاتب

تطوّر Avada Labs أدوات مجانية للمطورين، من بينها هذا الموقع، بخبرة تمتد لست سنوات في تطوير الويب والأدوات البرمجية. المشاريع والشيفرة المصدرية متاحة على GitHub.

مولد مفاتيح RSA و EC – تصدير PEM و JWK و JWKS