전체 메뉴

테마

Chapter 21

Spring Security

Spring Boot 4.1.1과 Spring Security 7.1.1에서 SecurityFilterChain, 401·403 JSON, 비밀번호 해시, 역할과 권한, @PreAuthorize 데이터 권한을 구현하고 차단 경로를 테스트합니다.

난이도
중급
예상 학습
110분
Spring Boot 기준
Spring Boot 4.1.1
JDK 기준
JDK 21
최종 검토

전체 24개 Chapter 중 Chapter 21입니다. 예제 코드는 공개 저장소 spring-boot-curriculum의 examples/ch30-security 폴더에서 확인할 수 있습니다.

Learning goals

오늘 배울 내용

  • 인증과 인가, 401과 403의 차이 설명하기
  • SecurityFilterChain에서 공개·관리자·로그인 경로 규칙 순서 정하기
  • DelegatingPasswordEncoder와 bcrypt 접두사 이해하기
  • hasRole·hasAuthority와 ROLE_·FACTOR_PASSWORD 구분하기
  • @PreAuthorize 데이터 권한과 차단 경로 테스트하기
  1. 필터 체인
  2. 인증 실패 401
  3. URL 인가
  4. 비밀번호 해시
  5. 메서드 보안
  6. 차단 테스트
이 Chapter의 진행 흐름

스프링 시큐리티를 처음 붙이면 모든 API가 갑자기 401을 돌려줍니다. 그다음에는 로그인은 되는데 어떤 요청은 403이 납니다. 둘 다 “접근 거부”로 보이지만 의미가 다르고 고치는 곳도 다릅니다. 이 Chapter는 인증(누구인가)과 인가(무엇을 할 수 있는가)를 나누고, 역할에 따른 규칙과 데이터에 따른 규칙을 각각 걸어 테스트합니다.

이 Chapter에서 만드는 것

만드는 것 설명
SecurityFilterChain 공개, 관리자 전용, 로그인 필요 규칙을 한곳에 모은 설정
401/403 JSON 응답 인증 실패와 권한 부족을 본문 코드로 구분
비밀번호 해시 PasswordEncoder와 {bcrypt} 접두사
메서드 보안 @PreAuthorize로 “본인이거나 관리자” 규칙
보안 테스트 16건 규칙이 정말 막는지 확인

테스트 16건이 모두 통과했고, 실제 JAR를 실행해 curl로 받은 응답을 본문에 실었습니다.

직접 실행해 확인한 결과

확인 결과
ch30 test 16건 통과(SecurityApiTests 15, 컨텍스트 1)
공개 경로 / 자격 증명 없음 / 비밀번호 틀림 200 / 401 UNAUTHORIZED(헤더 없음) / 401 + WWW-Authenticate
kim의 /api/me roles: FACTOR_PASSWORD, ROLE_USER
관리자 영역 kim / root 403 FORBIDDEN / 200
메모 삭제 타인(lee) / 본인(kim) 403 / 204

사전 지식

  • Chapter 19의 슬라이스·MockMvc 테스트, 앞 Chapter의 예외 처리.
  • 코드는 examples/ch30-security입니다.

확인 환경

Docker 컨테이너(JDK 21.0.11), Spring Boot 4.1.1, Spring Security 7.1.1입니다. 폼 로그인, JWT, OAuth2, CORS 연동은 다루지 않았습니다. Windows는 확인하지 못했습니다.

예제 코드

대상 링크
Chapter 전체 ch30-security/
보안 설정 SecurityConfig.java
보안 테스트 SecurityApiTests.java
메서드 보안 NoteService.java

필터 체인 하나에 규칙을 모은다

요청은 컨트롤러에 닿기 전에 SecurityFilterChain을 지납니다. 이 예제의 규칙은 한곳에 모여 있습니다.

설정

http
    .authorizeHttpRequests(auth -> auth
            .requestMatchers("/api/public/**").permitAll()
            .requestMatchers("/api/admin/**").hasRole("ADMIN")
            .anyRequest().authenticated())
    .httpBasic(Customizer.withDefaults())
    .sessionManagement(s -> s.sessionCreationPolicy(SessionCreationPolicy.STATELESS))
    .csrf(AbstractHttpConfigurer::disable)

코드 읽기

  • 규칙은 위에서 아래로 먼저 맞는 것이 적용됩니다. 구체적인 규칙을 앞에, anyRequest()를 맨 끝에 둡니다(아래 “자주 만나는 오류 여섯 가지” 절의 6번).
  • permitAll(): 로그인 없이 접근. hasRole("ADMIN"): 관리자만. authenticated(): 로그인만 되어 있으면.
  • httpBasic: HTTP Basic 인증. 세션이 없으므로(STATELESS) 클라이언트가 매 요청에 자격 증명을 보냅니다.
  • csrf(... disable): 이 예제는 브라우저가 아니라 curl·테스트 같은 API 클라이언트가 Authorization 헤더를 직접 실어 보내는 학습용 API라서 CSRF 토큰을 껐습니다. 세션이 없다(STATELESS)는 사실만으로 CSRF를 꺼도 되는 것은 아닙니다. 기준은 브라우저가 자격 증명을 요청에 자동으로 붙이는가입니다.
인증 방식 브라우저가 자격 증명을 자동 전송? CSRF
쿠키 세션(Thymeleaf 화면 등) 예 켜 둡니다
브라우저에서 쓰는 HTTP Basic 예(브라우저가 로그인 창에서 받은 값을 기억해 자동 전송) 별도 CSRF 검토가 필요합니다
스크립트가 Authorization 헤더·토큰을 직접 붙이는 API(이 예제) 아니오 끄는 선택이 가능합니다. 이유를 코드에 남깁니다

브라우저 공격을 실제로 재현해 확인한 것은 아니며, 해제 조건에 대한 원칙 설명입니다. 근거는 Spring Security 공식 문서입니다.

401과 403은 다르다

상태 의미 고치는 곳
401 Unauthorized 누구인지 모른다(인증 실패) 로그인, 자격 증명
403 Forbidden 누구인지 알지만 권한이 없다(인가 실패) 역할, 규칙

AuthenticationEntryPoint(401)와 AccessDeniedHandler(403)를 달아 JSON 본문으로 구분했습니다. 실제 JAR를 실행해 받은 응답입니다.

GET /api/public/ping            -> 200 {"status":"ok"}
GET /api/me                     -> 401 {"code":"UNAUTHORIZED"}
GET /api/me      (wrong pass)   -> 401 {"code":"UNAUTHORIZED"} WWW-Authenticate: Basic realm="Realm", charset="UTF-8"
GET /api/me      (kim)          -> 200 {"username":"kim","roles":["FACTOR_PASSWORD","ROLE_USER"]}
GET /api/admin/stats (kim)      -> 403 {"code":"FORBIDDEN"}
GET /api/admin/stats (root)     -> 200 {"notes":"visible to admins only"}

자격 증명이 아예 없는 첫 401에는 WWW-Authenticate 헤더가 없었고, 비밀번호가 틀린 401에는 있었습니다. 직접 단 진입점이 기본 동작을 대체하기 때문으로 보이는데, 원인은 확인하지 않았습니다. 브라우저의 로그인 창이 필요한 서비스라면 이 헤더를 직접 넣어야 합니다.

따라 하기

계정은 학습용 메모리 계정 kim:kim-pass, lee:lee-pass, root:root-pass입니다.

./gradlew :examples:ch30-security:bootRun
curl -i http://localhost:8080/api/public/ping
curl -i http://localhost:8080/api/me
curl -i -u kim:bad http://localhost:8080/api/me
curl -s -u kim:kim-pass http://localhost:8080/api/me
curl -i -u kim:kim-pass http://localhost:8080/api/admin/stats
curl -s -u root:root-pass http://localhost:8080/api/admin/stats
200 {"status":"ok"}
401 {"code":"UNAUTHORIZED"}                     (WWW-Authenticate 헤더 없음)
401 {"code":"UNAUTHORIZED"} + WWW-Authenticate: Basic realm="Realm", charset="UTF-8"
{"roles":["FACTOR_PASSWORD","ROLE_USER"],"username":"kim"}
403 {"code":"FORBIDDEN"}
{"notes":"visible to admins only"}

자주 하는 실수

실수 증상 해결
anyRequest()를 맨 앞에 둠 서버 기동 실패 구체 규칙 먼저, anyRequest()는 끝
401과 403을 같은 응답으로 처리 클라이언트가 원인 구분 불가 AuthenticationEntryPoint·AccessDeniedHandler 분리
헤더로만 인증하는 API 클라이언트인데 CSRF를 켜 둠 POST만 403 브라우저가 자격 증명을 자동 전송하지 않는 API라는 조건을 확인하고, 끄면 이유를 남기기
화면(쿠키 세션)에서 CSRF를 끔 위조 요청에 노출 쿠키 세션 화면은 CSRF 유지

확인 문제

  1. 비밀번호가 틀리면 401과 403 중 무엇인가요?
  2. 로그인은 되었지만 관리자 영역에 접근하면 무엇인가요?

답: 1) 401입니다(누구인지 확인되지 않음). 2) 403입니다(누구인지는 알지만 권한이 없음).

직접 해 보기

  1. 위 응답을 curl로 재현해 보세요(-u kim:kim-pass처럼 앞의 학습용 계정을 씁니다).
  2. /api/admin/** 규칙과 anyRequest() 순서를 바꾸면 어떻게 되는지 확인하세요.
  3. 자신의 API 중 공개해야 하는 것을 permitAll로 따로 빼 보세요.

비밀번호는 해시로 저장한다

비밀번호를 평문으로 저장하면 DB가 유출될 때 모든 계정이 노출됩니다. 그래서 되돌릴 수 없는 해시로 바꿔 저장합니다. 이 예제의 학습용 계정 세 개(kim, lee, root)는 PasswordEncoder로 인코딩해 메모리에 둡니다.

테스트

String stored = users.loadUserByUsername("kim").getPassword();
assertThat(stored).startsWith("{bcrypt}$2");
assertThat(stored).doesNotContain("kim-pass");
  • {bcrypt}는 알고리즘을 구분하는 표시입니다. DelegatingPasswordEncoder가 이 접두사를 보고 알맞은 인코더를 고릅니다. 나중에 알고리즘을 바꿔도 기존 비밀번호를 읽을 수 있게 하는 구조입니다.
  • $2는 bcrypt 해시의 시작입니다.
  • 원래 비밀번호(kim-pass)가 저장값에 들어 있지 않음을 확인합니다.

접두사가 없는 값을 저장하면 로그인할 때 IllegalArgumentException이 납니다(아래 “자주 만나는 오류 여섯 가지” 절의 5번). 서버는 뜨지만 로그인이 필요한 요청이 모두 실패하는 형태입니다.

학습용이라는 점

예제의 비밀번호는 학습용이고 계정은 메모리에 있습니다. 실제 서비스에서는 비밀번호를 코드나 저장소에 두지 않고, DB에서 읽으며 비밀번호 변경·시도 횟수 제한 같은 운영 기능이 필요합니다. 이 예제에는 없습니다.

자주 하는 실수

실수 증상 해결
encoder.encode(...) 없이 평문 저장 로그인 시 IllegalArgumentException 항상 인코딩 후 저장
{noop}을 운영에 사용 평문 저장과 같음 학습·테스트에서만 사용
비밀번호를 코드·설정에 직접 기재 저장소에 비밀 노출 환경 변수 등으로 주입
해시를 복호화하려 함 불가능 matches로 비교

확인 문제

  1. 해시와 암호화의 차이는 무엇인가요?
  2. {bcrypt} 접두사가 없으면 무엇이 문제인가요?

답: 1) 해시는 되돌릴 수 없고, 암호화는 키로 되돌릴 수 있습니다. 2) DelegatingPasswordEncoder가 알고리즘을 고르지 못해 로그인 시점에 거절합니다.

직접 해 보기

  1. 같은 비밀번호를 두 번 인코딩해 값이 다른지 확인하세요(솔트 때문에 달라집니다. 이 예제에서는 확인하지 않았습니다).
  2. {noop} 접두사를 쓰면 어떻게 되는지 읽어 보세요. 실제 서비스에서 쓰면 안 되는 이유를 적어 보세요.
  3. 자신의 프로젝트에서 평문 비밀번호가 로그나 설정에 남는 곳이 없는지 점검하세요.

권한 목록에는 역할 말고도 있었다

로그인한 사용자의 권한을 돌려주는 /api/me를 처음에는 roles[0]이 ROLE_USER인지로 검사했습니다. 실패했습니다.

실패 메시지

JSON path "$.roles[0]" expected:<ROLE_USER> but was:<FACTOR_PASSWORD>

Spring Security 7에서는 비밀번호로 로그인한 사용자에게 ROLE_USER 외에 FACTOR_PASSWORD 권한이 함께 붙어 있었습니다. 로그인 수단을 나타내는 권한으로 보입니다. 정확한 의도는 문서로 확인하지 않았습니다. 그래서 권한을 목록의 위치로 단정하지 않고 포함 여부(hasItems)로 검사하도록 바꿨습니다. 라이브러리가 권한을 추가해도 테스트가 깨지지 않습니다.

ROLE_ 접두사

설정 찾는 이름
hasRole("ADMIN") ROLE_ADMIN (접두사를 자동으로 붙임)
hasAuthority("ADMIN") ADMIN (글자 그대로)

사용자에게 저장된 권한 이름은 ROLE_ADMIN이므로 hasAuthority("ADMIN")을 쓰면 관리자도 403을 받습니다(아래 “자주 만나는 오류 여섯 가지” 절의 4번). hasRole("ROLE_ADMIN")처럼 접두사를 직접 붙이면 서버가 뜰 때 막아 줍니다(같은 절의 3번).

따라 하기

curl -s -u kim:kim-pass http://localhost:8080/api/me
curl -s -u root:root-pass http://localhost:8080/api/me

kim의 권한은 ["FACTOR_PASSWORD","ROLE_USER"]입니다. 권한 목록에는 역할(ROLE_USER) 외에 인증 방식을 나타내는 항목이 함께 들어 있어, roles[0]처럼 위치로 검사하면 깨집니다.

자주 하는 실수

실수 증상 해결
권한 목록을 인덱스로 검사 라이브러리 업그레이드에서 깨짐 hasItems·contains로 포함 검사
hasRole("ROLE_ADMIN") 서버 기동 실패 hasRole("ADMIN")
hasAuthority("ADMIN") 관리자가 403 hasRole("ADMIN") 또는 hasAuthority("ROLE_ADMIN")

확인 문제

  1. hasRole("ADMIN")이 실제로 찾는 권한 이름은 무엇인가요?
  2. 권한 목록을 위치로 검사하면 안 되는 이유는 무엇인가요?

답: 1) ROLE_ADMIN입니다. 2) 라이브러리가 항목을 더하거나 순서를 바꿀 수 있기 때문입니다.

직접 해 보기

  1. /api/me를 호출해 권한 목록 전체를 확인하세요.
  2. 위치 단정 테스트를 hasItems("ROLE_USER")로 바꿔 통과시키세요.
  3. 역할(ROLE_*)과 세부 권한(예: memo:delete)을 함께 쓰려면 어떻게 구성할지 설계해 보세요(이 예제는 역할만 씁니다).

데이터에 따른 권한은 메서드에 건다

“메모는 본인이거나 관리자만 지울 수 있다”는 URL 규칙만으로는 쓸 수 없습니다. 어떤 메모인지에 따라 달라지기 때문입니다. URL은 /notes/5 같은 모양이라 5번 메모의 주인이 누구인지 URL 규칙은 모릅니다. 이럴 때는 서비스 메서드에 @PreAuthorize를 겁니다.

코드

@PreAuthorize("hasRole('ADMIN') or @noteService.isOwner(#id, authentication.name)")
public void delete(long id) { ... }

코드 읽기

  • hasRole('ADMIN'): 관리자는 항상 허용.
  • @noteService.isOwner(#id, authentication.name): noteService 빈의 isOwner를 호출합니다. #id는 메서드 인자, authentication.name은 로그인한 사용자 이름입니다.
  • or: 둘 중 하나만 맞으면 통과.
  • 규칙이 서비스 메서드에 붙어 있으므로, 어느 컨트롤러가 부르든 같은 규칙이 적용됩니다.

실제 결과

JAR 실행에서 kim이 만든 메모를 lee가 지우면 403, kim 본인이 지우면 204였습니다. 테스트 네 가지가 이를 고정합니다.

상황 기대
본인이 삭제 허용
다른 사용자가 삭제 403
관리자가 삭제 허용
목록 조회 본인 것만 보임

메서드 보안은 켜야 동작한다

메서드 보안은 @EnableMethodSecurity가 있어야 동작합니다. 없으면 @PreAuthorize는 붙어 있어도 조용히 무시됩니다. 경고도 없습니다(아래 “자주 만나는 오류 여섯 가지” 절의 2번). 그래서 “막혀야 하는 요청”을 직접 보내는 테스트가 필수입니다.

따라 하기

curl -i -u kim:kim-pass -X POST http://localhost:8080/api/notes -H 'Content-Type: application/json' -d '{"text":"hello"}'
curl -s -o /dev/null -w '%{http_code}\n' -u lee:lee-pass -X DELETE http://localhost:8080/api/notes/1
curl -s -o /dev/null -w '%{http_code}\n' -u kim:kim-pass -X DELETE http://localhost:8080/api/notes/1
201 {"id":1,"owner":"kim","text":"hello"}
403     (타인 lee가 삭제)
204     (본인 kim이 삭제)

자주 하는 실수

실수 증상 해결
@EnableMethodSecurity 누락 @PreAuthorize가 조용히 무시됨(타인도 204) 설정 추가 + 막히는 요청 테스트
URL 규칙만으로 본인 여부 검사 데이터별 권한 구현 불가 서비스 메서드에 규칙
SpEL 변수 이름 불일치(#id) 평가 오류 메서드 인자 이름과 일치

확인 문제

  1. URL 규칙으로는 “본인 메모만 삭제”를 표현하기 어려운 이유는 무엇인가요?
  2. @EnableMethodSecurity가 없으면 가장 위험한 점은 무엇인가요?

답: 1) URL만으로는 어떤 메모인지(데이터)를 알 수 없기 때문입니다. 2) 오류 없이 규칙이 꺼져서 권한 없는 삭제가 성공한다는 점입니다.

직접 해 보기

  1. 다른 사용자의 삭제를 시도하는 테스트를 만들고 @EnableMethodSecurity를 지워 실패하는지 확인하세요.
  2. 수정(update)에도 같은 규칙을 걸어 보세요.
  3. 조회를 “본인 것만”으로 제한하는 방법을 @PostFilter 또는 쿼리 조건 중 무엇으로 할지 비교해 보세요(이 예제의 목록 제한 구현 방식은 이 절에서 풀어 쓰지 않았습니다).

보안 테스트: 규칙을 지우면 실패하는가

보안 테스트에서 가장 위험한 것은 “로그인되는 것만 확인한 테스트”입니다. 아무리 많아도 권한이 없으면 막힌다는 것은 막히는 요청을 직접 보내야만 확인됩니다. 이 절에서는 보안 테스트를 쓰는 도구와, 규칙을 지워서 테스트가 잡는지 확인한 과정을 다룹니다.

@WithMockUser

@WithMockUser(roles = "USER")는 로그인 과정 없이 “USER 역할의 사용자가 요청했다”는 상태를 만듭니다. 로그인 자체가 아니라 인가 규칙을 검사할 때 씁니다. 관리자 영역을 USER 역할로 호출하면 403이 나오는 테스트가 그 예입니다.

처음에는 spring-security-test 의존성만 넣었더니 @WithMockUser를 붙인 요청이 모두 401이었습니다. 의존성을 spring-boot-starter-security-test로 바꾸자 동작했습니다. Boot 4에서는 MockMvc와 보안 테스트의 연결을 이 스타터가 맡는 것으로 보입니다. 이유까지는 확인하지 않았습니다.

규칙 부정 검사

규칙이 정말 잡는지 확인하려고 /api/admin/** 규칙과 @PreAuthorize를 지웠습니다.

지운 것 실패한 테스트
hasRole("ADMIN") 규칙, @PreAuthorize userRoleCannotReachAdminArea, anotherUserCannotDeleteIt, withMockUserWithoutAdminRoleIsForbidden

세 테스트가 실패했고, 복원 후 16건이 다시 모두 통과했습니다. 규칙이 사라졌을 때 테스트가 알려 준다는 증거입니다.

테스트가 확인하는 범위

영역 확인
공개 경로 로그인 없이 200
무자격/틀린 비밀번호 401 JSON
USER의 관리자 영역 403
ADMIN의 관리자 영역 200
메모 삭제 본인 204, 타인 403, 관리자 허용
저장된 비밀번호 {bcrypt} 접두사, 평문 아님

JAR 요청 스크립트 실수

실제 JAR 요청을 보내는 스크립트에서 Authorization 헤더 조립이 잘못되어 처음 두 번은 모두 401/400이었습니다. 앱의 문제가 아니라 스크립트 실수였고, 헤더를 고쳐 다시 실행했습니다. 응답이 이상할 때 앱을 고치기 전에 요청이 올바르게 만들어졌는지 먼저 의심합니다.

따라 하기

./gradlew :examples:ch30-security:test

재검증에서 16건(SecurityApiTests 15, 컨텍스트 1)이 통과했습니다.

자주 하는 실수

실수 증상 해결
로그인 성공만 테스트 권한이 풀려도 통과 막혀야 하는 요청도 테스트
spring-security-test만 추가 @WithMockUser 요청이 401 spring-boot-starter-security-test 사용
@WithMockUser로 인증 로직까지 검증하려 함 로그인 단계는 건너뜀 인증은 실제 자격 증명으로 별도 검증

확인 문제

  1. @WithMockUser가 건너뛰는 것은 무엇인가요?
  2. 규칙을 지워 테스트가 실패하는지 확인하는 이유는 무엇인가요?

답: 1) 로그인(인증) 단계입니다. 2) 규칙이 사라졌을 때 테스트가 그것을 알아채는지 확인해야 테스트를 신뢰할 수 있기 때문입니다.

직접 해 보기

  1. 관리자 영역 규칙을 지우고 어떤 테스트가 실패하는지 직접 확인하세요.
  2. 의존성을 spring-security-test만 두고 @WithMockUser 테스트를 돌려 401을 재현해 보세요.
  3. 인증되지 않은 요청이 보호된 모든 경로에서 401인지 확인하는 테스트를 추가해 보세요.

자주 만나는 오류 여섯 가지

보안 설정은 한 줄만 틀려도 증상이 엉뚱한 곳에서 나옵니다. 아래는 SecurityConfig를 한 군데씩 일부러 망가뜨린 뒤 기존 테스트를 돌려 실제로 얻은 결과입니다(긴 메시지는 핵심만 옮겼습니다). 망가뜨린 코드는 실험 뒤 원래대로 되돌렸고 저장소에는 올리지 않았습니다. Spring Security 7.1.1 기준입니다.

1. POST만 403이 난다: CSRF

.csrf(AbstractHttpConfigurer::disable) 줄을 지우자 GET은 그대로인데 쓰기 요청만 막혔습니다.

java.lang.AssertionError: Status expected:<201> but was:<403>

인증은 통과했는데 403이라 권한 문제로 착각하기 쉽습니다. 단서는 GET은 되고 POST/PUT/DELETE만 막힌다는 점입니다. CSRF 토큰이 없는 변경 요청을 Spring Security가 기본으로 거절하기 때문입니다. 브라우저가 자격 증명을 자동으로 붙이지 않는 API 클라이언트용(이 예제처럼 헤더로 직접 인증)이라면 끄고 이유를 주석으로 남기고, 쿠키 세션을 쓰는 화면이라면 끄지 말고 토큰을 보내도록 클라이언트를 고칩니다. 판단 기준은 앞의 “필터 체인 하나에 규칙을 모은다” 절의 CSRF 표를 봅니다.

2. 메서드 보안이 조용히 꺼져 있다

@EnableMethodSecurity를 지웠습니다. 서버는 오류 없이 떴고, 한 테스트만 실패했습니다.

anotherUserCannotDeleteIt()
java.lang.AssertionError: Status expected:<403> but was:<204>

lee가 kim의 메모를 지웠는데 204가 나왔습니다. @PreAuthorize는 붙어 있지만 검사하는 장치가 꺼져 있어서 무시된 것입니다. 경고도 없습니다. “막혀야 하는 요청을 직접 보내는 테스트”가 없으면 영영 발견되지 않는, 가장 위험한 유형입니다.

3. 서버가 아예 뜨지 않는다: ROLE_ 접두사

hasRole("ADMIN")을 hasRole("ROLE_ADMIN")으로 바꾸면 컨텍스트가 만들어지지 않습니다.

Failed to load ApplicationContext ...
Caused by: ... Error creating bean with name 'filterChain' ...
Caused by: ... Factory method 'filterChain' threw exception with message:
ROLE_ADMIN should not start with ROLE_ since ROLE_ is automatically prepended when using hasAnyRole. Consider using hasAnyAuthority instead.

hasRole은 이름 앞에 ROLE_을 스스로 붙입니다. 메시지가 고칠 방향(hasAnyAuthority를 쓰거나 접두사를 빼라)까지 알려 줍니다. 시작할 때 막아 주는 오류라서 오히려 다행입니다.

4. 역할과 권한을 섞었다: hasAuthority

hasRole("ADMIN") 대신 hasAuthority("ADMIN")을 쓰면 서버는 정상적으로 뜨지만 관리자가 403을 받습니다.

adminRoleReachesAdminArea()
withMockUserSkipsTheLoginStepAndTestsOnlyAuthorization()
java.lang.AssertionError: Status expected:<200> but was:<403>

사용자에게 저장된 권한 이름은 ROLE_ADMIN인데 hasAuthority("ADMIN")은 글자 그대로 ADMIN을 찾기 때문입니다(앞의 “권한 목록에는 역할 말고도 있었다” 절의 ROLE_ 접두사 표). 관리자가 이유 없이 403을 받으면 hasRole과 hasAuthority를 먼저 비교합니다.

5. 서버 시작은 되는데 로그인할 때 터진다: 접두사 없는 비밀번호

계정을 만들 때 encoder.encode(...)를 빼고 비밀번호를 그대로 넣어 봤습니다.

java.lang.IllegalArgumentException: Given that there is no default password encoder configured, each password must have a password encoding prefix. Please either prefix this password with '{noop}' or set a default password encoder in `DelegatingPasswordEncoder`.

DelegatingPasswordEncoder는 {bcrypt}나 {noop} 같은 접두사로 알고리즘을 고릅니다. 접두사 없는 값은 거절합니다. 그 결과 시작은 되지만 로그인이 필요한 요청이 모두 실패합니다(이 실험에서 인증이 필요한 테스트 대부분이 같은 이유로 깨졌습니다). 이미 DB에 접두사 없는 해시가 들어 있다면 {bcrypt}를 붙여 저장하거나 인코더 설정을 바꿔야 합니다.

6. 규칙 순서: anyRequest는 맨 끝에

anyRequest().authenticated()를 맨 앞으로 옮기면 서버가 뜨지 않습니다.

Factory method 'filterChain' threw exception with message: Can't configure requestMatchers after anyRequest

규칙은 위에서 아래로 먼저 맞는 것이 적용되므로, 모든 요청을 가리키는 규칙은 마지막에 둡니다.

점검표

증상 가장 먼저 볼 것
GET은 되는데 POST만 403 CSRF 설정
어노테이션을 붙였는데 막히지 않음 @EnableMethodSecurity, 그리고 막혀야 하는 요청을 보내는 테스트
시작 시 filterChain 생성 실패 맨 아래 Caused by의 메시지 (ROLE_, anyRequest 순서)
관리자가 403 hasRole과 hasAuthority
로그인 요청이 모두 실패 저장된 비밀번호의 {bcrypt} 접두사
@WithMockUser가 401 의존성이 spring-boot-starter-security-test인지

위험도로 보면

유형 오류 위험
시작 시 터짐 3, 6 낮음. 바로 발견됨
눈에 띄게 실패 1, 4, 5 중간. 증상이 엉뚱한 곳에 나옴
조용히 열림 2 높음. 테스트 없이는 발견 못 함

직접 해 보기

  1. 여섯 가지 중 하나를 골라 재현하고 원래대로 되돌려 보세요.
  2. 2번 유형을 잡는 테스트를 자신의 프로젝트에 추가해 보세요.
  3. 서버 시작 시 보안 설정이 올바른지 확인하는 스모크 테스트를 설계해 보세요.

한계와 다음 단계

이 Chapter를 마무리하며 만든 것과 다루지 않은 것을 정리합니다.

만든 것

  • 필터 체인 한곳의 규칙(공개, 관리자 전용, 로그인 필요)과 401/403 JSON 응답.
  • bcrypt 해시와 {bcrypt} 접두사.
  • @PreAuthorize로 거는 데이터별 권한.
  • 규칙을 지우면 실패하는 보안 테스트 16건.

한계와 확인하지 않은 것

항목 상태
폼 로그인, JWT, OAuth2 다루지 않음
계정 저장소 메모리의 학습용 3개. DB에서 읽지 않음
CORS와의 연동 확인하지 않음 (Chapter 14의 CORS와 이어서 봐야 함)
로그인 시도 횟수 제한, 비밀번호 변경 없음
자격 증명 없는 401에 WWW-Authenticate가 없는 이유 관찰만 했고 원인은 확인하지 않음
FACTOR_PASSWORD 권한의 의도 문서로 확인하지 않음
@WithMockUser에 spring-boot-starter-security-test가 필요한 이유 확인하지 않음

다음 단계로 무엇을 보면 좋은가

  • 화면과 API가 다른 도메인이라면 CORS와 쿠키·토큰 전략을 함께 설계합니다.
  • 계정을 DB로 옮기고, 로그인 이력과 잠금 정책을 정합니다.
  • 토큰 기반 인증(JWT 또는 OAuth2)을 비교해 봅니다. 이 과정에서는 다루지 않았습니다.

직접 해 보기

  1. 위 표의 항목 하나를 골라 어떻게 보완할지 설계해 보세요.
  2. 자신의 API 중 누구나 호출하면 안 되는데 규칙이 없는 경로가 있는지 점검하세요.
  3. 보안 설정 변경이 PR에 포함될 때 무엇을 리뷰해야 하는지 체크리스트를 써 보세요.

용어와 참고 자료

Chapter 21의 용어를 모았습니다.

용어

용어 설명 나온 곳
인증(authentication) 요청한 사람이 누구인지 확인하는 일입니다. 실패하면 401입니다. 필터 체인 하나에 규칙을 모은다
인가(authorization) 확인된 사람이 그 일을 할 수 있는지 판단하는 일입니다. 실패하면 403입니다. 필터 체인 하나에 규칙을 모은다
SecurityFilterChain 요청이 컨트롤러에 닿기 전에 지나는 보안 필터의 묶음입니다. 필터 체인 하나에 규칙을 모은다
HTTP Basic 요청마다 Authorization 헤더에 자격 증명을 보내는 인증 방식입니다. 필터 체인 하나에 규칙을 모은다
무상태(STATELESS) 서버가 세션을 만들지 않는 설정입니다. 필터 체인 하나에 규칙을 모은다
CSRF 로그인된 사용자의 브라우저를 이용해 의도하지 않은 요청을 보내게 하는 공격입니다. 필터 체인 하나에 규칙을 모은다, 자주 만나는 오류 여섯 가지
bcrypt 비밀번호를 되돌릴 수 없는 해시로 바꾸는 알고리즘입니다. 비밀번호는 해시로 저장한다
DelegatingPasswordEncoder {bcrypt} 같은 접두사로 알고리즘을 고르는 인코더입니다. 비밀번호는 해시로 저장한다
ROLE_ 접두사 역할 이름 앞에 붙는 관례적 접두사입니다. hasRole이 자동으로 붙입니다. 권한 목록에는 역할 말고도 있었다
메서드 보안 @PreAuthorize처럼 메서드 호출 시점에 권한을 검사하는 방식입니다. 데이터에 따른 권한은 메서드에 건다
SpEL 애노테이션 안에서 조건을 쓰는 스프링 표현식 언어입니다. 데이터에 따른 권한은 메서드에 건다
@WithMockUser 로그인 과정 없이 인증된 사용자를 흉내 내는 테스트 애노테이션입니다. 보안 테스트: 규칙을 지우면 실패하는가

참고 자료

직접 해보기

  1. ./gradlew :examples:ch30-security:bootRun으로 서버를 켜고 curl -i http://localhost:8080/api/me와 curl -i -u kim:bad http://localhost:8080/api/me의 응답을 비교해 보세요. 두 401 중 어느 쪽에 WWW-Authenticate 헤더가 붙는지 확인합니다.
  2. curl -i -u kim:kim-pass http://localhost:8080/api/admin/stats와 curl -s -u root:root-pass http://localhost:8080/api/admin/stats로 403과 200을 비교하고, curl -s -u kim:kim-pass http://localhost:8080/api/me의 권한 목록에 ROLE_USER 말고 어떤 항목이 있는지 확인해 보세요.
  3. kim으로 메모를 만든 뒤 lee와 kim이 각각 DELETE /api/notes/1을 보내 403과 204가 나오는지 확인하세요. 이어서 @EnableMethodSecurity를 지우고 ./gradlew :examples:ch30-security:test를 실행해 anotherUserCannotDeleteIt가 어떻게 실패하는지 본 뒤 되돌립니다.
  4. SecurityConfig를 한 군데만 망가뜨려 보세요. .csrf(AbstractHttpConfigurer::disable) 삭제, hasRole("ROLE_ADMIN"), hasAuthority("ADMIN"), anyRequest()를 맨 앞으로 옮기기 중 하나를 골라 ./gradlew :examples:ch30-security:test의 결과를 “자주 만나는 오류 여섯 가지”의 점검표와 맞춰 보고 원래대로 되돌립니다.
  5. 테스트 의존성을 spring-security-test만 두고 @WithMockUser 테스트가 401이 되는지 재현한 뒤, 보호된 모든 경로에서 인증 없는 요청이 401인지 확인하는 테스트를 추가해 보세요.

이번 장의 정리

  • 401은 누구인지 모르는 인증 실패, 403은 누구인지 알지만 권한이 없는 인가 실패입니다. AuthenticationEntryPoint와 AccessDeniedHandler를 달아 JSON 본문으로 둘을 구분했습니다.
  • 규칙은 SecurityFilterChain 한곳에 모으며, 위에서 아래로 먼저 맞는 규칙이 적용되므로 anyRequest()는 맨 끝에 둡니다.
  • CSRF를 꺼도 되는지는 세션 유무가 아니라 브라우저가 자격 증명을 요청에 자동으로 붙이는지로 판단합니다. 이 예제는 Authorization 헤더로 직접 인증하는 API라서 껐습니다.
  • 비밀번호는 PasswordEncoder로 bcrypt 해시를 만들어 {bcrypt} 접두사와 함께 저장합니다. 접두사가 없으면 서버는 뜨지만 로그인할 때 IllegalArgumentException이 납니다.
  • hasRole("ADMIN")은 ROLE_ADMIN을 찾고 hasAuthority("ADMIN")은 글자 그대로 ADMIN을 찾습니다. 권한 목록에는 FACTOR_PASSWORD도 들어 있으므로 위치가 아니라 포함 여부로 검사합니다.
  • “본인이거나 관리자” 같은 데이터별 권한은 @PreAuthorize로 서비스 메서드에 겁니다. @EnableMethodSecurity가 없으면 경고 없이 무시되므로 막혀야 하는 요청을 직접 보내는 테스트로 지킵니다.
  • @WithMockUser로 로그인 단계 없이 인가 규칙을 검사하고, 규칙을 지웠을 때 세 테스트가 실패하는 것을 확인해 테스트를 믿을 근거로 삼았습니다.
  • 폼 로그인, JWT, OAuth2, CORS 연동은 다루지 않았고, 계정은 메모리에 둔 학습용 3개입니다.

다음 Chapter 22 운영에서는 요청 ID와 MDC 로그, 제한된 Actuator 상태·지표를 붙이고, Dockerfile·Compose·GitHub Actions·스모크 테스트로 패키징과 자동 검증을 구성합니다.

FAQ

자주 묻는 질문

401과 403은 어떻게 다른가요?

401은 유효한 인증 정보가 없어 누구인지 확인하지 못한 상태이고, 403은 인증은 되었지만 요청한 작업의 권한이 부족한 상태입니다.

hasRole과 hasAuthority의 차이는 무엇인가요?

hasRole은 ROLE_ 접두사를 붙인 역할을 검사하고 hasAuthority는 저장된 권한 문자열을 그대로 검사합니다. 권한 이름과 검사식을 맞춰야 합니다.

비밀번호 앞의 {bcrypt}는 왜 필요한가요?

DelegatingPasswordEncoder가 어떤 알고리즘으로 저장된 해시인지 선택할 수 있게 하는 식별자입니다. 접두사가 없으면 인코더를 결정하지 못하는 오류가 날 수 있습니다.

보안 테스트에서 성공 요청만 확인하면 충분한가요?

충분하지 않습니다. 인증 없음, 틀린 비밀번호, 권한 부족, 타인 데이터 접근처럼 막혀야 할 요청을 보내 401과 403을 확인해야 합니다.

작성·편집 ToolPado

콘텐츠 유형 Spring Boot 학습 가이드

기술 기준 Spring Boot 4.1.1 · JDK 21

마지막 검토