شهادة الامتثال CSID في زاتكا — كيفية تأهيل نظامك الإنتاجي

نظرة عامة

شهادة CSID (مُعرّف الختم التشفيري) هي الشهادة التي تخوّل نظامك التحدّث مع منصة فاتورة. لحظة تحوّل نموذجك التجريبي إلى نظام إنتاجي. CSID على مستوى الجهاز لا على مستوى الشركة؛ سلسلة من 200 نقطة بيع تحتاج 200 شهادة.

على من يطبَّق

• كل مكلّف بضريبة القيمة المضافة لديه نظام يصدر فواتير إلكترونية.

الخطوة 0: المتطلبات

• رقم تسجيل ضريبي.
• حساب بوابة زاتكا.
• نظام إنتاجي يجتاز جميع سيناريوهات الـ sandbox.
• OTP لمرة واحدة من البوابة لكل جهاز.

الخطوة 1: توليد المفتاح والـ CSR

openssl ecparam -name secp256k1 -genkey -noout -out device.key
openssl req -new -key device.key -out device.csr -config csr.conf

العناصر الإلزامية في CSR: CN، SerialNumber بنمط 1-...|2-...|3-...، subjectAltName بصياغة SN=|EGS=|SOL=|VAT=.

الخطوة 2: إرسال CSR إلى sandbox

curl -X POST '.../developer-portal/compliance' \
  -H "OTP: 123456" \
  --data "{\"csr\":\"$(base64 -w0 device.csr)\"}"

تحصل على binarySecurityToken + secret + requestID.

الخطوة 3: حملة الاختبار

أرسل من CSID التجريبي مجموعة سيناريوهات: قياسي (B2B) + إشعار مدين + إشعار دائن + مبسط (B2C) + إشعارات + نسب VAT 0%/5%/15%.

الخطوة 4: إصدار CSID الإنتاج

curl -X POST '.../core/production/csids' \
  -H "Authorization: Basic <BASE64(sandbox:secret)>" \
  --data "{\"compliance_request_id\":\"$REQUEST_ID\"}"

تحصل على CSID الإنتاج — أكثر أسرار النظام حساسية.

الخطوة 5: تخزين الأسرار

مقبول: HashiCorp Vault، Secrets Manager بمفاتيح يديرها العميل داخل المملكة، HSM. مرفوض: ملف إعدادات، متغير بيئة عام، مستودع Git. عزل لكل جهاز: مسار خاص في Vault.

الخطوة 6: التجديد

• صلاحية CSID سنة.
• جدّد قبل 30 يومًا من الانتهاء.
• حافظ على استمرار ICV/PIH عبر التجديد.

curl -X POST '.../core/production/csids/renew' \
  -H "Authorization: Basic <BASE64(current:secret)>" \
  -H "OTP: $NEW_OTP"

الخطوة 7: الإلغاء

عند فقدان أو سرقة أو تقاعد جهاز: إلغاء فوري من البوابة، إصدار بديل، تحليل جنائي للفجوة.

أخطاء شائعة

• منحنى ECDSA خاطئ (P-256 بدل secp256k1).
• فواصل خاطئة في SAN.
• مشاركة CSID بين أجهزة → كسر سلسلة ICV.
• تخزين الأسرار في ملف Git.

التحقق

• جرد CSID لكل جهاز مع تواريخ الإصدار والتجديد.
• سجل وصول الأسرار.
• نتائج حملة الاختبار محفوظة 6 سنوات.
• سلامة ICV/PIH عبر التجديدات.

الخلاصة

CSID نقطة اللاعودة من sandbox إلى الإنتاج؛ اضبط التشفير وتخزين الأسرار والطقوس التشغيلية مرة واحدة.

أدلة ذات صلة

• التكامل التقني للمرحلة الثانية
• الفوترة الذاتية وإيصالات B2C
• NCA ECC v2