Ответ `200 OK` после входа ещё не означает, что сессия сохранена. Откройте login-запрос в DevTools и проверьте последовательно: есть ли `Set-Cookie` в ответе, появилась ли cookie в хранилище браузера и ушла ли она в заголовке `Cookie` следующего запроса. Эта цепочка сразу отделяет ошибку сервера от неверного Domain, Path, SameSite или настройки fetch.
Не лечите проблему отключением `Secure`, `HttpOnly` или SameSite для всего сайта. Эти атрибуты ограничивают кражу и нежелательную отправку сессионного идентификатора. Исправление должно соответствовать реальной схеме доменов: `app.example.com` → `api.example.com` и `app.example` → `api.other.example` требуют разных решений.
Три точки наблюдения дают точный диагноз
| Что видно | Что это значит | Следующая проверка |
|---|---|---|
| Set-Cookie отсутствует | backend не создал сессию или proxy удалил header | логи login и response headers на origin/proxy |
| Set-Cookie есть, cookie не сохранена | браузер отклонил атрибуты | Issues/Network: blocked reason |
| cookie сохранена, но не отправлена | URL не совпал с Domain/Path/Secure/SameSite | Request Cookies следующего запроса |
| cookie отправлена, ответ 401 | сессия не найдена/истекла на сервере | session store, key rotation, clock |
| работает в top-level, не работает через fetch | credentials/CORS | credentials include и точный Allow-Origin |
Снимок Application → Cookies полезен только вместе с URL запроса. Cookie может существовать, но быть неприменимой к конкретному host или path. В Network браузеры также показывают причину блокировки Set-Cookie; это надёжнее догадки по `document.cookie`, потому что `HttpOnly` cookie там специально не видна.
Атрибуты задают область отправки
Set-Cookie: __Host-session=RANDOM_OPAQUE_ID; Path=/; Secure; HttpOnly; SameSite=Lax
# __Host- означает: Secure, Path=/ и без Domain.
# Cookie остаётся привязана к точному host, который её установил.`Domain` расширяет область на указанный домен и его поддомены; если он не нужен, host-only cookie безопаснее. `Path` определяет URL-пути отправки, но RFC 6265 не считает Path границей безопасности. `Secure` разрешает передачу только по защищённому каналу. `HttpOnly` скрывает значение от JavaScript, но браузер всё равно прикладывает его к подходящему fetch.
- Для одной host-сессии используйте префикс `__Host-`, `Secure`, `HttpOnly`, `Path=/` и не задавайте Domain.
- Для общего входа поддоменов задайте минимально необходимый Domain и префикс `__Secure-`.
- Проверьте, не удаляет ли cookie ответ с тем же name/domain/path и `Max-Age=0`.
- Не храните токен сессии в диагностических скриншотах и логах; замените значение маской.
- Согласуйте время сервера, если используется Expires; при наличии Max-Age он имеет приоритет.
Cross-origin fetch требует согласия обеих сторон
У `fetch` значение credentials по умолчанию — `same-origin`. Для cross-origin запроса браузер примет и отправит cookie только при `credentials: "include"`. API в ответе указывает конкретный разрешённый Origin и `Access-Control-Allow-Credentials: true`; wildcard `*` несовместим с credentialed response.
await fetch('https://api.example.net/session', {
method: 'POST',
credentials: 'include',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({email, password})
});
// Ответ API:
// Access-Control-Allow-Origin: https://app.example.com
// Access-Control-Allow-Credentials: true
// Vary: OriginЕсли frontend и API действительно cross-site, cookie обычно нужна с `SameSite=None; Secure`. Это повышает риск CSRF, поэтому одного CORS недостаточно: защищайте изменяющие запросы CSRF-токеном или другим подходящим механизмом и проверяйте Origin. Для same-site поддоменов сначала разберитесь с host/domain — без необходимости не расширяйте SameSite.
Локальная разработка должна повторять схему production
Расхождение часто появляется из-за `localhost`, IP и HTTPS. Cookie с Domain production-домена не может установиться для localhost, а `Secure` требует защищённого контекста. Удобнее поднять локальные имена и TLS либо настроить dev-proxy, чтобы браузер видел same-origin маршрут, чем добавлять небезопасное условие, которое случайно попадёт в production.
| Среда | URL приложения | URL API | Что тестировать |
|---|---|---|---|
| production | https://app.example.com | https://api.example.com | Domain/SameSite и TLS |
| dev proxy | https://app.test | https://app.test/api | host-only cookie и proxy headers |
| разные local ports | http://localhost:3000 | http://localhost:8080 | CORS/credentials, но не production Secure |
| embedded iframe | чужой top-level site | ваш auth origin | third-party cookie policy и отдельный flow |
Контрольный прогон закрывает всю цепочку
- Очистить только тестовую cookie и выполнить один login без расширений и старых service workers.
- Убедиться, что ответ содержит один ожидаемый Set-Cookie без конфликтующего дубликата.
- Проверить stored cookie: host/domain, path, Secure, HttpOnly, SameSite и срок.
- Выполнить запрос профиля и найти cookie в Request Headers, не раскрывая значение.
- Перезагрузить вкладку и повторить запрос, если сессия должна переживать reload.
- Повторить сценарий в production-like HTTPS и в поддерживаемых браузерах.
- Проверить logout: сервер инвалидирует сессию, а браузер удаляет cookie с теми же name/domain/path.
Для следующего разбора достаточно HAR без секретных значений, двух URL, response `Set-Cookie`, blocked reason и настроек CORS. По этим данным видно, где оборвалась цепочка. Готовый результат — не просто наличие cookie в списке, а успешный авторизованный запрос после reload и корректное завершение сессии.