خدمة تبني المستودعات مفتوحة المصدر المسجَّلة في أجهزة افتراضية معزولة دون اتصال بالإنترنت وتفحصها بحثًا عن الثغرات الأمنية، وترسل النتائج عبر البريد الإلكتروني مع أدوات إعادة الإنتاج والتصحيحات المقترحة.
OSS Scanner هي خدمة من Anthropic لفحص المستودعات مفتوحة المصدر الحيوية بحثًا عن الثغرات الأمنية. تعرّف على المزيد حول الخدمة على red.anthropic.com/oss-scanner.
ملاحظة: يخضع استخدام هذه الأداة للشروط والأحكام الموضحة في شروط OSS Scanner.
سجّل مشروعًا مفتوح المصدر عبر فتح طلب سحب (pull request) يضيف دليلًا واحدًا:
projects/<name>
يقوم ماسح الأمان الخاص بنا ببناء مشروعك في جهاز افتراضي معزول، ثم يحلله دون الوصول إلى الإنترنت ويرسل ما يجده عبر البريد الإلكتروني إلى primary_contact (وأي CCs)، كل منها مع مُعيد إنتاج وتصحيح مقترح حيثما توفر. التقارير مُولّدة بواسطة النموذج ولا تتم مراجعتها من قبل إنسان. وبسبب ذلك لا نفرض فترة إفصاح مدتها 90 يومًا على هذه النتائج ولن نجعلها علنية. يجب على مالكي المشاريع توفير project.yaml (لتهيئة الماسح)، وDockerfile (يوضح كيفية بناء المشروع)، واختياريًا threat_model.md (يوفر نمذجة تهديدات خاصة بالمشروع)، وreport_guidelines.md وpatch_guidelines.md (يوضحان كيف تريد أن تبدو التقارير والتصحيحات).
ابدأ من templates/project.yaml:
repo: https://github.com/example/project # required: the git repository to scan; add #branch to pin one
primary_contact: [email protected] # required: reports and build problems go here (one address)
auto_ccs: # optional: more addresses on every mail
- [email protected]
homepage: https://example.org # optional
disabled: false # optional: true pauses reports without removing the enrolment
dockerfile: .oss-scanner/Dockerfile # required unless a Dockerfile sits in this repo next to your project.yaml
threat_model: .oss-scanner/threat_model.md # optional; also supports placing the file in this repository
# report_guidelines: .oss-scanner/report_guidelines.md # optional; the same
# patch_guidelines: .oss-scanner/patch_guidelines.md # optional; the same
repo وprimary_contact مطلوبان دائمًا. dockerfile مطلوب ما لم تُبقِ ملف Dockerfile الخاص بك بجوار project.yaml (انظر أدناه). البقية اختيارية.
عناوين البريد الإلكتروني في project.yaml عامة. استخدم عناوين يسعدك أن تُنشر، مثل اسم مستعار أمني.
لتلقي التقارير عبر البريد الإلكتروني مشفّرة، أضف مفتاحك العام OpenPGP بصيغة armored. عندئذٍ تُرسل إلى primary_contact فقط؛ لا يمكن الجمع بين pgp وauto_ccs:
pgp: |
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF...
-----END PGP PUBLIC KEY BLOCK-----
لتحديد مكان ذهاب التقارير، اضبط أدنى مستوى خطورة يستقبله كل قناة: low أو medium أو high أو critical أو none لإيقاف القناة. القناة التي تتركها خارج الإعداد تستخدم القيمة الافتراضية الموضحة هنا، والتقرير الذي يبلغ أو يتجاوز كلا الحدين الأدنيين يُرسل إلى كلتا القناتين. ينطبق pgp على البريد الإلكتروني فقط، لذا لا تُشفَّر تقارير GitHub بمفتاحك:
output_format:
email:
min_severity: low
github_security_advisory: # GitHub private vulnerability reporting
min_severity: none
لتفعيل تقارير GitHub، فعّل أولًا الإبلاغ الخاص عن الثغرات في مستودعك وأضف oss-scanner كمراسل موثوق. تدير Anthropic حساب oss-scanner، الذي تصدر منه تقاريرنا؛ وبدون ذلك، يحدّ GitHub من عدد التقارير التي يمكنه إرسالها إليك. نطلب منك تأكيد ذلك في طلب السحب الخاص بك قبل أن ندمجه.
يجب عليك توفير Dockerfile، في واحد فقط من مكانين:
dockerfile: على مساره (نقترح موقعًا مثل .oss-scanner/Dockerfile). هذا هو الخيار المفضل لأنه يتيح لك تحديث البناء دون طلب سحب هنا؛ أو،project.yaml، باسم projects/<name>/Dockerfile، دون ضبط مفتاح Dockerfile: في project.yaml. إذا كنت تفضل عدم إضافة ملفات إلى مستودعك، فضعها هنا وسيبنيها الماسح تمامًا كما يبني نسخة داخل المستودع.(يعمل نموذج التهديد بالطريقة نفسها. اضبط حقل threat_model لموقعه في مستودعك، أو ضعه هنا في projects/<name>/threat_model.md. وكذلك إرشادات التقارير وإرشادات التصحيحات، مع الحقلين report_guidelines وpatch_guidelines.)
الغرض من Dockerfile هو إعداد بيئتك، وتثبيت كل التبعيات، وبناء المشروع. يعمل الإعداد الأولي للمشروع مع تفعيل الوصول إلى الشبكة، لكن التدقيق الأمني بعده يعمل دون الوصول إلى الإنترنت. أي شيء يحتاجه البناء أو الاختبارات يجب جلبه أثناء إعداد Dockerfile الأولي. نوصي بالتحقق من نجاح اختباراتك داخل الصورة المبنية.
يتيح لك ملف threat_model.md (اختياري لكنه موصى به بشدة) تزويد الماسح بوثائق حول أهدافك الأمنية المقصودة. وجدنا أنه من المفيد أكثر تقديم إرشادات حول كيفية تقييمك لخطورة التقارير (على سبيل المثال، هل تعتبر SQLi بعد المصادقة عالية أم حرجة؟ هل تُحدّ تجاوزات المخزن المؤقت دون استغلالات مُثبتة عند درجة عالية؟ متى يكون XSS المخزّن متوسطًا أو عاليًا أو حرجًا؟) يمكن لهذا الملف أيضًا أن يوضح ما يفعله المشروع، ومن أين يدخل الإدخال غير الموثوق، وأي المكونات مهمة وأيها خارج النطاق، أو أي شيء آخر تعتبره مهمًا أو مفيدًا.
ملفان إضافيان (اختياريان لكنهما موصى بهما بشدة) يتيحان لك تحديد كيف تريد أن تبدو تقاريرنا وتصحيحاتنا:
report_guidelines.md مخصص لتنسيق كل تقرير: تخطيطه وأقسامه، وطوله، ونبرته، والحقائق التي يجب ذكرها.patch_guidelines.md مخصص لأسلوب كل تصحيح: على سبيل المثال، عدد التعليقات التي يجب كتابتها، وما إذا كان الإصلاح يجب أن يكون ضيقًا جدًا أم أعمّ، وأي الاختبارات يجب إضافتها، وأي منسّق (formatter) يجب استخدامه.ابدأ من templates/report_guidelines.md وtemplates/patch_guidelines.md. كلاهما نص عادي بحجم لا يتجاوز 16 KiB.
هذه الملفات تغيّر فقط كيفية كتابة التقارير والتصحيحات؛ أما ما هو داخل النطاق وكيف تقيّم الخطورة فينتمي إلى threat_model.md. يُفحص كل ملف تلقائيًا قبل استخدامه. أي ملف يحاول تغيير أكثر من ذلك، على سبيل المثال بحذف النتائج أو تشغيل أوامر غير ذات صلة، يُتجاهل بالكامل.
نقترح عليك تشغيل أمرين قبل فتح طلب سحب:
tools/validate.py من projects/<name>/ وفقًا للقواعد أعلاه.tools/check <name> مشروعك بالطريقة التي سيعمل بها ماسحنا، ويفتح صدفة في الصورة النهائية دون شبكة. إذا نجحت اختباراتك في هذه الحاوية، فمن المرجح أن يعمل ماسحنا مع مشروعك. يفعل tools/check --qemu <name> الشيء نفسه داخل أجهزة افتراضية مُهيأة مثل أجهزة الماسح.تحتاج هذه الأدوات إلى أن يكون مضيفك قد ثبّت git وDocker وPython 3 مع PyYAML (pip install pyyaml)؛ ويحتاج --qemu إلى Linux على x86-64 مع QEMU بدلًا من Docker.
primary_contact برسالة خطأ.primary_contact وأي مستلمين إضافيين في نسخة (CC) مع خطوات إعادة الإنتاج وترقيع مقترح حيثما توفر.يمكنك تعديل مشروعك في أي وقت عبر PR. لإلغاء تسجيل مشروعك، اضبط الحقل disabled على true لإيقاف التقارير مؤقتًا أو احذف projects/\<name\>/ لسحب المشروع بالكامل.
tools/check ملف Dockerfile الخاص بمشروعك مع وصول إلى الشبكة، كما يفعل docker build. مع --qemu يجري البناء داخل جهاز ظاهري، ما يبعده عن ملفاتك، لكنه يظل قادرًا على الوصول إلى الخدمات على حاسوبك وشبكتك المحلية. افحص فقط المشاريع التي تثق بها، أو استخدم جهازًا لا يوجد ما تخشى فقدانه عليه.tools/check أداة Claude Code في الصورة التي يبنيها (كما يفعل الماسح). تخضع أداة Claude Code لشروطها الخاصة.يُرجى زيارة red.anthropic.com/oss-scanner.