auth_jwt_loginurl
Директива `auth_jwt_loginurl` задаёт URL для перенаправления в случае, если проверка JWT не прошла.
Описание
Директива auth_jwt_loginurl является частью модуля аутентификации JWT для NGINX, который предоставляет механизм защиты локаций NGINX с помощью JSON Web Tokens. При включённой проверке эта директива определяет конечную точку, на которую будут перенаправляться пользователи, если они пытаются получить доступ к защищённому ресурсу без действительного JWT или если их JWT не проходит проверку. Перенаправление происходит только в том случае, если директива auth_jwt_redirect установлена в 'on'.
Значение директивы auth_jwt_loginurl должно быть корректным URL, указывающим на страницу входа или аутентификации, где пользователи могут получить новый JWT. Её можно настроить на уровнях http, server или location, что даёт гибкость в том, как и где применяется аутентификация в конфигурации NGINX. Установка этой директивы улучшает пользовательский опыт, обеспечивая перенаправление на соответствующую страницу для входа и получения действительных учётных данных в случае неудачной аутентификации.
Для реализации этой функциональности директива работает в сочетании с несколькими другими директивами, связанными с JWT, такими как auth_jwt_enabled для включения/отключения проверки JWT и auth_jwt_redirect для активации перенаправления. Без правильной настройки этих директив попытки задать auth_jwt_loginurl не приведут к ожидаемому результату и могут вызвать непонимание причин отказа в аутентификации при обработке запросов пользователей.
Пример конфига
location /protected {
auth_jwt_enabled on;
auth_jwt_redirect on;
auth_jwt_loginurl /login;
auth_jwt_key my_secret_key;
}Убедитесь, что auth_jwt_redirect установлен в 'on' для выполнения перенаправления; в противном случае директива не будет иметь эффекта.
Указанный URL должен быть доступен и правильно настроен для обработки запросов аутентификации.
Эту директиву можно разместить в нескольких контекстах (http, server, location); учитывайте, где она задана, поскольку это может повлиять на её работу.