Как избежать CORS-ошибок при запросах к API

Вы запустили SPA на React 18, а API живёт на Laravel 11 на другом поддомене. Локально всё работает благодаря proxy, но в продакшене браузер выбрасывает в консоль: «CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource». Знакомая проблема? Без корректной настройки CORS любой запрос с фронтенда к API будет заблокирован. Мы покажем, как решить эту проблему надёжно и безопасно, с учётом реальной инфраструктуры.

Типичная ситуация: фронтенд на Next.js 14 делает POST-запросы с Content-Type: application/json к бэкенду на Django. Без правильной обработки preflight-запроса (OPTIONS) браузер не пропустит основной запрос. Разработчики часто забывают настроить сервер на приём OPTIONS и возврат корректных заголовков. Это приводит к часам отладки и поиска проблемы в неверном месте.

CORS доставляет столько хлопот из-за preflight-запросов, ограничений на wildcard при использовании credentials и необходимости динамической проверки источников. Разберём базовые принципы и перейдём к практике.

Как различаются простые и preflight-запросы?

Если сервер не отвечает на OPTIONS корректными заголовками, браузер не отправит основной запрос.

Как настроить CORS для нескольких доменов с поддержкой credentials?

Допустим, у вас три фронтенда: продакшен (app.example.com), стейджинг (staging.example.com) и админка (admin.example.com). Access-Control-Allow-Origin: * не подходит, если используются credentials. Решение — динамическая проверка через map в Nginx.

map $http_origin $cors_origin {
    default "";
    ~^(https?://(app|staging|admin)\.example\.com)$ $1;
}

server {
    location /api/ {
        if ($request_method = 'OPTIONS') {
            add_header Access-Control-Allow-Origin $cors_origin;
            add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS";
            add_header Access-Control-Allow-Headers "Authorization, Content-Type, X-Requested-With";
            add_header Access-Control-Max-Age 86400;
            return 204;
        }
        add_header Access-Control-Allow-Origin $cors_origin always;
        add_header Access-Control-Allow-Credentials true always;
        proxy_pass http://backend;
    }
}

Такой подход гарантирует, что запросы примутся только с белого списка. В современных версиях Laravel аналогично:

// config/cors.php
return [
    'paths' => ['api/*'],
    'allowed_methods' => ['*'],
    'allowed_origins' => [
        'https://app.example.com',
        'https://staging.example.com',
        'https://admin.example.com'
    ],
    'allowed_headers' => ['Authorization', 'Content-Type', 'X-Requested-With'],
    'exposed_headers' => ['X-Total-Count'],
    'max_age' => 86400,
    'supports_credentials' => true,
];

Динамическая проверка через map работает в 2 раза быстрее, чем использование регулярных выражений в if-блоке. Это существенно при высоких нагрузках.

Недавно клиент с тремя фронтендами (prod, staging, admin) столкнулся с тем, что API не принимал запросы с Admin-панели. После аудита выяснили: в конфиге стоял Access-Control-Allow-Origin: *, но браузер блокировал credentials. Мы реализовали динамический whitelist через map — проблема решилась за 2 часа. Клиент сэкономил 8 часов самостоятельной отладки.

Почему браузер блокирует запросы с credentials?

Если API использует cookie-сессии или токены в куках, браузер требует:

• Access-Control-Allow-Credentials: true
• Access-Control-Allow-Origin не может быть * — только конкретный домен
• На фронтенде credentials: 'include' (fetch) или withCredentials: true (Axios)

Даже если всё настроено, запрос может быть заблокирован, если origin в списке не совпадает по протоколу (HTTP vs HTTPS). Мы гарантируем, что после настройки CORS ваше API будет работать корректно со всеми разрешёнными источниками.

Типичные ошибки и их решения

Что входит в работу

• Аудит текущей конфигурации (Nginx/Apache, бэкенд)
• Настройка CORS-заголовков с учётом ваших доменов и методов
• Обработка preflight-запросов
• Поддержка credentials (куки, авторизация)
• Документация по разрешённым источникам и политике
• Тестирование через curl и браузерные инструменты

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

1. Аналитика — изучаем архитектуру: где живёт фронтенд, какие методы использует, нужны ли куки.
2. Проектирование — составляем whitelist origins, список методов и заголовков.
3. Реализация — правим конфиг сервера и/или код бэкенда.
4. Тестирование — проверяем простые и сложные запросы, credentials, ошибочные ответы.
5. Деплой — применяем настройки на продакшен, мониторим логи.

Сроки и стоимость

Базовая настройка CORS для типового проекта занимает от 2 до 4 часов. Для проектов с большим количеством доменов или нестандартными требованиями сроки обсуждаются индивидуально. Стоимость рассчитывается индивидуально в зависимости от сложности инфраструктуры и количества доменов.

Наш опыт — более 7 лет, 50+ проектов с CORS-конфигурацией. Мы поможем избежать типичных ошибок и сэкономим вам время. Закажите настройку — и забудьте о кросс-доменных ошибках. Получите консультацию по вашей конфигурации — напишите, мы поможем.

Документация по CORS на MDN: https://developer.mozilla.org/ru/docs/Web/HTTP/CORS

Безопасность веб-приложений: HTTPS, CSP, XSS, CSRF, WAF, защита от DDoS

Взлом сайта редко выглядит как в кино. Чаще это: бот нашёл endpoint /admin/export без авторизации, скачал базу клиентов, закрыл соединение. Или: через устаревший плагин WordPress залил веб-шелл, теперь сервер рассылает спам. Или тише: XSS в поле комментария позволяет красть session cookies администраторов, и никто не замечает месяцами. Мы такие случаи разбирали десятками — каждый раз уязвимость можно было закрыть на этапе разработки или аудита.

Безопасность веб-приложений — не одна настройка. Это слои защиты, каждый из которых закрывает отдельный класс атак. Закажите аудит — оценим проект и дадим план работ под ключ за 2–4 недели.

HTTPS и правильная конфигурация TLS

HTTPS — минимальный обязательный уровень. Но «есть SSL-сертификат» и «правильно настроен TLS» — разные вещи.

В конфигурации Nginx/Apache проверяем:

• Протоколы: только TLS 1.2 и TLS 1.3, SSLv3 и TLS 1.0/1.1 — отключены
• Cipher suites: предпочитать ECDHE (Forward Secrecy), убрать NULL, RC4, DES, 3DES
• HSTS (Strict-Transport-Security: max-age=31536000; includeSubDomains; preload) — браузер больше не делает незащищённых запросов
• OCSP Stapling — ускоряет проверку отзыва сертификата
• Redirect 301 с HTTP на HTTPS — и в конфиге сервера, и в коде (двойной редирект = потеря SEO-веса)

Проверка: SSL Labs (ssllabs.com/ssltest) должен показывать A или A+. Если B — конфигурация слабая.

Let's Encrypt + Certbot для продакшена — стандарт. Автоматическое обновление через certbot renew в cron. Wildcard-сертификат для поддоменов через DNS-01 challenge.

Content Security Policy: самая мощная и самая сложная защита

CSP — HTTP-заголовок, который говорит браузеру, откуда разрешено загружать ресурсы. Правильно настроенный CSP полностью блокирует большинство XSS-атак, даже если уязвимость есть в коде.

Проблема: сломать сайт неправильным CSP проще простого. default-src 'none' — и перестают работать шрифты, картинки, JS. Поэтому начинаем с Content-Security-Policy-Report-Only — CSP логирует нарушения, но ничего не блокирует. Смотрим репорты 2–4 недели, дорабатываем политику, потом переключаем на боевой режим.

Пример реальной политики для сайта с Google Analytics, Google Fonts и Stripe:

Content-Security-Policy:
  default-src 'self';
  script-src 'self' https://www.googletagmanager.com https://js.stripe.com 'nonce-{random}';
  style-src 'self' https://fonts.googleapis.com 'unsafe-inline';
  font-src 'self' https://fonts.gstatic.com;
  frame-src https://js.stripe.com;
  img-src 'self' data: https://www.google-analytics.com;
  connect-src 'self' https://api.stripe.com https://www.google-analytics.com;
  report-uri /csp-report;

nonce — случайная строка, генерируется на сервере для каждого запроса. Inline-скрипты с правильным nonce разрешены, без nonce — заблокированы. Это ломает XSS через <script>alert(1)</script> полностью.

'unsafe-inline' в style-src — компромисс для inline-стилей. Лучше убрать, перенеся все стили в CSS-файлы, но это требует рефакторинга.

Почему XSS остаётся самой частой уязвимостью?

XSS (Cross-Site Scripting) — инъекция JS-кода через пользовательский ввод. По статистике OWASP, XSS входит в топ-3 уязвимостей веб-приложений. Три типа:

Защита: никогда не вставлять пользовательский ввод в HTML без эскейпинга. В PHP — htmlspecialchars() с ENT_QUOTES. В Blade-шаблонах Laravel — {{ $var }} безопасен, {!! $var !!} — опасен. В React — {variable} безопасен, dangerouslySetInnerHTML — опасен. Для Rich Text — htmlpurifier на PHP или DOMPurify в браузере.

CSRF: защита форм и API

CSRF (Cross-Site Request Forgery) — злоумышленник заставляет браузер жертвы отправить запрос от её имени. Пример: пользователь авторизован в банке, открывает вредоносную страницу, она делает fetch('https://bank.ru/transfer?to=evil&amount=50000') — если банк не защищён, деньги уходят.

CSRF-токены — стандартная защита для форм: сервер генерирует случайный токен, хранит в сессии, вставляет в форму как hidden field. При POST-запросе токен сверяется. Злоумышленник не знает токен. Laravel делает это автоматически через @csrf.

SameSite cookies — современная защита: SameSite=Strict или SameSite=Lax запрещает браузеру отправлять cookie в cross-site запросах. Работает во всех современных браузерах.

API без сессий (JWT, Bearer tokens) — CSRF неактуален, если токен не хранится в cookie (а в Authorization header или localStorage). Но localStorage уязвим к XSS — поэтому для чувствительных данных предпочтительны HttpOnly cookies с SameSite.

WAF и защита от DDoS

WAF (Web Application Firewall) — фильтрует HTTP-трафик на предмет атак: SQL injection, XSS, path traversal, известные exploit patterns. Варианты:

• Cloudflare WAF — облачный, правила OWASP Top 10 из коробки, кастомные правила через выражения. Managed Rules автоматически блокируют новые угрозы.
• ModSecurity (Nginx/Apache) — self-hosted, OWASP Core Rule Set (CRS). Гибко, но требует настройки и мониторинга ложных срабатываний.
• AWS WAF — для инфраструктуры на AWS, интегрируется с CloudFront и ALB.

DDoS-защита. Cloudflare на уровне L3/L4/L7 — де-факто стандарт для большинства сайтов. Автоматическое смягчение volumetric атак, Under Attack Mode при активной атаке. Для критичной инфраструктуры — Cloudflare Magic Transit или специализированные решения (Qrator, StormWall для российского рынка).

Rate Limiting на уровне приложения — дополнительный слой. Laravel ThrottleRequests middleware: 60 запросов в минуту на IP для общих endpoint, 5 — для /login и /password/reset. Redis как хранилище счётчиков — обязательно для горизонтально масштабируемых систем (иначе лимиты не синхронизируются между серверами).

Другие обязательные меры

Заголовки безопасности. Помимо CSP: X-Frame-Options: DENY (защита от clickjacking), X-Content-Type-Options: nosniff (MIME sniffing), Referrer-Policy: strict-origin-when-cross-origin, Permissions-Policy (ограничение доступа к API браузера: камера, микрофон, геолокация).

SQL injection. Prepared statements везде. Никаких конкатенаций пользовательского ввода в SQL-строки. ORM (Eloquent, Doctrine) защищает по умолчанию. $wpdb->prepare() в WordPress — обязательно.

Обновления зависимостей. composer audit и npm audit — в CI/CD пайплайн. Dependabot или Renovate для автоматических PR с обновлениями. Критичные CVE — патчить в течение 24 часов.

Секреты и конфигурация. .env — никогда в Git. Секреты в production — через переменные окружения CI/CD (GitHub Secrets, GitLab CI Variables) или HashiCorp Vault. Проверка на утечки: git-secrets, truffleHog в pre-commit hooks.

Как мы работаем

1. Аудит — сканирование кода, конфигураций, зависимостей, ручная проверка бизнес-логики.
2. Проектирование — план устранения уязвимостей, подбор стека (CSP, WAF, rate limiting).
3. Реализация — настройка TLS, CSP, заголовков, внедрение Rate Limiting, WAF.
4. Тестирование — повторный пентест, нагрузочное тестирование, проверка ложных срабатываний.
5. Деплой и мониторинг — включение боевого CSP, настройка алертов, обучение команды.

Что входит в работу

• Отчёт с найденными уязвимостями и рекомендациями (PDF + code snippets)
• Готовая конфигурация TLS (Nginx/Apache)
• Политика CSP с режимом Report-Only и боевой версией
• Настройка WAF и Rate Limiting
• План обновлений зависимостей
• Доступы к инструментам мониторинга (Sentry, Datadog)
• 30 дней постаудит-поддержки (консультации, правки)

Сроки и стоимость

Бюджет рассчитывается индивидуально — напишите нам, чтобы оценить проект.