محوّل PEM ↔ JWK
الإدخال (PEM أو JWK / JWKS)
المخرجات
التفاصيل التقنية
كيف يعمل محوّل PEM إلى JWK
ما الذي يفعله محوّل PEM ↔ JWK
تحوّل هذه الأداة المفاتيح التشفيرية بين PEM (نص DER بصيغة Base64، كما تستخدمه OpenSSL وnginx ومعظم الخوادم) وJWK / JWKS (JSON Web Key، وفق RFC 7517، كما يُستخدم في JWT وOAuth 2.0 وOpenID Connect). الصق مفتاح PEM عامًا (SPKI) أو مفتاحًا خاصًا (PKCS#8) أو شهادة X.509 أو مفتاح RSA بصيغة PKCS#1 أو مفتاح EC بصيغة SEC1 لتحصل على JWK؛ والصق JWK أو مستند JWKS لتحصل على PEM. يُكتشف الاتجاه تلقائيًا. كما تحسب الأداة بصمة SHA-256 وفق RFC 7638، وهي الطريقة القياسية لاشتقاق kid ثابت. تتم كل المعالجة محليًا في متصفحك.
حالات الاستخدام الشائعة
تشمل الاستخدامات المعتادة نشر مفتاح عام في نقطة نهاية /.well-known/jwks.json، وإعداد مزوّد هوية أو API gateway يتوقع JWKS، وتحويل شهادة إلى JWK للتحقق من توقيعات JWT، وإنشاء kid يطابق ما تحسبه المكتبات الأخرى، وتحويل JWK مستلم من مزوّد إلى PEM يمكن لـ OpenSSL أو خادم الويب قراءته. وهي مفيدة أيضًا عند تتبّع أخطاء التحقق من رموز RS256 أو ES256 أو EdDSA.
أنواع المفاتيح والتنسيقات المدعومة
أنواع المفاتيح المدعومة هي RSA (RS256 وPS256 وRSA-OAEP)، ومفاتيح المنحنيات الإهليلجية P-256 وP-384 وP-521 (ES256 وES384 وES512)، ومفاتيح OKP: Ed25519 (EdDSA) وX25519 (ECDH-ES). تسميات PEM المدعومة هي PUBLIC KEY وPRIVATE KEY وCERTIFICATE وRSA PUBLIC KEY وRSA PRIVATE KEY وEC PRIVATE KEY. تُستنتج الخوارزمية من المفتاح ويمكن تجاوزها؛ ويمكن إضافة الأعضاء الاختيارية use وalg وkid وغلاف JWKS إلى المخرجات.
المزالق والحدود
أي JWK يحتوي على العضو d (أو p وq وdp وdq وqi في RSA) هو مفتاح خاص ويجب ألا يُنشر أبدًا؛ استخدم خيار المفتاح العام فقط قبل وضع مفتاح في نقطة نهاية JWKS. ملفات PEM المشفّرة غير مدعومة، لذا فك تشفيرها أولًا باستخدام openssl. تُحسب بصمة kid من الأعضاء العامة فقط، لذا يشترك JWK العام والخاص لنفس المفتاح في kid واحد. تُحوَّل الشهادات إلى المفتاح العام فقط: لا تُنقل السلسلة والموضوع والصلاحية إلى JWK.