يمكنك قراءة نتائج الأمان واتخاذ إجراءٍ بشأنها من مساعد الدردشة، أو من مساعدك الخاص عبر CoRoid كخادم MCP: Claude Code، Codex، Cursor أو عميل MCP آخر. تتبع هذه الأدوات نفس قواعد البوابة، لذا فهي تقدم نفس الإجابات وترفض نفس الطلبات.
قراءة
لدى الأمان نطاقات خاصة به، لذا فإن الاتصال المُعد لعمل آخر لا
يعرض النتائج. تحتاج هذه الأدوات إلى دور المراجع و mcp.security.read. لا
حاجة لأي منها إلى موافقة. فهي تتبع قواعد أمان CoRoid نفسها: ترى المشاريع التي يمكنك رؤيتها في البوابة. يجب أن يحدد الاتصال المقيد ببعض المشاريع أحدها، أو نتيجة من إحداها.
| أداة | ما الذي ترد به |
|---|---|
get_security_overview | لكل مشروع: نتائج مفتوحة حسب درجة الخطورة، التي تجاوزت تاريخ إصلاحها، والادعاءات التي لم يؤكدها أحد، وكود الاختبار، وعدد ما ينتظرك للاطلاع عليه. |
list_security_findings | نتائج حسب المشروع، النوع، درجة الخطورة والحالة، أولاً حسب الاستغلال، ثم حسب الخطورة؛ needsYou تحفظ فقط تلك التي تنتظر موافقة شخصية. |
list_security_needs | القرارات التي تنتظر تدخل الشخص، مع إعطاء الأولوية للقرارات العاجلة، وكل قرار يتضمن إجابة من CoRoid ورابطًا للاطلاع عليها: وهي نفس القائمة الموجودة في قسم الأمان ← القرارات. |
get_security_finding | نتائج واحدة: مكانها، هل تم تأكيدها، متى يستحق إصلاحها، وعمل الإصلاح المطلوب. لا تُكشف قيمة السر أبداً. |
get_security_settings | كل حماية لمشروع تُطبق وفق الضوابط: معطلة، قيد المراقبة، مفعلة أو غير قابلة للتشغيل، وسبب ذلك، مع ما اختاره إعداد المشروع. |
list_security_runs | عمليات الأمان، بأحدثها أولاً، كما تسرد سجلات التشغيل: قيد التشغيل، في انتظار، مكتملة، فاشلة أو مستبدلة، وسبب فشل العملية. |
get_attack_surface | نقاط دخول كل مشروع وعدد ما ينتظر التعرض له؛ بالنسبة لمشروع واحد، كل نقطة دخول مع ما يظهره الكود وما قرره الأشخاص، واقتراحات النشر، وما اكتشفه حارس pull request. |
get_threat_model | إصدار نموذج التهديد لكل مشروع وما ينتظر المراجعة؛ بالنسبة لمشروع واحد، النموذج، الاقتراح المنتظر، وأحدث الإصدارات. |
list_security_packages | أحدث قوائم تبعيات كل مشروع مع عدد الحزم التي تُثبت وعددها المعرضة للخطر؛ بالنسبة لمشروع واحد، حزمه صفحة تلو الأخرى، مع إعطاء الأولوية للحزم المعرضة للخطر. |
كل نتيجة تربط بصفحتها في CoRoid.
التصرف بشأن النتائج
تتصرف هذه الأدوات بشأن النتائج. فهي تحتاج إلى mcp.security.write ومالك أو
مسؤول، كما في البوابة.
| أداة | ما الذي تفعله | موافقة |
|---|---|---|
start_security_fix | إصلاح، كما في البوابة: عمل إصلاح لتبعية معرضة للخطر، مهمة باختبار انحدار لنتيجة برمجية، قائمة تدقيق لتدوير بيانات اعتماد مكشوفة. إصلاح ثانٍ يرد على المهمة المقدمة مسبقاً. | لا |
run_security_scan | فحص مشروع واحد الآن: كل ما هو نشط، التبعيات، تاريخ السر، سطح الهجوم، التدقيق (حيث هو نشط) أو الأدلة المحفوظة. | لا |
confirm_real_secret | تأكيد أن بيانات الاعتماد المكشوفة حقيقية. تظل مفتوحة حتى يشهد أحدهم على تدويرها. | لا |
revoke_security_exception | إنهاء استثناء: تُفتح النتيجة مجدداً. | لا |
dismiss_security_finding | تحديد نتيجة بأنها ليست مشكلة، مع ذكر السبب. | دائماً |
add_security_exception | قبول مخاطرة النتيجة حتى تاريخ معين، مع ذكر السبب. | دائماً |
attest_secret_rotated | التصديق على تدوير أو إلغاء بيانات الاعتماد المكشوفة، مما يغلقها. لا تختبر CoRoid أبداً بيانات الاعتماد التي تجدها. | دائماً |
التصرف بشأن سطح الهجوم ونموذج التهديد
تحتاج هذه إلى mcp.security.write ومالك أو مسؤول أيضاً. حيث يعزز أحد عناصر التحكم في البوابة ويضعفه في آن واحد، توجد أداتان: الأداة التي تعزز ترفض تغييراً من شأنه أن يضعف، لذا يمر هذا التغيير دائماً
عبر الأداة التي تحتاج إلى موافقة شخصية.
| أداة | ما الذي تفعله | موافقة |
|---|---|---|
raise_entry_point_exposure | جعل نقاط الدخول أكثر عرضة للخطر، تثبيتها للتدقيق، أو إعادتها إلى نطاق التغطية. | لا |
lower_entry_point_exposure | جعل نقاط الدخول أقل عرضة للخطر، إزالة التثبيت، أو وضعها خارج نطاق التغطية مع ذكر السبب. | دائماً |
refresh_threat_model | قراءة كود المشروع مجدداً؛ ما تجده ينتظر كاقتراح. | لا |
add_threat_model_entries | إضافة مدخلات إلى نموذج التهديد | لا |
accept_threat_model_proposal | قبول ما اقترحه قراءة جديدة للكود | لا |
update_threat_model_entries | تغيير عنوان أو تفاصيل مدخل | دائماً |
remove_threat_model_entries | إزالة مدخلات من نموذج التهديد | دائماً |
dismiss_threat_model_proposal | رفض ما اقترحه قراءة جديدة للكود | دائماً |
keep_security_proof | حفظ دليل أعاد إنتاج النتيجة كاختبار انحدار لها. | لا |
تغيير الإعدادات الأمنية
إعدادات الحماية لمشروع معين أو للإعدادات الافتراضية للمؤسسة، في نفس الأداتين التاليتين: tighten_security_protection تقوي إعدادات الحماية وترفض أي تغيير يُضعفها، و relax_security_protection تُضعفها، أو تجعل المشروع يتبع الإعدادات الافتراضية للمؤسسة مرة أخرى، وتنتظر دائمًا تدخل شخص ما. يُعتبر التغيير مُضعفًا عندما يتم خفض مستوى الكشف أو الإنفاذ، أو عندما يرتفع عتبة الخطورة، أو عندما يقل عدد طلبات سحب الإصلاحات التي يمكن فتحها، أو عندما يتم إيقاف التدقيق أو تشغيله بشكل أقل تكرارًا، أو عندما يقرأ مسح السرية بيانات أقل، أو عندما يتم توسيع شبكة البيئة المعزولة أو السماح بمضيفين أكثر، أو عندما لا يعتبر نقطة الدخول "غير محددة" وجهةً متصلة بالإنترنت. يتم ضبط "أمر المسح الخاص بك" في قسم التحكم في الجودة.
جهات الاتصال والإفصاح عن المعلومات
تمتلك جهات اتصال الأمان في المشروع صلاحيات الإفصاح إلى جانب المالكين والمشرفين: حيث يمكنهم الاطلاع على إصلاحات الثغرات CoRoid الخاصة بالنتائج غير المكشوف عنها، ونشرها أو التخلص منها، وصياغة نشرات تحذيرية أمنية GitHub وتسجيل التقارير المرسلة إلى مُطوري المكتبات المستخدمة. من خلال بروتوكول MCP ووظيفة الدردشة، تُوجه هذه الطلبات إلى المالكين والمشرفين، وينتظر كل منها تدخل شخص ما: يمكن لجهة الاتصال الإفصاح عن النتائج، ولا يمكن التراجع عن عملية الإفصاح عن نتيجة ما.
| أداة | ما الذي تفعله | موافقة |
|---|---|---|
list_security_contacts | جهات اتصال الأمان في المشروع، ومن يمكن أن يكون واحدًا منها | لا |
get_security_disclosure | إصلاحات الثغرات الخاصة (حجمها وحالتها، دون محتواها)، ونشرة التحذير الأمني GitHub والتقارير المرسلة إلى المطورين، وذلك لصالح صاحب صلاحيات الإفصاح. | لا |
add_security_contact | تعيين أحد أعضاء المشروع كجهة اتصال أمنية | دائمًا |
remove_security_contact | إزالة جهة اتصال أمنية | دائمًا |
publish_private_fix | نشر إصلاح مؤجل: تصبح النتيجة مكشوفة عنها ويتم فتح مهمة pull request الخاصة بها. | دائمًا |
discard_private_fix | التخلص من إصلاح مؤجل | دائمًا |
draft_github_security_advisory | صياغة نشرة تحذير أمني GitHub في المستودع، تكون مرئية لمطوري المكتبة. | دائمًا |
record_maintainer_report | تسجيل مكان إبلاغك عن النتيجة لمطوري المكتبة المستخدمة. لا ترسل CoRoid أي بيانات. | دائمًا |
لماذا تنتظر بعض الإجراءات تدخل شخص ما؟
ليست مشكلة، بل مخاطرة مقبولة، وكذلك بيانات الاعتماد المتغيرة تُخرج نتيجة ما من القائمة المفتوحة دون إصلاح؛ كما أن نقطة الدخول الأقل تعرضًا ونموذج التهديد الأصغر يُخرجان شيئًا من نطاق تغطية التدقيق. لا ينبغي أن تتمكن المساعدة الذكية من فعل ذلك بمفردها، لذا تنتظر هذه الأدوات دائمًا تدخل شخص ما، بغض النظر عن إعدادات الاتصال:
- من عميل MCP، تنتظر الطلب تدخل مالك أو مشرف. إعدادات → اتصالات → خادم MCP الخاص بـ CoRoid → عمليات الموافقة، ويستلمون إشعارًا بذلك. تنتهي صلاحية الطلب بعد 10 دقائق.
- في وظيفة الدردشة، تطلب المساعدة الذكية منك التأكيد عبر الدردشة قبل تنفيذ الإجراء.
توضح الموافقة بعبارات واضحة ما سيحدث، استنادًا إلى سجل CoRoid الخاص بالنتيجة الأمنية:
"وضع علامة على ضعف التحكم في الوصول في src/routes/admin.ts:76 (متجر)
ليست مشكلة"، تليها الأسباب بين علامتي اقتباس. الكلمات المحيطة بالسبب تأتي من CoRoid، وليس من المساعدة الذكية، ولا تظهر قيمة بيانات الاعتماد أبدًا: فـ CoRoid لا تخزنها.