CSR (طلب توقيع الشهادة)

من فريق ماثل، مبني على مواصفات الهيئة و SDK 3.4.8 · آخر تحديث

الـ CSR طلب يرسله جهاز الفوترة لزاتكا عشان ياخذ شهادة CSID، فيه المفتاح العام (secp256k1) وبيانات المنشأة والجهاز بحقول تطلبها الهيئة.

CSR اختصار Certificate Signing Request: ملف يولّده الجهاز مع مفتاح خاص على منحنى secp256k1، ويرسله للهيئة مع الـ OTP عشان تصدر له شهادة CSID. المفتاح الخاص ما يطلع من عندك.

الهيئة تقرأ حقول معيّنة منه: في الـ subject الدولة C=SA، والفرع في OU، واسم المنشأة في O، والاسم في CN. وامتداد certificateTemplateName (OID 1.3.6.1.4.1.311.20.2) قيمته ZATCA-Code-Signing للإنتاج وبوابة المطورين، وPREZATCA-Code-Signing للمحاكاة. وفي subjectAltName: الرقم التسلسلي SN، والرقم الضريبي UID، وخريطة الوظائف title، والعنوان المختصر registeredAddress، والنشاط businessCategory.

وش يغلط؟ إضافة امتدادات مثل basicConstraints أو keyUsage تخلي البوابة ترد Invalid-CSR. وopenssl يحذف بصمت أي قيمة غير ASCII في subjectAltName وكل اللي بعدها، فعنوان بالعربي يضيّع حقلين ويرجع Invalid-CSR. وقالب الشهادة الغلط للبيئة يفشل بعد.

ماثل يولّد المفتاح والـ CSR لكل جهاز بنفسه، مطابقة للـ CSR اللي يولّده SDK الهيئة، ويولّد CSR جديد وقت التجديد.

مثال

[ v3_req ]
certificateTemplateName = ASN1:PRINTABLESTRING:ZATCA-Code-Signing
subjectAltName = dirName:alt_names

[ alt_names ]
SN = 1-Matheel|2-…|3-…
UID = 3…3
title = 1100
registeredAddress = RRRD2929
businessCategory = General

أسئلة شائعة

ليش البوابة ترد Invalid-CSR؟

أشهر الأسباب: امتدادات زيادة (keyUsage، basicConstraints)، أو قيم غير ASCII داخل subjectAltName، أو قالب شهادة ما يناسب البيئة.

هل أرسل المفتاح الخاص للهيئة؟

لا. الـ CSR فيه المفتاح العام بس، والخاص يبقى مع الجهاز يوقّع به الفواتير.

مصطلحات قريبة

خلّ ماثل يتعامل مع هذا عنك

ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.

جرّب ماثل بدون تسجيل توثيق ماثل API