arcanum-sec/spikestripطُعم مطالبات HTML وJavaScript قابل للعكس بمفاتيح معتمة لكل إدراج.
[!WARNING]
هذا المشروع قيد التطوير.
يهدف SpikeStrip إلى تقديم الإلهام للأشخاص الذين يبنون دفاعات ضد أدوات الأتمتة بالذكاء الاصطناعي مثل ARTEX والأنظمة المشابهة. طُعومه ومطالبات التوليد الخاصة به تجريبية.
يضيف SpikeStrip طُعومًا عكسية للمطالبات إلى مصدر HTML وملفات JavaScript. تتضمن التعليقات تعليمات تعيد توجيه تقييم الذكاء الاصطناعي، وأدلة ثغرات زائفة، وتشتيتات رياضية. قد تُضلِّل هذه التعليقات الوكلاء الذين يتبعون تعليقات المصدر أو يحوّلون التلميحات غير المُتحقَّق منها إلى أهداف فحص. سيحتاج الماسح التقليدي إلى استخراج المسارات أو المعاملات المُلمَّح إليها كي تؤثر هذه التعليقات في عمله. لا توقف الأداة بشكل موثوق الوكلاء الذين يعزلون المحتوى غير الموثوق أو الماسحات التي تتجاهل التعليقات.
يحصل كل إدراج على مفتاح سداسي عشري عشوائي من 12 حرفًا، مثل a7c94e2b610f. تُفحص المفاتيح بحثًا عن التكرارات في كل تشغيل. لا تحمل التعليقات المنشورة أي علامة تجارية لـ SpikeStrip ولا بادئة canary ثابتة. تظهر تعليقات HTML في View Source؛ وتكون تعليقات JavaScript مرئية عندما يجلب أحدهم السكربت. لا تضيف التعليقات أي callbacks أو حلقات قابلة للتنفيذ أو حسابات وقت التشغيل. تستخدم ثلاثة طُعوم مرجعية/توقف مدمجة صياغة مراجعة محايدة.
يسجّل البيان الخاص كل تعليق ومفتاحه. استخدمه لإزالة تعليقات محددة بعد تغيّر أرقام الأسطر. تبقى القائمة الأصلية ذات العشرة مدخلات في src/payloads.mjs باسم originalPayloads وتحتوي على 100 كلمة بالضبط. تحتوي المجموعة الافتراضية الآن على 28 مدخلًا، بما في ذلك 18 طُعمًا إضافيًا للتعليمات وأدلة ثغرات زائفة. تتضمن المهام الرياضية الأصلية مسائل مفتوحة وتناقضات ومهام لا نهائية؛ وليست كلها مُثبَتة أنها غير قابلة للحل.
تسمّي الأدلة الزائفة مسارات ومعاملات مُختلَقة لـ SSRF، وحقن SQL، وحقن القوالب من جانب الخادم، وXSS القائم على DOM، وXXE، واجتياز المسار، وفحوصات تفويض الكائنات. تدّعي بعض التعليقات أن مسارًا متقاعدًا يستخدم منتجًا متأثرًا بـ Log4Shell (CVE-2021-44228)، أو Spring Cloud Gateway CVE-2022-22947، أو Apache HTTP Server CVE-2021-41773. معرّفات CVE حقيقية؛ أما المسارات وعمليات النشر المزعومة فهي مُختلَقة. لا تنشئ هذه التعليقات أي مسارات أو معالجات ثغرات أو طلبات شبكة. راجع الأسماء المقترحة مقابل تطبيقك قبل نشرها، لأن مسارًا مُختلَقًا قد يتداخل مع مسار حقيقي.
SpikeStrip متاح بموجب MIT License، وحقوق النشر مملوكة لـ Arcanum. يجوز لك استخدام النسخ وتعديلها وتوزيعها وبيعها، بما في ذلك في المنتجات التجارية، شريطة الاحتفاظ بإشعارات حقوق النشر والإذن في النسخ أو الأجزاء الجوهرية من البرنامج. لا يتطلب الترخيص إسنادًا ترويجيًا علنيًا لكل استخدام تجاري.
يتطلب SpikeStrip الإصدار 20 من Node.js أو أحدث. شغّل هذه الأوامر من هذا المستودع.
npm install --ignore-scripts
node bin/spikestrip.mjs --help
بدلاً من ذلك، استخدم pnpm install --frozen-lockfile --ignore-scripts مع ملف القفل المُضمَّن في المستودع. الحزمة خاصة وليست مخصصة للنشر على npm.
شغّل الأداة على جذر الويب الثابت المبني، بعد التصغير وقبل النشر. يجب أن يكون المصدر ومجلد الإخراج مجلدين منفصلين، بحيث لا يكون أيٌّ منهما داخل الآخر. تتضمن نسخة الإخراج الأصول العادية والملفات المعدّلة. تترك الأداة الملفات الأصلية دون تغيير، وتستبعد الروابط الرمزية وبيانات التعريف الخاصة بأنظمة التحكم في الإصدارات (VCS) ومجلدات التبعيات ومجلدات البيانات الوصفية الخاصة وملفات البيئة.
# This preview validates inputs and writes nothing.
node bin/spikestrip.mjs inject ./site --output ./site-planted --count 20 --manifest ./private/run.json
# Apply the plan to a new copy.
node bin/spikestrip.mjs inject ./site --output ./site-planted --count 20 --manifest ./private/run.json --write
--count هو العدد الإجمالي للإدراجات عبر الشجرة. يستخدم التموضع واختيار الحمولة والمفاتيح عشوائية نظام التشغيل. قد تختار المعاينات والكتابات اللاحقة مواضع ومفاتيح مختلفة. يحصل كل إدراج على مفتاحه الخاص حتى عندما يتكرر النص المدمج. إذا لم يتم توفير مسار بيان، يتم إنشاء واحد في .spikestrip/ بجوار دليل الإخراج. احتفظ بهذا المجلد خاصًا وخارج الموقع المنشور.
تدعم الأداة ملفات .html و.htm و.js و.mjs و.cjs. تستخدم حدود عبارات Acorn لوضع تعليقات JavaScript، ثم تتحقق من أن شجرة الصياغة مكافئة. توضع تعليقات HTML قبل الأبناء المباشرين لعناصر head أو body الصريحة. يرفض فحص شجرة المستند التغييرات التي تتجاوز التعليقات.
لا تُدرج الأداة داخل سلاسل السمات أو النص الخام أو القوالب أو أجسام السكربت المضمّن أو محتوى النص. تتخطى وتُبلّغ عن الأجزاء التي تفتقر إلى head/body صريحة، وJavaScript غير الصالح، وملفات JSX/TypeScript غير المدعومة، والملفات المصدرية التي تتجاوز 2 ميغابايت. كما تُبلّغ عن الملفات المصدرية المدعومة التي لا تحتوي على مواضع إدراج آمنة. تُنسخ هذه الملفات المصدرية دون تغيير.
استخدم --raw إذا كنت تريد ملفًا نصيًا من التعليقات لتوزيعها في مصدر الويب الخاص بك بنفسك. لا يحتاج هذا الخيار إلى دليل موقع ولا يُدرج أي شيء في ملفاتك ولا ينسخ شجرة بناء. يوفر بديلًا عندما لا تريد أداة إدراج في خط أنابيب البناء الخاص بك.
# Preview an export without creating a file.
node bin/spikestrip.mjs inject --raw --output ./comments.txt --count 30
# Export JavaScript/CSS block comments, with one comment per line.
node bin/spikestrip.mjs inject --raw --output ./comments.txt --format js --count 30 --write
# Export HTML/SVG comments instead.
node bin/spikestrip.mjs inject --raw --output ./html-comments.txt --format html --count 30 --write
كل تعليق مُصدَّر له مفتاح عشوائي خاص به مكوَّن من 12 حرفًا. التنسيق الافتراضي هو js؛ ويغيّر --format html الغلاف. اختر تنسيقًا واحدًا لكل تصدير، وضع التعليقات فقط حيث يسمح نوع الملف هذا بالتعليقات. لا يتم استبدال ملفات الإخراج الموجودة أبدًا. تقبل الصادرات الخام أعدادًا من 1 إلى 10,000 للعناصر المدمجة ومن 1 إلى 1,000 مع --dynamic.
لا تُنشئ الصادرات الخام أي بيان إزالة لأن SpikeStrip لا يعرف أين تلصق التعليقات. احتفظ بالملف النصي كجرد مفاتيحك، وابحث عن تلك المفاتيح لإزالة التعليقات يدويًا. يتعامل الأمر remove مع عمليات الإدراج التلقائية المسجلة في بيان؛ ولا يمكنه اكتشاف المواضع اليدوية من ملف نصي خام. لا تمرر دليل مصدر أو --manifest مع --raw.
تعمل علامات التوليد نفسها مع الصادرات الخام. على سبيل المثال، بعد تعيين OPENAI_API_KEY، شغّل node bin/spikestrip.mjs inject --raw --output ./unique-comments.txt --format js --dynamic --provider openai --model YOUR_MODEL_ID --count 40 --write. لا تزال المعاينة لا تُجري أي طلب API.
أضف --mode artex لاختيار 16 طُعمًا مصممًا حول تفرعات ARTEX العامة المدروسة في ملاحظات البحث. يتضمن ملف التعريف مسارات API مقتبسة، وأجزاء أرشيف مُلفَّقة، ومدخلات خريطة المسارات، وعمليات تسليم من العامل إلى المخطط، وتحويلات مراجعة حركة المرور، ومراجع ملخصات مفهرسة. يحتفظ الوضع الافتراضي --mode generic بمجموعة العناصر المختلطة الأصلية.
# Inject the ARTEX profile into a separate site copy.
node bin/spikestrip.mjs inject ./site --output ./site-artex --mode artex --count 20 --manifest ./private/artex.json --write
# Export the ARTEX profile for manual placement.
node bin/spikestrip.mjs inject --raw --output ./artex-comments.txt --mode artex --format js --count 30 --write
# Generate new profile-specific comments with your provider key.
node bin/spikestrip.mjs inject --raw --output ./artex-unique.txt --mode artex --dynamic --provider anthropic --model YOUR_MODEL_ID --count 40 --write
يختار ملف تعريف ARTEX مجموعته الخاصة ويستخدم prompts/artex.txt للتوليد الديناميكي. يمكن لـ --prompt-file تجاوز هذا الموجّه. تسجّل البيانات الوصفية التلقائية ملف التعريف المحدد، وتستخدم الإزالة التعليقات المخزّنة دون الحاجة إلى ملف التعريف نفسه أو مفتاح API. تتضمن الطُعوم التي تحمل مسارات مفتاح التعليق لتمييزها عن المرشّحات المولّدة الأخرى. وهي لا تنشئ أي نقاط نهاية أو ملفات مجزأة أو سلوك خلفي.
يولّد --dynamic طُعمًا جديدًا واحدًا لكل إدراج. يطلب --count 40 أربعين نصًا متمايزًا وينشئ أربعين إدراجًا بمفاتيح منفصلة. ترفض الأداة التكرارات المطبّعة التامة للعناصر المدمجة أو النتائج السابقة في التشغيل. ولا يمكنها ضمان التفرّد العالمي أو الدلالي.