Как браузер отправляет cookies и credentials?
На этой странице
Browser отправляет cookies автоматически, если совпадают правила cookie и настройки request. Для fetch на cross-origin запросах важно явно указать credentials: 'include', а server должен корректно настроить CORS.
Вопрос
Когда браузер отправляет cookies в fetch? Что делают режимы credentials и что должен вернуть сервер для cross-origin запроса с cookies?
Same-origin request
Если frontend и API на одном origin:
https://app.example.com -> https://app.example.com/api/meBrowser обычно отправит подходящие cookies автоматически.
Cross-origin request
Если frontend и API на разных origins:
https://app.example.com -> https://api.example.com/meДля fetch нужно:
fetch('https://api.example.com/me', {
credentials: 'include',
});Без этого browser может не отправить cookies в cross-origin request.
Что должен вернуть server?
Access-Control-Allow-Origin: https://app.example.com
Access-Control-Allow-Credentials: trueЕсли используются credentials, нельзя ставить:
Access-Control-Allow-Origin: *Нужно указать конкретный origin.
Credentials - это не только cookies
В browser context credentials могут включать:
- cookies;
- TLS client certificates;
- HTTP authentication credentials.
Bearer token в Authorization header ты обычно добавляешь вручную, но CORS все равно может потребовать preflight.
Что важно помнить
- У
fetchтри режима:omit(никогда),same-origin(по умолчанию, только свой origin) иinclude(всегда). - В axios аналог —
withCredentials: true, в XHR —xhr.withCredentials = true. - Даже с
credentials: 'include'cookie не уйдет, если ее не пропускают атрибутыSameSite,Secure,Domainили блокировка third-party cookies. - Ответ без
Access-Control-Allow-Credentials: trueбудет заблокирован для JS, хотя сервер мог уже выполнить запрос.
Мини-шпаргалка
- Browser сам решает, какие cookies подходят request.
- Для cross-origin
fetchс cookies нуженcredentials: 'include'. - Server должен вернуть
Access-Control-Allow-Credentials: true. - С credentials нельзя использовать wildcard
*для allowed origin. SameSite=NoneтребуетSecure.
Документация
MDN: Request.credentials, MDN: Access-Control-Allow-Credentials.