وثائق

الأمان عبر MCP والدردشة

اقرأ النتائج واتخذ إجراءً بشأنها من خلال الدردشة أو مساعدك الخاص، مع اتباع قواعد البوابة، واعرف لماذا تنتظر بعض الإجراءات موافقة شخصية دائمًا.

يمكنك قراءة نتائج الأمان واتخاذ إجراءٍ بشأنها من مساعد الدردشة، أو من مساعدك الخاص عبر 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 لا تخزنها.