باختصار — من شيفرتك إلى الشهادة
من أين تنطلق، والخطوات الواجب القيام بها، وإلى أين تصل. أقصر طريق إلى شهادة CRA.
من أين تنطلق
برمجيتك، واختباراتها الآلية، وإصدار ستسلّمه.
إلى أين تصل
شهادة CRA لهذا الإصدار: متطلباته، واختباراته، وقائمة مكوّناته (SBOM)، وثغراته المعروفة، مختومة ويمكن لأيٍّ كان التحقق منها على qatrax.dev/verifier.
الخطوات الخمس
1. افتح فضاءك — إنشاء حساب: تجربة لعشرة أيام، دون بطاقة بنكية.
2. أنشئ مفتاحك — في فضائك: تبويب المشاريع، عمود مفاتيح CI. احفظه سرًّا؛ فهو صالح لمشروعك فقط.
3. مرة واحدة: متطلباتك — تبويب المتطلبات. ثلاثة مصادر يُجمع بينها: كتالوج CRA (الملحق الأول، زر استورد)، أو خطة اختباراتك (تبويب خطة التطوير والاختبار، زر تحقق واستورد)، أو نظام ALM لديك (Jira، Polarion: CSV أو ReqIF). تربط الخطة كل متطلب بالاختبارات التي تثبته: من دونها، لا يثبت الاختبار المستلَم شيئًا.
4. مع كل إصدار، أمر واحد — في مشروعك (Node.js):
npm i -D @mostajs/mjs-unit @mostajs/mjs-sbom # une fois
npx mjs-unit-menu # puis : 2 (SBOM) · 3 (compte rendu) · 4 (envoi)
للإرسال (الخيار 4)، ثلاثة متغيرات: QATRAX_URL (عنوان فضائك)، وQATRAX_CLE (مفتاحك)، وQATRAX_PROJET (مفتاح مشروعك). في التكامل المستمر، الثلاثة على التوالي: npx mjs-unit-menu --choix=2 && npx mjs-unit-menu --choix=3 && npx mjs-unit-menu --choix=4. Java، C#، Python، C++، Go…؟ تكفي قائمة SBOM وتقرير أداة الاختبار لديك كما هو — JUnit XML، NUnit، TRX، TestNG، Robot Framework، CTest، Cucumber، Behave، Allure، CTRF أو TAP: انظر QATrax دون Node.js.
5. الإصدار — في فضائك: تبويب SBOM/الثغرات، ابتّ في كل ثغرة (متأثر، غير متأثر، مُصلَح)؛ ثم تبويب المُسلَّم ← أصدِر واختم. تُختم الشهادة.
دون سطر أوامر: عبر الواجهة، تبويبًا تلو الآخر
التبويبات في أعلى كل صفحة من فضائك. اختر أولًا مشروعك والإصدار الذي تسلّمه.
| الخطوة | التبويب | ما تفعله | الزر |
|---|---|---|---|
| 1. البدء | المسار (الأول) | يعرض الخطوات الخمس لإصدارك وما ينقص كلًّا منها بعد. عُد إليه بعد كل خطوة. | — |
| 2. وضع متطلباتك (مرة واحدة) | المتطلبات — أو مباشرة كتالوج CRA وخطة التطوير والاختبار | استورد كتالوج CRA وخطة اختباراتك: فهي تحدّد أيّ اختبار يثبت أيّ متطلب. | استورد · تحقق واستورد |
| 3. إيداع تقرير الاختبارات | المسار، الخطوة ② — أو تبويب التنفيذات | اختر الملف الذي أنتجته اختباراتك: تقرير التحقق أو تقرير JSON من mjs-unit، أو JUnit XML، أو TAP، أو CTRF. | أودع النتائج |
| 4. إيداع SBOM | المسار، الخطوة ③ — أو تبويب SBOM/الثغرات | اختر ملف SBOM (CycloneDX أو SPDX، JSON) وحدّد الإصدار. | أودع SBOM (في الثغرات: أودع) |
| 5. البتّ في الثغرات | SBOM/الثغرات | بحث qatrax عن ثغرات قائمة SBOM لديك. لكل منها، اختر: متأثر، أو غير متأثر (مع السبب)، أو مُصلَح. | — |
| 6. إطلاق المعالجة | المُسلَّم | يجمع qatrax المتطلبات والاختبارات وSBOM والثغرات، ثم يعرض الحكم. اقرأه. إن ناسبك، فأصدِر. | أصدِر واختم |
| 7. استرجاع الشهادات | المُسلَّم، أسفل الصفحة: قائمة المُسلَّمات الصادرة | لكل مُسلَّم صادر رقمه وإصداره وحكمه. يُنزَّل بصيغة PDF موقَّع، وJSON مختوم، وشهادة HTML، ويمكن التحقق منه. | — |
| 8. الحصول على التوقيع | التوقيعات | مع باقة توقيعات: حدّد المُسلَّمات التي يختمها المزوّد المؤهَّل زمنيًا، ثم أكّد: تُخصم توقيعة واحدة عن كل مُسلَّم. تعود في الموقَّعة. | الإرسال إلى المزوّد المؤهَّل |
خلاصةً: المسار ← المتطلبات ← التنفيذات ← SBOM/الثغرات ← المُسلَّم. يحمل كل تبويب في أعلاه سطر مساعدة يعيدك إلى صفحة هذه الوثائق التي تشرحه.
افتراضيًا، يعرض الشريط تبويبات هذه الخطوات: المسار، المتطلبات، كتالوج CRA، التنفيذات، SBOM/الثغرات، المُسلَّم، الملف التقني، والإبلاغات. أما البقية (الاختبارات اليدوية، التوقيعات، المشاريع، الفريق، خطة التطوير والاختبار…) فهي تحت المزيد ▾. لتغيير موضع تبويب (في الشريط، أو تحت «المزيد»، أو مخفيًا) أو ترتيبها: ⚙ الإعدادات ← التبويبات، اختر موضعه، واسحبها (أو استعمل ↑ ↓)، ثم احفظ. الترتيب الافتراضي يعيد الترتيب؛ وإعادة كل شيء إلى الافتراضي يعيد أيضًا الشريط و«المزيد».
يضبط صاحب المساحة شريط المساحة كلها؛ ويستطيع كل عضو في الفريق ضبط شريطه، ثم العودة إلى شريط المساحة. ما يستطيع كل شخص تعديله يتوقف على دوره في المشروع (الفريق ← ما يستطيع كل دور فعله): القارئ يقرأ فقط.
التوقيع لدى مزوّد مؤهَّل. ملف PDF في الخطوة 7 موقَّع ومختوم زمنيًا من qatrax سلفًا. في الخطوة 8، تجعله يُختم زمنيًا، إضافةً إلى ذلك، لدى مزوّد خدمات الثقة المؤهَّل لدينا (eIDAS)، بفضل باقة توقيعاتك. تختار بنفسك الشهادات التي تُرسل؛ كل إرسال يخصم توقيعة واحدة، وإخفاق المزوّد يعيدها إليك. التفاصيل: التوقيعات والباقات.
ما تتوقعه
- لا يضيع شيء: يُسجَّل كل إرسال، حتى الناقص منه؛ ويُذكر ما ينقص بوضوح.
- إصدار واحد، ملف واحد: لا تُحتسب إلا اختبارات هذا الإصدار.
- ثغرات قائمة SBOM لديك يُبحث عنها فورًا، ثم كل يوم (قواعد OSV وNVD وCISA KEV وEUVD).
- الحكم، بكلمة واحدة:
| الحكم | معناه |
|---|---|
| مطابق | كل شيء مُثبت، ولا ثغرة معروفة قابلة للاستغلال |
| مطابق مع تحفظات | مُثبت، لكن ثمة نقاط يجب استكمالها (وهي مُدرجة) |
| غير مطابق | متطلب غير مُثبت، أو ثغرة مُعلنة قابلة للاستغلال |
| الحكم موقوف | ثغرة مستغلة فعليًا يجب البتّ فيها، أو وثيقة لا تتطابق (اختبارات معدَّلة، SBOM أخرى) |
سؤال؟ راسلنا من فضائك.