Перейти к содержимому
Учи.Онлайн Выбрать школу
Статья

Spring Security: как закрыть Java-приложение логином, ролями и токенами и не сломать доступ

Spring Security — модуль экосистемы Spring, который встаёт цепочкой фильтров перед контроллерами и для каждого запроса решает три вопроса: кто пришёл, что ему можно и не подделан ли запрос. Разработчик описывает правила в бине SecurityFilterChain: какие адреса открыты, каким ролям доступны остальные, как проверять пароль или JWT-токен. Для уверенной работы нужно понимать порядок фильтров, хранение паролей через PasswordEncoder, разницу роли и права, CSRF, режим ресурс-сервера OAuth2 и тесты на отказ в доступе.

Автор: редакция Учи.ОнлайнОтветственный редактор: Дмитрий Игнатьев
Содержание
Иллюстрация к статье: Spring Security: как закрыть Java-приложение логином, ролями и токенами и не сломать доступ

Первое, что удивляет после подключения стартера, — приложение закрывается целиком. Spring Boot создаёт одного пользователя user, печатает его пароль в журнал запуска и требует вход на любом адресе, включая те, что должны быть публичными. Подключить модуль легко, труднее решить, кому что открыть, и доказать это тестами.

Что происходит с запросом до контроллера

Запрос попадает в фильтр сервлетного контейнера DelegatingFilterProxy, а тот передаёт его бину FilterChainProxy. Цепочек SecurityFilterChain может быть несколько, и к запросу применяется первая, чей шаблон адреса совпал: так уживаются цепочка для /api/** с токенами и цепочка для страниц с формой входа.

Новичку важны четыре звена. Фильтр CSRF сверяет токен у изменяющих запросов. Фильтры аутентификации разбирают форму входа, заголовок Authorization или сессию и кладут результат в SecurityContext. ExceptionTranslationFilter превращает исключения в ответы: аноним получает 401 или перенаправление на вход, вошедший без прав — 403. Последним AuthorizationFilter сверяет запрос с правилами. Если вместо 401 пришёл 403, ищите, какой фильтр сработал раньше.

SecurityFilterChain вместо WebSecurityConfigurerAdapter

Многие учебные материалы начинаются с класса, унаследованного от WebSecurityConfigurerAdapter. Команда Spring объявила его устаревшим в версии 5.7.0-M2 и предложила вместо него бин SecurityFilterChain (блог Spring, 21 февраля 2022 года). В ветке 6.x класса нет, и код из старого видео не скомпилируется. Актуальная конфигурация:

@Bean
SecurityFilterChain api(HttpSecurity http) throws Exception {
    http.authorizeHttpRequests(auth -> auth
            .requestMatchers("/actuator/health").permitAll()
            .requestMatchers("/admin/**").hasRole("ADMIN")
            .anyRequest().authenticated())
        .httpBasic(Customizer.withDefaults());
    return http.build();
}

Правила проверяются сверху вниз до первого совпадения. Если поставить anyRequest().authenticated() выше строки про /admin/**, админка откроется любому вошедшему пользователю, причём без единого предупреждения. Узкие правила пишут первыми.

Пароли: PasswordEncoder, BCrypt и предел длины

Пароль хранят в виде хеша, а сверяет его PasswordEncoder. Рекомендуемый DelegatingPasswordEncoder пишет хеш в формате {id}хеш, например {bcrypt}$2a$10$…, и по метке выбирает алгоритм. Если в базе остались строки без метки, вход упадёт с ошибкой There is no PasswordEncoder mapped for the id "null" (документация Spring Security о хранении паролей). Стоимость BCrypt по умолчанию — 10, а подбирать её советуют так, чтобы проверка пароля занимала около секунды.

У BCrypt есть малоизвестный предел: он учитывает только первые 72 байта пароля. В бюллетене CVE-2025-22228 от 19 марта 2025 года команда Spring признала уязвимость высокой опасности: метод BCryptPasswordEncoder.matches возвращал true для пароля длиннее 72 символов, если совпадали первые 72. Исправление вошло в версии 6.4.4 и 6.3.8. Теперь кодировщик отказывается хешировать слишком длинный пароль и бросает IllegalArgumentException, а предел считается в байтах UTF-8, не в символах (обсуждение в репозитории Spring Security). Буква кириллицы занимает два байта, поэтому парольная фраза из 37 русских букв уже не пройдёт регистрацию. Ограничьте длину в валидации DTO, иначе пользователь увидит ошибку 500 вместо понятного сообщения.

Роли и права: где их путают

В Spring Security у пользователя есть набор полномочий (authorities) — строк вроде ROLE_ADMIN или orders:write. Роль — это полномочие с префиксом ROLE_: hasRole("ADMIN") ищет строку ROLE_ADMIN, а hasAuthority("ADMIN") — строку ADMIN без префикса. Перепутав их, получают 403 у администратора.

Правила на адресах делят приложение грубо, тонкие проверки переносят на методы сервиса через @EnableMethodSecurity и @PreAuthorize("hasRole('AGENT')"). Но ни адрес, ни роль не знают, чей это объект. Если клиент запрашивает /tickets/42, а заявка 42 принадлежит другому клиенту, Spring Security пропустит запрос, пока вы сами не сравните владельца, например выражением @PostAuthorize("returnObject.author == authentication.name").

CSRF: когда защита нужна, а когда мешает

Защита от подделки межсайтовых запросов включена по умолчанию для небезопасных методов, таких как POST, и токен хранится в HTTP-сессии (документация Spring Security о CSRF). Без верного токена запрос получает отказ в доступе — отсюда загадочные 403 на первой же форме.

Отключать проверку целиком ради POST из Postman — плохая привычка. Документация допускает это для бэкенда без браузерного трафика, например API мобильного приложения с токеном в заголовке. Если браузер сам прикладывает cookie с сессией, защита нужна; для одностраничного фронтенда есть настройка csrf.spa(), для отдельных адресов — ignoringRequestMatchers.

Ресурс-сервер OAuth2 и JWT

Когда пользователей проверяет отдельный сервер авторизации, например Keycloak, приложение становится ресурс-сервером: оно только проверяет присланные токены. Устройство JWT разобрано в нашей статье о JWT-аутентификации. Минимальная настройка — свойство spring.security.oauth2.resourceserver.jwt.issuer-uri. По документации ресурс-сервера (версия 7.1.1) ключи запрашиваются при первом запросе с токеном, а не при старте, так что приложение запустится и без Keycloak. Проверяются iss, exp и nbf с допуском расхождения часов в 60 секунд.

Главная ловушка — права. По умолчанию ресурс-сервер превращает каждую запись из scope или scp в полномочие с префиксом SCOPE_. Роли, которые Keycloak кладёт в другое поле токена, Spring не видит, и правило hasRole("ADMIN") отказывает всем. Нужно либо писать hasAuthority("SCOPE_tickets.write"), либо настроить JwtGrantedAuthoritiesConverter: указать поле с ролями и префикс ROLE_.

Учебный пример: служба поддержки

Учебный сервис заявок: клиент видит только свои заявки, агент поддержки — заявки очереди и меняет статус, администратор управляет пользователями. Агенты входят через веб-форму, клиенты — из мобильного приложения с JWT от Keycloak. Получаются две цепочки: для /api/** — ресурс-сервер без сессии, для остального — форма входа с CSRF. Здесь легко воспроизвести все ошибки выше и закрыть каждую тестом.

С чего начать и в каком порядке осваивать

Порядок идёт от простого механизма к распределённому: пока вы не видите, какой фильтр отклонил запрос, сервер авторизации подключать рано — ошибка в маппинге ролей и в порядке правил дают одинаковый 403. Начинать стоит, когда вы уже пишете контроллеры на Spring Boot.

  1. Подключите стартер, найдите в журнале сгенерированный пароль, включите отладочный журнал org.springframework.security и посмотрите список фильтров.
  2. Опишите SecurityFilterChain с публичными и закрытыми адресами и проверьте ответы 401 и 403.
  3. Подключите пользователей из базы через UserDetailsService и DelegatingPasswordEncoder, ограничьте длину пароля.
  4. Добавьте роли, проверку на методах и проверку владельца объекта.
  5. Переведите API в режим ресурс-сервера с локальным Keycloak и настройте маппинг ролей.
  6. Покройте правила тестами доступа.

Если удобнее идти по программе с проверкой заданий, на онлайн-курсе Skillbox «Java Spring Framework» Spring Security стоит в одном блоке со Spring Data JPA и Hibernate как инструмент аутентификации. Это два месяца, 14 часов теории и 46 часов практики, итог — бэкенд бронирования отелей. JWT и OAuth2 в описании не названы, уточните их у школы.

Открыть курс «Java Spring Framework»

Тесты доступа: @WithMockUser и отказ

Правила безопасности ломаются тихо, поэтому проверяйте и «пускает», и «не пускает». Аннотация @WithMockUser подставляет пользователя без входа: по документации о тестировании это user с паролем password и полномочием ROLE_USER, причём в базе такого пользователя может и не быть. Атрибут roles добавляет префикс ROLE_, а authorities — нет.

Вторая частая неожиданность — POST в тесте MockMvc без CSRF-токена получает 403 даже у администратора. Добавляйте .with(csrf()), а для API на токенах — .with(jwt().authorities(...)). Тесты для адреса удобно строить таблицей: аноним, клиент, чужой клиент, агент, администратор и ожидаемый код ответа для каждого.

Чему учат на курсах

На программах для Java-разработчиков Spring Security стоит ближе к концу, после баз данных и Spring Boot, и времени на него может остаться немного. Смотрите, встроен ли он в сквозной проект.

Тем, кто начинает с нуля, подойдёт онлайн-курс Skillbox «Java-разработчик»: в финальном уровне идут SQL, PostgreSQL, Hibernate и JPA, затем Spring MVC, Spring Boot и Spring Security, тестирование и оптимизация. Модуль упомянут одной строкой, сведения о сроке противоречивы — план уточните у школы.

Открыть курс «Java-разработчик»

Длинная программа даёт практику, где безопасность проверяется в командной работе с чужим кодом.

На онлайн-курсе Skillbox «Java-разработчик + ИИ» Spring Security входит в финальный технический блок со Spring Boot и тестами, затем идёт командный проект — социальная сеть на микросервисах. Обучение длится восемь месяцев; аутентификация и авторизация в описании отдельно не раскрыты.

Открыть курс «Профессия Java-разработчик»

Как Spring Security влияет на доход

Отдельной надбавки за Spring Security в вакансиях не встречается: модуль входит в обычные требования к Java-разработчику на Spring. Зато он открывает задачи, которые новичку не поручают: единый вход через Keycloak, разделение доступа клиентов и сотрудников, исправление замечаний после пентеста.

Общий ориентир даёт исследование Хабр Карьеры за первое полугодие 2026 года (опубликовано 28 августа 2026 года): медианная зарплата бэкенд-разработчика — 251 тысяча рублей. Разбивки по языкам и грейдам нет, по регионам цифры даны для всех разработчиков: 270 тысяч в Москве, 247 тысяч в Санкт-Петербурге и 200 тысяч в остальных регионах. Для своей ситуации фильтруйте вакансии по городу и опыту.

Как выбрать обучение

Перед оплатой спросите, на какой версии Spring Security написан учебный код: если в примерах есть WebSecurityConfigurerAdapter, материал устарел. Проверьте, будут ли тесты на отказ, ресурс-сервер с JWT и проверка владельца объекта.

Сравнить школы по цене, практике и поддержке наставников поможет рейтинг онлайн-школ с обучением Java. Он широкий и охватывает всё направление Java, поэтому в программах ищите отдельный модуль по Spring Security и проект, где его нужно применить.