Как написать отчёт, который примут с первого раза
Самая частая причина, по которой хороший отчёт возвращают на доработку, — не сама находка, а то, как она описана. Триажер читает десятки отчётов в день, и ему нужно за минуту понять, что произошло и почему это важно.
1. Заголовок — это уже половина отчёта
Хороший заголовок отвечает на три вопроса: что за уязвимость, где она находится и к чему приводит. Не «XSS на сайте», а «Хранимая XSS в комментариях профиля позволяет выполнить код в сессии администратора».
2. Шаги воспроизведения
Пишите так, будто их будет выполнять человек, который впервые видит сервис. Нумерованный список, конкретные адреса и параметры, ожидаемый и фактический результат.
3. Влияние
Объясните, что может сделать злоумышленник и кого это затронет. Без преувеличений: завышенная оценка подрывает доверие ко всему отчёту.
4. Рекомендации
Короткая подсказка, как исправить, показывает, что вы понимаете причину, а не просто нашли симптом.