Настройка CSRF-защиты: токены, SameSite куки, валидация

Представьте: ваш сайт использует сессионные куки, и пользователь, будучи авторизованным, переходит по ссылке на злонамеренный сайт. Тот отправляет POST-запрос на изменение пароля — и без CSRF-токенов запрос проходит. Эта уязвимость входит в OWASP Top 10, и по статистике до 70% legacy-проектов не имеют никакой защиты. Мы часто встречаем эту боль на проектах, где защита либо отсутствует, либо реализована непоследовательно. Наша задача — навсегда закрыть эту уязвимость под ключ, с гарантией и документацией.

Проблемы, которые решаем

• Сессионные cookies автоматически прикрепляются браузером — злоумышленнику достаточно подсунуть жертве форму на своём домене. До 70% сайтов на устаревших фреймворках (например, PHP без фреймворка) не имеют никакой защиты.
• Некорректная настройка SameSite cookies — многие разработчики ставят None ради удобства, открывая дорогу CSRF. Мы фиксируем это и выбираем между Lax и Strict с учётом UX.
• Забывают про AJAX-запросы — SPA-приложения уязвимы, если не передавать CSRF-токен в заголовках. Мы настраиваем автоматическую передачу для Axios, Fetch, jQuery.

Как мы это делаем: кейс настройки Laravel Sanctum для SPA

Рассмотрим типичный проект: React-фронтенд на Next.js, бэкенд на Laravel с Sanctum. Клиент жалуется на ошибки 419 при отправке форм. Проблема: Sanctum использует паттерн Double Submit Cookie, но фронтенд не читал cookie XSRF-TOKEN.

Решение:

1. В Laravel config/sanctum.php указываем 'stateful' с доменами клиентов.
2. На фронтенде устанавливаем axios.defaults.withCredentials = true.
3. Читаем XSRF-TOKEN из cookie и передаём в заголовок X-XSRF-TOKEN:

// Axios interceptor axios.interceptors.request.use(config => { const token = document.cookie .split('; ') .find(row => row.startsWith('XSRF-TOKEN=')) ?.split('=')[1]; if (token) { config.headers['X-XSRF-TOKEN'] = token; } return config; }); 

Результат — 419 исчезли, безопасность обеспечена. Весь процесс занял 2 дня, включая тестирование.

Процесс работы

1. Аналитика — аудит текущей архитектуры: сессионная или токен-аутентификация, какие формы и API-эндпоинты защищать.
2. Проектирование — выбор методов: CSRF-токены, SameSite, Double Submit или комбинация. Определение исключений (webhooks).
3. Реализация — внедрение на бэкенде (middleware, генерация токенов) и фронтенде (глобальные настройки HTTP-клиента).
4. Тестирование — создание вредоносной страницы, проверка блокировки запросов, автоматизированные тесты.
5. Деплой — развёртывание на staging, проверка, мониторинг ошибок 419/403.

Что входит в настройку под ключ

• Интеграция CSRF-защиты во все мутирующие запросы (POST, PUT, DELETE).
• Настройка SameSite cookies с оптимальным значением.
• Обработка исключений (Stripe, GitHub webhooks) с альтернативной верификацией.
• Поддержка SPA (Sanctum, JWT) и классических форм.
• Документация по эксплуатации и обучение команды.
• Месяц послепусковой поддержки.

Сроки ориентировочно

Стоимость рассчитывается индивидуально под ваш стек и объём. Оценим проект за 1 день — свяжитесь для консультации.

Как выбрать между SameSite=Lax и Strict?

SameSite=Strict не отправляет cookie ни при каких кросс-сайтовых запросах — это безопасно, но ломает переходы с внешних ссылок (например, из email). SameSite=Lax разрешает отправку при GET-переходах, блокируя POST, что является компромиссом.

Наш опыт (более десяти лет внедрения) показывает, что Lax — выбор для 80% проектов. Если важен максимальный уровень, используем Strict с fallback-страницей для внешних ссылок.

Как защитить AJAX-запросы от CSRF?

Типичная ошибка: токен не обновляется после логина или истекает раньше сессии. Проверьте:

• Мета-тег генерируется в Blade (или аналоге) при загрузке страницы.
• Для SPA токен должен обновляться через cookie XSRF-TOKEN (Sanctum) или отдельный эндпоинт.
• Если используете @csrf в формах, убедитесь, что они не кешируются.

import axios from 'axios'; function App() { useEffect(() => { axios.get('/sanctum/csrf-cookie').then(() => { // токен уже в cookie XSRF-TOKEN }); }, []); const handleSubmit = async () => { await axios.post('/api/form', data); }; } 

public function handle($request, Closure $next) { $origin = $request->header('Origin'); if ($request->isMethod('POST') && $origin && !in_array($origin, $allowed)) { abort(403, 'Forbidden origin'); } return $next($request); }