websec
детектор XSS на уровне символов
2 min readupdated
websec — компактная нейросеть на 1,96 млн параметров, которая по сырой строке оценивает, похожа ли она на XSS-payload (межсайтовый скриптинг). Модель сначала раскодирует URL и HTML до трёх раз, убирает NUL-байты и приводит текст к нижнему регистру, поэтому разные кодировки для неё выглядят одинаково. Обучена с нуля, без предобученной базы и токенизатора, и возвращает калиброванную вероятность и флаг is_xss по порогу 0,7278. Пригодится для триажа параметров запросов, полей форм, логов и пользовательского HTML: высокий score — повод проверить, но не доказательство атаки, а низкий не гарантирует безопасность.
Ключевые особенности
- Всего 1 959 361 параметр; один токен на символ, без внешнего токенизатора.
- Нормализация URL/HTML до трёх раз, удаление NUL, схлопывание пробелов и нижний регистр.
- Длинные строки режутся на окна по 1000 символов с шагом 500; учитывается максимальный score окна.
- На held-out: 98,9% пойманных атак и 0,07% ложных срабатываний; на внешнем SecLists — 97,7%.
- Это не WAF: score — свидетельство, а не доказательство; output encoding и CSP всё равно нужны.
Что можно сделать
- Прогонять параметры запросов и поля форм, чтобы подсветить подозрительные значения для ручной проверки.
- Проверять строки логов и пользовательский HTML на закодированные payload.
- Сравнивать свой фильтр с моделью: измерять, сколько encoded-атак он ловит, и подбирать порог под трафик.
- Собрать небольшой defensive-скрипт для security-пайплайна и не запускать модель по целым веб-страницам.
Пример
from huggingface_hub import hf_hub_download
import importlib.util
path = hf_hub_download('hareramray325/websec', 'xss_detector.py')
spec = importlib.util.spec_from_file_location('xss_detector', path)
xss_detector = importlib.util.module_from_spec(spec)
spec.loader.exec_module(xss_detector)
detector = xss_detector.XSSDetector.from_pretrained('hareramray325/websec')
detector.predict(['<b>hello</b>'])
Подробнее
Обучена с нуля за ~4 минуты на NVIDIA RTX 5050 Laptop GPU: 12 эпох, сохранена 9-я.Порог 0,7278 настроен на 0,1% ложных срабатываний.
На held-out — 98,9% атак и 0,07% ложных; внешний SecLists — 97,7%.
Ограничения: не WAF, не доказывает безопасность; кириллица и не-Latin огрублены; дедупликация только точная.










Comments