401 Unauthorized
5 минут на чтение
Ошибка 401 Unauthorized
Для доступа нужна аутентификация: логин и пароль, токен или cookie. Либо переданные данные не приняты.
Частые причины
- Не переданы или истекли учётные данные (токен, cookie, сессия).
- Basic Auth включён, но логин или пароль неверные.
- Токен API отозван или истёк.
- Смена домена: cookie остались на старом хосте.
Диагностика
- Проверьте, какие заголовки авторизации отправляются.
- Проверьте срок жизни токена и cookie (Secure, Domain, SameSite).
- Проверьте ответ с валидными и невалидными данными.
- Сравните поведение из браузера и с сервера.
Как исправить
| Кто | Действие |
|---|---|
| Владелец сайта | Уточните, у всех ли пользователей ошибка или только после смены пароля/домена. |
| Разработчик | Проверьте выдачу и обновление токенов, настройки cookie и CORS. |
| Администратор | Проверьте правила Basic Auth и не блокирует ли прокси заголовок Authorization. |
Как не допустить повторения
- Мониторинг закрытых разделов с тестовой учётной записью.
- Ротация токенов и понятные ошибки авторизации.
- Проверка после смены домена или SSO.
Частые вопросы
401 и 403 — в чём разница?
401 — аутентификация не пройдена, 403 — пройдена, но прав нет.
Почему 401 появляется только в API?
Скорее всего, истёк токен или не передан заголовок Authorization.
Можно ли мониторить закрытый раздел?
Да, с тестовой учётной записью и отдельным объектом.