محول JWK
حوّل المفاتيح بين PEM وJSON Web Key. الصق مفتاح PEM خاصًا بصيغة PKCS #8 أو PKCS #1 أو SEC1، أو مفتاحًا عامًا أو شهادة للحصول على JWK المقابل، أو الصق JWK أو JWKS يحتوي على ما يصل إلى 20 مفتاحًا لاستعادة مفاتيح PKCS #8 وSPKI بصيغة PEM. يدعم المفاتيح RSA وEC (P-256 وP-384 وP-521 وsecp256k1) وEd25519 وEd448 وX25519 وX448، ويعرض نوع كل مفتاح وبصمة RFC 7638.
الأسئلة الشائعة
كيف يحدد المحول اتجاه التحويل؟
تُقرأ المدخلات التي تبدأ بـ { على أنها JWK أو JWKS وتُحوّل إلى PEM. وتُقرأ المدخلات التي تحتوي على سطر -----BEGIN على أنها PEM وتُحوّل إلى JWK. أما أي صيغة أخرى فتُرفض مع توضيح للصيغ المتوقعة.
ما مدخلات PEM المقبولة؟
المفاتيح الخاصة غير المشفّرة بصيغ PKCS #8 (BEGIN PRIVATE KEY) وPKCS #1 (BEGIN RSA PRIVATE KEY) وSEC1 (BEGIN EC PRIVATE KEY)، والمفاتيح العامة بصيغة SPKI (BEGIN PUBLIC KEY) أو PKCS #1 (BEGIN RSA PUBLIC KEY)، وشهادات X.509 التي يُحوَّل مفتاحها العام. عند لصق عدة كتل PEM، يُستخدم أول مفتاح خاص، وإلا فيُستخدم أول مفتاح عام أو شهادة.
ما الناتج عند استخدام مفتاح خاص؟
ينتج عن مفتاح PEM خاص كائن JWK خاص بجميع أعضائه، مثل d وp وq وdp وdq وqi لمفاتيح RSA، بالإضافة إلى JWK العام المطابق. شارك JWK العام فقط، لأن الخاص يحتوي على بيانات المفتاح السرية.
هل يمكنني تحويل JWKS كامل؟
نعم. الصق مستندًا يتضمن مصفوفة keys تحتوي على ما يصل إلى 20 مفتاحًا، مثل مستند صادر عن نقطة نهاية jwks_uri، وسيُحوّل كل مفتاح إلى PEM مع فهرسه وkid. تعيد مفاتيح JWK الخاصة، التي يُتعرّف عليها من عضوها d، المفتاح الخاص PKCS #8 والمفتاح العام SPKI.
لماذا لا يمكن تحويل مفتاح متماثل؟
المفاتيح التي قيمة kty فيها oct هي بايتات سرية مجردة لـ HMAC أو AES، وليس لها تمثيل PEM. استخدمها مباشرةً، مثلًا في مولّد JWT، الذي يقبل JWK من نوع oct بوصفه سر HMAC.
ما وظيفة خيار kid؟
عند تفعيله، تُضاف بصمة RFC 7638 للمفتاح كعضو kid في JWK المُنشأ. يمنح ذلك المفتاح معرّفًا ثابتًا يمكن لجهات التحقق مطابقته مع ترويسة kid في JWT.
ما بصمة RFC 7638؟
إنها تجزئة SHA-256 بترميز base64url لأعضاء المفتاح العامة المطلوبة بترتيب ثابت، مثل e وkty وn في RSA أو crv وkty وx وy في EC. تكون للمفتاح نفسه البصمة ذاتها دائمًا، سواء خُزّن بصيغة PEM أو JWK.
هل المفاتيح المشفّرة أو مفاتيح OpenSSH مدعومة؟
لا. يجب أولًا إزالة عبارة المرور من مفاتيح PEM المشفّرة، مثلًا باستخدام openssl pkey -in encrypted.pem -out key.pem. ويجب تحويل مفاتيح OpenSSH الخاصة إلى PEM باستخدام ssh-keygen قبل أن يمكن قراءتها هنا.
ما أنواع المفاتيح المتوافقة؟
RSA وEC على المنحنيات P-256 وP-384 وP-521 وsecp256k1، وأنواع OKP وهي Ed25519 وEd448 وX25519 وX448. لا صيغة JWK لمفاتيح DSA وDiffie-Hellman، لذا تُرفض مع توضيح السبب.
هل يُحتفَظ بمفتاحي الخاص؟
لا. يُحوّل المفتاح في الذاكرة لهذا الطلب ولا يُسجَّل أو يُحفَظ مطلقًا. يُفضّل تحويل المفاتيح العامة عبر الإنترنت، والتعامل مع مفاتيح الإنتاج الخاصة على أنظمة تتحكم بها.