العودة إلى المقالات
مرجع2026-11-07•8 دقائق قراءة•فريق CSR.plus

أوامر OpenSSL لإنشاء CSR: RSA و ECDSA و SAN والأخطاء الشائعة

أوامر OpenSSL لإنشاء CSR: RSA و ECDSA و SAN والأخطاء الشائعة

الأمر الواحد الذي يحتاجه معظم الناس

openssl req -new -newkey rsa:2048 -nodes \
  -keyout privkey.pem -out request.csr \
  -subj "/CN=example.com" \
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

اقرأه هكذا: أنشئ طلبًا جديدًا، وولّد مفتاحًا جديدًا معه، لا تُشفّر إخراج المفتاح (-nodes)، واكتب المفتاح إلى privkey.pem والطلب إلى request.csr، واضبط الـ subject على CN=example.com، وأضف امتداد SAN يغطي النطاق الرئيسي و www.

أكثر ما يربك المستخدمين خياران:

  • -nodes (اختصار لـ "no DES") يعني أن المفتاح الخاص يُكتب بصورة واضحة. أزله وسيُطلب منك عبارة مرور لا تستطيع معظم الخوادم إدخالها عند الإقلاع.
  • -addext يتطلب OpenSSL 1.1.1+. في الإصدارات الأقدم لا يدعم الأمر SAN بصمت.

RSA 4096

نفس الأمر بمفتاح أكبر:

openssl req -new -newkey rsa:4096 -nodes \
  -keyout privkey.pem -out request.csr \
  -subj "/CN=example.com" \
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

يكلّف RSA بطول 4096 بت قدرًا ملحوظًا إضافيًا من CPU لكل مصافحة مقابل مكسب أمني متواضع. إن أردت تشفيرًا أقوى فـ ECDSA هو الخيار الأفضل.

ECDSA P-256 و P-384

openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -nodes \
  -keyout privkey.pem -out request.csr \
  -subj "/CN=example.com" \
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

استبدل prime256v1 بـ secp384r1 إذا طلبت هيئة الإصدار ECDSA بطول 384 بت. لاحظ أن بعض حزم Android و Windows القديمة لا تزال تفشل مع سلاسل ECDSA — افحص حركة المرور قبل التبديل.

العديد من SAN أو عنوان IP

مع قائمة SAN طويلة يصبح -addext غير عملي. استخدم ملف إعدادات:

# csr.cnf
[req]
default_bits       = 2048
prompt             = no
default_md         = sha256
distinguished_name = dn
req_extensions     = v3_req

[dn]
CN = example.com

[v3_req]
subjectAltName = @alt_names

[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
DNS.3 = api.example.com
IP.1  = 192.0.2.10
openssl req -new -newkey rsa:2048 -nodes \
  -keyout privkey.pem -out request.csr -config csr.cnf

السطر المهم هو req_extensions. بدونه تحصل على CSR صالح تمامًا بلا أي SAN — ورفض من هيئة الإصدار يقول إن الأسماء غير متطابقة.

افحص ما بنيته قبل الإرسال

openssl req -in request.csr -noout -text

ابحث عن:

  • Subject Alternative Name بكل أسماء المضيفين المتوقعة
  • سطر Public-Key الذي يظهر 2048 bit (أو id-ecPublicKey مع المنحنى الصحيح)
  • Signature Algorithm مثل sha256WithRSAEncryption

ثم تحقق من أن التوقيع متسق داخليًا:

openssl req -in request.csr -noout -verify

الملف السليم يطبع verify OK. إن طبع "unable to load" فالملف مبتور — غالبًا لأنه نُسخ من طرفية لفّت الأسطر.

رسائل الخطأ وما تعنيه فعليًا

MessageReal causeFix
Error unpacking CSRالملف بصيغة DER لا PEM، أو يحوي نصًا دخيلًاحوّله: openssl req -inform DER -in request.der -out request.csr
no start lineترويسة PEM مفقودة أو نهايات الأسطر تالفةتأكد أن الملف يبدأ بـ -----BEGIN CERTIFICATE REQUEST-----
error adding extension-addext على OpenSSL 1.0.2استخدم ملف إعدادات
unable to load private keyمفتاح محمي بعبارة مرورأضف -passin pass:... أو أنشئه مجددًا بدون -passphrase
CSR accepted but names rejectedSAN مفقود أو CN فقطأعد الإنشاء بـ -addext

طابق CSR مع مفتاحه

قبل النشر، تأكد أن الشهادة التي تعود إليك تخص المفتاح الموجود على الخادم:

openssl req -in request.csr -noout -pubkey
openssl pkey -in privkey.pem -pubout

يجب أن تكون الكتلتان متطابقتين بايتًا ببايت. إن اختلفتا فأنت على وشك تركيب شهادة لا تطابق مفتاحك — السبب الكلاسيكي لـ ssl_error_no_cypher_overlap و "key values mismatch" من nginx.

تقوم أداة مطابقة المفاتيح بالمقارنة نفسها في المتصفح، دون نسخ مادة المفتاح الخاص إلى أي مكان.

لماذا نستخدم سطر الأوامر أصلًا

لأنه قابل لإعادة الإنتاج. CSR أنشئ على حاسوب محمول بالنقر عبر نموذج يصعب تدقيقه؛ أما أمر في runbook فيمكن مراجعته وإعادة تشغيله وإدارته بإصدارات. ضع الأمر بجانب سكربت النشر، ولا تُودع privkey.pem أبدًا — فقط الـ CSR آمن للحفظ في المستودع.

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

أي إصدار من OpenSSL يدعم -addext؟

1.1.1 وما بعده. على CentOS 7 أو إصدارات macOS القديمة قد تجد 1.0.2 حيث لا وجود لـ -addext — استخدم ملف إعدادات يحوي [v3_req] بدلًا منه.

لماذا لا يحتوي CSR على SAN رغم أنني مررت -subj؟

-subj يضبط الـ subject فقط (CN). أما SAN فيأتي من -addext أو ملف الإعدادات. أي CSR بني بـ -subj وحده ترفضه كل هيئات الإصدار الحديثة لأن المتصفحات تتجاهل CN.

كيف أتحقق من أن CSR يطابق مفتاحًا خاصًا؟

قارن المفتاح العام لكليهما: openssl req -in request.csr -noout -pubkey و openssl pkey -in privkey.pem -pubout يجب أن يطبعا كتلًا متطابقة.

هل يمكن أن يحتوي CSR على عنوان IP؟

نعم، استخدم IP:192.0.2.10 في قائمة SAN. نادرًا ما تُصدر هيئات الإصدار العامة شهادات لعناوين IP عامة، لكن هيئات الإصدار الداخلية وبيئات اختبار Let’s Encrypt تفعل ذلك.

أدوات SSL/TLS المجانية

تحقق وافحص شهاداتك في ثوانٍ.

معلومات الشهادات ذات الصلة

تعرف على كيفية اختيار وشراء شهادات SSL.

مقالات ذات صلة