Chapter 23에서 만든 설계와 백엔드 위에 이 Chapter에서는 화면을 올리고, 인증을 진짜로 바꾸고, 이미지로 묶어 띄웁니다. 종합 프로젝트의 마지막 단계이자 Spring Boot 과정의 마지막 Chapter입니다.
이 Chapter에서 다루는 것
| 단계 | 내용 |
|---|---|
| 화면(f03) | Thymeleaf 읽기 화면과 React 쓰기 화면이 같은 서비스를 공유, XSS 방지 테스트, Swagger 문서 테스트 |
| 보안·배포(f04) | 임시 헤더 인증을 HTTP Basic으로, “기본 거부” 인가 규칙, 한글 비밀번호가 낸 500 오류, 이미지와 스모크 테스트 |

한글 비밀번호를 서른 글자로 가입하면 서버가 500 오류를 냈습니다. 입력 검증에는 “비밀번호는 72자 이하”라고 적어 두었고 서른 글자는 분명히 72자 이하인데도 그랬습니다. 그 원인과 수정은 아래 “500 오류의 원인: 글자 수와 바이트 수” 절에서 다룹니다.
직접 실행해 확인한 결과
| 확인 | 결과 |
|---|---|
React 테스트(projects/final-project/frontend) |
7개 파일 36건 통과 (f03 시점에는 31건이었고 이후 늘어남) |
| 3단계 Docker 이미지 빌드 | 성공(약 2분 46초). 원고 작성 시에는 “로컬에서 끝까지 못 돌렸다”고 적었지만 재검증 환경에서는 끝까지 돌았음 |
| 컨테이너 기동 | 약 18초 안에 healthy, 사용자 uid=10001(app) |
smoke-test.sh |
readiness·/pages/posts·/app/index.html·signup/login·security·post create/search 모두 ok, SMOKE TEST PASSED |
| 한글 비밀번호 24자(72바이트) / 25자(75바이트) | 가입 201·로그인 200 / 400 (password 필드 오류) |
| 없는 아이디 / 틀린 비밀번호의 401 본문 | 서로 같음 |
| 보안 헤더 | X-Content-Type-Options: nosniff, X-Frame-Options: DENY, Cache-Control: no-cache, no-store, ... |
제목에 <script> |
목록 화면에 <script>alert(1)</script>로 출력 |
비로그인 /actuator/health / env·beans·metrics |
200(세부 항목 없이 status·groups만) / 401 |
| 규칙에 없는 경로 | 401 (기본 거부) |
서버 88건 중 Oracle 13건은 재검증 환경에서 건너뛰었습니다(Chapter 23). 실제 브라우저에서 화면을 열어 보지는 못했습니다.
사전 지식
- Chapter 23의 종합 프로젝트, Chapter 13의 Thymeleaf, Chapter 14의 React, Chapter 21의 Spring Security, Chapter 22의 운영.
확인 환경
Docker 컨테이너(JDK 21.0.11, Gradle 9.8.1, Node 24), GitHub Actions입니다. 종합 프로젝트 서버 테스트 88건(Oracle 포함, 건너뜀 0건)은 CI oracle 잡의 원고 작성 시 기록이고 재검증 환경에서는 75건 통과·Oracle 13건 SKIPPED였으며, React 36건은 재검증에서 직접 통과를 확인했습니다. 화면은 실제 브라우저에서 열어 보지 못했습니다. HTTPS는 만들지 않았습니다.
예제 코드
| 대상 | 링크 |
|---|---|
| 프로젝트 | final-project/ |
| 서버 렌더링 컨트롤러 | PageController.java |
| 화면 설계 | 05-screens.md |
| React 화면 | frontend/ |
| 보안 설정 | security/ |
| 보안 테스트 | SecurityTests.java |
| Dockerfile | Dockerfile |
| 스모크 테스트 | smoke-test.sh |
| Chapter 문서(f03) | README.md |
| Chapter 문서(f04) | README.md |
| 커리큘럼 전체 | CURRICULUM.md |
화면을 나누는 기준: 두 컨트롤러, 서비스는 하나
Chapter 13에서 Thymeleaf로, Chapter 14에서 React로 같은 종류의 화면을 만들어 봤습니다. 종합 프로젝트에서는 둘 중 하나를 고르는 대신 둘 다 쓰되, 맡는 일을 나눴습니다. 읽기만 하는 화면은 서버가 HTML을 만들고, 입력이 많은 화면은 React가 맡습니다.
화면을 나누는 기준
| 구분 | 주소 | 하는 일 |
|---|---|---|
| 서버 렌더링 | /pages/posts, /pages/posts/{id} |
글 목록·검색·페이징, 글 상세 (읽기 전용) |
| React | /app/ 아래 |
목록, 상세, 작성·수정, 가입, 로그인 |
| API 문서 | /swagger-ui.html |
요청을 직접 보내 보기 |
읽기 화면은 서버가 완성된 HTML을 주면 JavaScript 없이도 열리고 검색 결과 주소를 그대로 공유할 수 있습니다. 쓰기 화면은 검증 오류를 입력 칸마다 보여 주고 저장 뒤에 이동하는 흐름이 있어서 화면 상태가 필요합니다. 그래서 이쪽은 React입니다. (Thymeleaf와 React의 테스트 비교도 참고하세요.)
두 컨트롤러, 서비스는 하나
HTML을 만드는 PageController와 JSON을 주는 PostController는 모두 같은 PostApi.search를 부릅니다. 화면마다 검색 규칙을 따로 만들면 같은 조건인데 결과가 달라지기 때문에, 규칙은 서비스에만 있습니다.
@GetMapping("/pages/posts")
String list(@RequestParam(required = false) String keyword,
@RequestParam(required = false) String tag,
@RequestParam(defaultValue = "0") int page, Model model) {
PageResponse<PostSummary> result = postApi.search(new PostQuery(keyword, null, tag, page, PAGE_SIZE));
...
return "posts/list";
}
오류 처리도 갈린다
같은 “글이 없음” 예외가 API에서는 JSON(ErrorBody)으로, 화면에서는 오류 HTML 페이지로 나가야 합니다. PageController에 자기 @ExceptionHandler를 두면 컨트롤러 안의 핸들러가 전역 @RestControllerAdvice보다 먼저 적용되어 이 구분이 됩니다(Chapter 13의 오류 페이지). 테스트에서 /pages/posts/999999는 404와 error/404 뷰를, 같은 조건의 API는 JSON을 돌려주는 것을 확인했습니다.
따라 하기
이미지로 띄운 앱(localhost:18087)에서 글 목록 화면을 요청했습니다.
curl -s http://localhost:8080/pages/posts | grep -c '글 목록'
curl -s http://localhost:8080/app/index.html | grep -c 'id="root"'
curl -s -i -H 'Accept: text/html' http://localhost:8080/pages/posts/9999 | grep -i 'HTTP/\|<h1'
1 (서버 렌더링 HTML)
1 (React 빌드 결과가 이미지에 들어 있음)
HTTP/1.1 404 <h1>404</h1> (화면용 오류 페이지)
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
| 화면용 컨트롤러가 JSON 오류를 내보냄 | 브라우저에 JSON이 보임 | 컨트롤러 안 @ExceptionHandler로 화면과 API 분리 |
| 두 컨트롤러가 각자 검색 로직 구현 | 같은 검색어에 결과가 다름 | 같은 PostApi.search 공유 |
| 입력이 많은 화면을 서버 렌더링으로만 구현 | 폼 상태 관리가 복잡 | 쓰기 화면은 React |
확인 문제
- 읽기 화면을 서버 렌더링으로 하면 좋은 점은 무엇인가요?
- 두 컨트롤러가 같은 서비스를 공유하면 무엇이 보장되나요?
답: 1) JavaScript 없이도 열리고 검색 결과 주소를 그대로 공유할 수 있습니다. 2) 화면과 API의 검색 규칙이 하나로 유지됩니다.
직접 해 보기
/pages/posts와/api/v1/posts에 같은 검색어를 주고 결과가 같은지 비교하세요.PageController의@ExceptionHandler를 지우면 404 화면이 어떻게 되는지 확인하세요.- 자신의 프로젝트에서 서버 렌더링이 어울리는 화면을 골라 보세요.
사용자 입력이 HTML로 해석되지 않는지 확인하기
게시판의 가장 흔한 취약점은 글 제목이나 본문에 넣은 <script>가 다른 사람 화면에서 실행되는 것(XSS)입니다. 두 화면 모두 값을 “글자”로 넣는 방식만 쓰고, HTML로 넣는 방식(th:utext, dangerouslySetInnerHTML)은 쓰지 않기로 했습니다. 그리고 규칙이 지켜지는지 테스트로 확인했습니다. (Chapter 13의 이스케이프의 적용입니다.)
서버 쪽 테스트
제목에 <script>alert(1)</script>, 본문에 <img src=x onerror=alert(2)>를 넣고 응답 HTML을 검사합니다.
assertThat(list).doesNotContain("<script>alert(1)</script>").contains("<script>");
assertThat(detail).doesNotContain("<img src=x").contains("<img src=x");
- 원문 태그가 응답에 없고(
doesNotContain), 이스케이프된<가 있어야(contains) 통과합니다. 둘 다 확인하는 이유는 글이 통째로 사라진 경우와 안전하게 표시된 경우를 구분하기 위해서입니다.
React 쪽 테스트
본문에 <b>굵게</b>를 넣고 화면에 <b> 요소가 만들어지지 않으며 글자로만 보이는지 확인합니다.
expect(container.querySelector('b')).toBeNull()
expect(container.querySelector('.content')).toHaveTextContent('<b>굵게</b>')
줄바꿈은 CSS로
줄바꿈은 HTML(<br>)로 바꾸지 않고 CSS(white-space: pre-wrap)로 살렸습니다. HTML을 만들지 않으므로 이스케이프 규칙이 흔들리지 않습니다.
한계
이스케이프 확인은 th:text를 지킨다는 규칙의 검증이지 모든 XSS 경로의 검증이 아닙니다. 어느 화면의 어느 필드까지 검사하는지는 아래 “화면 단계에서 자주 만나는 오류” 절에서 구멍으로 확인합니다. 화면은 실제 브라우저에서 열어 보지 못했고 jsdom과 응답 문자열로만 확인했습니다. Content-Security-Policy 헤더는 설정하지 않았습니다.
따라 하기
제목에 <script>alert(1)</script>를 넣은 글을 만든 뒤 목록 화면을 확인했습니다.
curl -s -u user:password-xxxx -X POST http://localhost:8080/api/v1/posts -H 'Content-Type: application/json' \
-d '{"title":"<script>alert(1)</script>","content":"<img src=x onerror=alert(2)>\n둘째 줄"}'
curl -s http://localhost:8080/pages/posts | grep -o '<script>[^<]*'
201
<script>alert(1)</script>
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
th:utext, dangerouslySetInnerHTML 사용 |
입력한 HTML이 실행됨 | 사용자 입력에는 쓰지 않음 |
줄바꿈을 <br>로 치환 |
HTML을 직접 만들게 됨 | CSS white-space: pre-wrap |
| 본문만 테스트하고 제목은 빼먹음 | 제목 구멍을 놓침(“화면 단계에서 자주 만나는 오류” 절) | 모든 출력 지점을 목록화 |
확인 문제
- 서버 렌더링과 React에서 이스케이프를 각각 어떻게 테스트하나요?
- 줄바꿈을 CSS로 살리는 이유는 무엇인가요?
답: 1) 서버는 응답 HTML 문자열에 <가 있고 원문 태그가 없음을, React는 해당 DOM 요소가 만들어지지 않음을 확인합니다. 2) HTML을 만들지 않으므로 이스케이프 문제가 생기지 않기 때문입니다.
직접 해 보기
- 제목에
<script>를 넣은 글을 직접 만들어 두 화면에서 어떻게 보이는지 확인하세요. th:text를th:utext로 바꿔 어느 테스트가 실패하는지 보세요(아래 “화면 단계에서 자주 만나는 오류” 절).- React에서
dangerouslySetInnerHTML을 쓰면 안 되는 경우와 써야 하는 경우를 적어 보세요.
React 화면의 구조와 두 가지 배포 설정
React 화면은 구조가 흐트러지기 쉽습니다. 이 프로젝트는 호출은 한 곳에, 상태는 한 곳에, 화면은 화면답게 나눴습니다. 그리고 개발할 때와 배포할 때 서버와 화면을 잇는 방식이 다르기 때문에 설정이 둘입니다.
구조
| 위치 | 책임 |
|---|---|
src/api |
fetch 호출, 오류를 ApiError로 변환, 질의 문자열 조립 |
src/auth/session.js |
로그인 상태 보관, 요청 헤더 생성 |
src/pages |
화면과 입력 처리 |
src/App.jsx |
경로, 내 정보 조회, 상단 메뉴 |
fetch는 src/api에만 있고 화면 컴포넌트는 부르지 않습니다(Chapter 14의 API 모듈). 서버 오류는 ErrorBody의 issues([{field, reason}])를 입력 칸 옆에 보여 줍니다(필드 오류). 목록의 검색 조건(키워드, 태그, 페이지)은 주소에 둬서(?keyword=..&tag=..&page=..) 새로고침이나 주소 공유에도 같은 결과가 나옵니다.
로그인 상태는 session.js만 압니다. 이 단계에서는 서버가 임시 인증(X-User-Id 헤더)이었기 때문에 사용자 ID를 보관했는데, 인증 방식이 바뀌어도 고칠 곳을 이 파일과 로그인·가입 화면으로 한정하려는 구조였습니다. 실제로 바뀐 것은 아래 “인증을 바꿔도 서비스는 그대로” 절에서 확인합니다.
개발 서버: 프록시
개발할 때는 Vite 개발 서버(5173)가 /api 요청을 백엔드(8080)로 넘깁니다. 브라우저에는 같은 출처로 보이므로 CORS 설정이 필요 없습니다(Chapter 14의 CORS).
export default defineConfig({
plugins: [react()],
base: './',
server: { proxy: { '/api': 'http://localhost:8080' } },
})
정적 배포: base와 HashRouter
배포할 때는 빌드 결과를 Spring Boot의 static/app 아래에 넣어 /app/으로 제공합니다.
base를 상대 경로(./)로 둬야/app/아래에서 CSS와 JS를 찾습니다.- 정적 파일이라 서버가
/app/posts/3같은 경로를 모르기 때문에, 라우터는BrowserRouter대신HashRouter(/app/#/posts/3)를 썼습니다. 해시 뒤는 서버로 가지 않으므로 새로고침해도 서버가 404를 내지 않습니다(Chapter 14의 라우터).
React 테스트 31건
브라우저가 없는 Node에서 가짜 DOM(jsdom)으로 컴포넌트를 렌더링하고 fetch를 가짜로 바꿔 실행합니다. 검색하면 첫 페이지로 돌아가는지, 다음 페이지 버튼이 page=1을 요청하는지, 삭제를 취소하면 요청이 나가지 않는지처럼 사용자가 하는 동작 단위로 검증했습니다. 이후 인증 변경과 비밀번호 수정이 반영된 최종 상태에서는 React 테스트가 36건입니다.
따라 하기
cd projects/final-project/frontend
npm ci
npx vitest run
Test Files 7 passed (7)
Tests 36 passed (36)
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
컴포넌트에서 fetch 직접 호출 |
오류 처리가 흩어짐 | src/api에만 |
정적 배포에서 BrowserRouter 사용 |
새로고침 시 404 | HashRouter |
base를 절대 경로로 둠 |
/app/에서 CSS·JS 404 |
base: './' |
확인 문제
- 개발 서버의 프록시는 무엇을 해결하나요?
- 정적 배포에서
HashRouter를 쓰는 이유는 무엇인가요?
답: 1) 브라우저에게는 같은 출처로 보이게 하여 CORS 설정 없이 개발할 수 있게 합니다. 2) 서버가 /app/posts/3 같은 경로를 알지 못하므로 # 뒤 경로로 라우팅하기 위해서입니다.
직접 해 보기
- 개발 서버와 정적 배포에서 각각 같은 화면이 열리는지 확인하세요.
HashRouter를BrowserRouter로 바꾸고 새로고침하면 어떻게 되는지 시험해 보세요.base: './'를 지우고/app/에서 CSS가 로드되는지 보세요.
Swagger 문서가 코드와 맞는지 테스트하기
API 문서는 코드에서 만들어지지만, 설정 실수로 빠지는 경로가 생길 수 있습니다. 문서가 있다는 것과 문서가 맞다는 것은 다릅니다. springdoc(3.1.1)으로 /v3/api-docs와 Swagger UI를 만들고, 문서에 있어야 할 것과 없어야 할 것을 테스트로 확인합니다. (Chapter 12의 springdoc의 적용입니다.)
테스트
mvc.perform(get("/v3/api-docs"))
.andExpect(jsonPath("$.paths['/api/v1/posts']").exists())
.andExpect(jsonPath("$.paths['/api/v1/posts/{id}']").exists())
.andExpect(jsonPath("$.paths['/api/v1/users']").exists())
.andExpect(jsonPath("$.paths['/api/v1/admin/stats']").exists());
// 서버 렌더링 화면 경로는 API 문서에 나오면 안 된다
mvc.perform(get("/v3/api-docs")).andExpect(jsonPath("$.paths['/pages/posts']").doesNotExist());
코드 읽기
exists(): 핵심 API 경로가 문서에 있어야 합니다. 설정 실수로 빠지면 실패합니다.doesNotExist(): 서버 렌더링 화면 경로(/pages/posts)는 HTML을 돌려주는 화면이지 API가 아니므로 API 문서에 나오면 안 됩니다.- 이 2건이 API 문서 테스트입니다.
한계
Swagger 문서에는 오류 응답(ErrorBody)의 모양이 나오지 않습니다. 확인했을 뿐 개선하지는 않았습니다. 또 Swagger UI와 API 문서는 누구나 열 수 있도록 두었습니다(아래 “인증을 바꿔도 서비스는 그대로” 절의 인가 규칙).
따라 하기
./gradlew :projects:final-project:test --tests '*OpenApiTests*'
재검증에서 2건이 통과했습니다(있어야 하는 경로 / 없어야 하는 경로).
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
| 서버 렌더링 화면 경로가 API 문서에 나옴 | 문서가 HTML 화면을 API로 오해하게 함 | doesNotExist() 테스트로 고정 |
| 핵심 경로가 문서에서 빠짐 | 소비자가 API를 못 찾음 | exists() 테스트 |
| 오류 응답 모양이 문서에 안 나오는 것을 몰랐음 | 클라이언트가 오류 모양을 추측 | 한계로 인지하고 보완 계획 |
확인 문제
- 문서(OpenAPI)에 대해 이 절이 테스트로 확인하는 두 가지는 무엇인가요?
- 이 문서에서 확인되지 않는 것은 무엇인가요?
답: 1) 문서에 있어야 하는 경로와, 문서에 나오면 안 되는 경로입니다. 2) 오류 응답의 모양은 이 문서에 나오지 않습니다.
직접 해 보기
/swagger-ui.html에서 요청을 직접 보내 보세요.- 새 API를 추가하고 문서에 반영되는지, 테스트에 한 줄 더하면 어떻게 되는지 해 보세요.
- 오류 응답을 문서에 나타내려면 어떻게 해야 할지 조사해 보세요.
화면 단계에서 자주 만나는 오류
화면 쪽 실수는 서버 오류 없이 보안 구멍이나 틀린 화면으로 나타납니다. 아래는 이 프로젝트의 posts/detail.html 템플릿을 일부러 바꿔 서버 테스트를 돌려 얻은 결과입니다. 바꾼 코드는 되돌렸고 저장소에는 올리지 않았습니다.
1. th:utext로 바꾸면 XSS 테스트가 잡는다
원고 작성 시 글 상세 화면의 본문을 th:text에서 th:utext로 바꿨습니다. 본문에 들어온 <img src=x onerror=...>가 HTML로 해석되는 형태입니다. 당시 실행한 서버 테스트 88건 중 1건이 실패했습니다. 재검증에서는 Oracle 13건을 실행하지 않았으므로 이 변경 실험을 다시 수행하지 않았습니다.
htmlInTitleAndContentIsEscaped()
java.lang.AssertionError:
Expecting actual:
"<!DOCTYPE html> ...
테스트가 응답 HTML에서 <img src=x가 사라지고 <img src=x로 바뀐 것을 확인하기 때문에 잡혔습니다. th:utext는 글자 그대로 HTML을 넣으므로 사용자 입력에 쓰면 안 됩니다.
2. 같은 실수가 테스트를 빠져나간 곳
원고 작성 시 같은 실수를 상세 화면의 제목(<h1 th:text="${post.title()}">)에 만들어 봤더니 서버 테스트 88건이 모두 통과했습니다. 재검증에서 다시 수행한 실험은 아닙니다.
(원문 작성 시 실패 없음) 서버 테스트 88건 통과
이 프로젝트의 테스트가 상세 화면에서는 본문만 검사하고 제목은 검사하지 않기 때문입니다(제목은 목록 화면에서만 검사합니다). 테스트가 “이스케이프를 확인한다”고 해도 어느 화면의 어느 필드까지인지는 코드를 읽어야 압니다. 이 한계는 코드를 바꾸지 않고 그대로 남겼고, 상세 화면 제목도 검사하려면 테스트에 한 줄을 더하면 됩니다. 추가하지는 않았습니다.
3. 화면은 맞는데 데이터 형식이 다르다
서버 렌더링 화면(Thymeleaf)과 React 화면은 같은 서비스를 쓰지만 오류를 다루는 방식이 다릅니다. Thymeleaf는 오류 페이지(404, 400)를 서버가 HTML로 그려 주고, React는 JSON 오류 응답을 받아 화면이 직접 보여 줍니다. 한쪽에서만 오류가 이상하게 보이면 어느 쪽이 그리는지부터 구분합니다.
| 증상 | 가장 먼저 볼 것 |
|---|---|
| 입력한 HTML이 화면에서 실행됨 | 사용자 입력 자리의 th:utext, dangerouslySetInnerHTML |
| 이스케이프 테스트가 있는데 구멍이 있음 | 테스트가 검사하는 화면과 필드의 범위 |
| 한 화면에서만 오류 모양이 다름 | 서버 렌더링인지 React인지 |
출력 지점 점검표 예시
| 출력 지점 | 이스케이프 방식 | 테스트 |
|---|---|---|
| 목록의 제목 | th:text |
있음 |
| 상세의 제목 | th:text |
없음 (사각) |
| 상세의 본문 | th:text |
있음 |
| React 본문 | {값} |
있음 |
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
| 테스트 통과를 안전의 증거로 봄 | 검사하지 않은 곳에 구멍 | 출력 지점 표와 테스트 대조 |
한 곳에서만 th:utext 검색 |
다른 템플릿의 오용을 놓침 | 소스 전체 검색 |
직접 해 보기
- 상세 화면 제목에
th:utext를 넣고 테스트가 통과하는지 확인한 뒤, 제목을 검사하는 테스트 한 줄을 더해 보세요. - 모든 사용자 입력 출력 지점을 목록으로 만들고 각각 테스트가 있는지 표로 정리해 보세요.
- 소스 전체에서
th:utext/dangerouslySetInnerHTML을 검색해 보세요.
인증을 바꿔도 서비스는 그대로
Chapter 23에서 서비스는 Actor(사용자 ID와 역할)만 받도록 만들었습니다. 그 덕에 임시 헤더(X-User-Id)에서 HTTP Basic으로 바꿀 때 고친 곳은 CurrentActor 한 클래스였고, 서비스와 검색 코드는 한 줄도 건드리지 않았습니다. 이 절은 그 경계와, “열 곳을 나열하고 나머지는 닫는” 인가 규칙을 봅니다.
CurrentActor
Actor require() {
Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
if (authentication != null && authentication.getPrincipal() instanceof AppUserDetails user) {
return new Actor(user.id(), user.role());
}
throw new UnauthorizedException("로그인이 필요합니다");
}
Spring Security의 인증 객체를 Actor로 바꾸는 곳이 여기 한 곳입니다. 서비스는 Actor만 압니다.
경계를 구조 테스트로 고정
| 규칙 | 의미 |
|---|---|
post는 Spring Security를 모른다 |
서비스가 인증 방식에 묶이지 않습니다 |
SecurityContextHolder는 security와 web만 쓴다 |
보안 객체가 여기저기 퍼지지 않습니다 |
security는 post와 user.internal을 모른다 |
보안 설정이 업무 구현에 묶이지 않습니다 |
Chapter 23의 구조 테스트와 같은 방식입니다. 설계에서 정한 경계가 마지막에 인증을 바꿀 때 변경 범위를 실제로 줄여 주었습니다.
인가 규칙은 열 곳을 나열하고 나머지는 닫는다
.authorizeHttpRequests(auth -> auth
.requestMatchers(HttpMethod.POST, "/api/v1/users").permitAll()
.requestMatchers(HttpMethod.GET, "/api/v1/posts", "/api/v1/posts/*").permitAll()
.requestMatchers("/", "/pages/**", "/app/**", "/css/**").permitAll()
.requestMatchers("/swagger-ui.html", "/swagger-ui/**", "/v3/api-docs/**").permitAll()
.requestMatchers("/actuator/health", "/actuator/health/**").permitAll()
.requestMatchers("/actuator/**").hasRole("ADMIN")
.requestMatchers("/api/v1/admin/**").hasRole("ADMIN")
.anyRequest().authenticated())
마지막 줄이 핵심입니다. 새 경로를 추가하고 규칙을 깜빡해도 공개되지 않고 로그인을 요구합니다. 반대로 “막을 것을 나열하고 나머지는 허용”하는 방식은 깜빡하는 순간 열립니다. 테스트가 이를 확인합니다. 규칙에 없는 /internal/anything은 존재하지 않는 경로인데도 404가 아니라 401을 먼저 받습니다.
인가는 두 층입니다. 필터가 “로그인했는가, 관리자인가”를 보고, “내 글인가”는 글을 읽어야 알 수 있으므로 서비스가 판단합니다(Chapter 21의 데이터별 권한과 같은 이유).
따라 하기
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8080/nothing-here
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8080/actuator/health
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8080/actuator/metrics
401 (규칙에 없는 경로 → anyRequest().authenticated())
200 (명시적으로 열어 둔 경로)
401 (관리자 전용, 비로그인)
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
| 허용할 곳이 아니라 막을 곳을 나열 | 새 경로가 기본 공개 | 열 곳을 나열하고 anyRequest().authenticated() |
SecurityContextHolder를 여기저기서 호출 |
인증 방식 교체가 어려움 | CurrentActor 한 곳 |
| 서비스가 Spring Security 타입을 앎 | 인증 방식에 묶임 | 서비스는 Actor만 |
확인 문제
- “기본 거부”란 무엇인가요?
- 필터와 서비스는 인가를 각각 무엇으로 판단하나요?
답: 1) 규칙에 없는 요청은 로그인을 요구하고 막히는 방식입니다. 2) 필터는 로그인 여부와 역할을, 서비스는 “내 글인가” 같은 데이터에 따른 규칙을 판단합니다.
직접 해 보기
CurrentActor외 어디서SecurityContextHolder를 쓰는지 검색해 구조 규칙과 대조해 보세요.- 새 경로를 만들고 규칙을 일부러 빼먹어 401이 나는지 확인하세요.
permitAll목록에서 정말 공개해야 하는지 의문스러운 항목을 골라 보세요.
401 응답과 보안 테스트
HTTP Basic에서 서버가 401과 함께 WWW-Authenticate: Basic 헤더를 보내면 브라우저가 자체 로그인 창을 띄웁니다. React 화면의 로그인 흐름을 가리기 때문에 이 헤더를 싣지 않았습니다. 이 절은 그 처리와, 규칙을 하나씩 못 박는 보안 테스트 11건을 봅니다. (Chapter 21에서 WWW-Authenticate 유무를 관찰했던 것의 적용입니다.)
401 본문을 직접 쓴다
본문을 컨트롤러가 내는 오류와 같은 모양(ErrorBody)으로 직접 썼습니다. 필터 단계에서 난 예외는 @RestControllerAdvice에 닿지 않기 때문입니다.
write(response, HttpStatus.UNAUTHORIZED,
ErrorBody.of("UNAUTHORIZED", "로그인이 필요하거나 아이디 또는 비밀번호가 올바르지 않습니다"));
메시지에서 “필요하거나 … 올바르지 않습니다”로 두 경우를 한 문장에 묶은 것도 의도입니다. 없는 아이디와 틀린 비밀번호의 응답이 다르면 어떤 아이디가 존재하는지 알아낼 수 있습니다. 두 응답 본문이 완전히 같은지는 테스트가 문자열로 비교합니다.
보안 테스트 11건
SecurityTests는 규칙을 하나씩 못 박습니다.
| 확인 | 결과 |
|---|---|
글 읽기, 서버 렌더링 화면, API 문서, /actuator/health |
로그인 없이 200 |
| 글 작성·삭제 | 로그인 없으면 401 |
| 401 응답 | WWW-Authenticate 헤더 없음 |
| 없는 아이디와 틀린 비밀번호 | 응답 본문이 같음 |
/api/v1/admin/stats |
비로그인 401, 일반 회원 403, 관리자 200 |
/actuator/metrics |
같은 순서로 401, 403, 200 |
/actuator/env, /actuator/beans |
관리자도 404 (노출하지 않음) |
/actuator/health의 세부 항목(DB 등) |
비로그인에는 안 보이고 관리자에게만 보임 |
| 규칙에 없는 경로 | 401 |
| 응답 헤더 | X-Content-Type-Options: nosniff, X-Frame-Options: DENY, Cache-Control: no-store 포함 |
/users/me 응답 |
비밀번호나 해시가 들어 있지 않음 |
Chapter 22의 Actuator에서는 인증 없이 열었던 엔드포인트를 이제 관리자 전용으로 닫았습니다. 이 표의 11행이 11건과 일대일로 대응하는 것은 아니며, 정확한 대응은 테스트 코드를 보세요.
CSRF를 끈 이유
CSRF 보호는 껐습니다. 이 프로젝트의 React 화면은 쿠키 세션 없이 Authorization 헤더를 코드로 직접 실어 보내므로, 브라우저가 자동으로 붙이는 쿠키를 노린 CSRF가 성립하지 않는다고 보고 내린 선택입니다. 기준은 “세션이 없는가”가 아니라 브라우저가 자격 증명을 요청에 자동으로 붙이는가입니다. 그래서 쿠키로 로그인 상태를 유지하는 방식으로 바꾸거나, 브라우저가 Basic 자격 증명을 기억해 자동 전송하게 되면 반드시 CSRF를 다시 검토해야 합니다. 브라우저 공격을 재현해 확인한 것은 아닙니다. (Chapter 21의 CSRF 오류를 다시 보세요.)
따라 하기
curl -s -u nobody:xxxxxxxx http://localhost:8080/api/v1/users/me
curl -s -u kor24:wrongpass1 http://localhost:8080/api/v1/users/me
curl -s -i http://localhost:8080/pages/posts | grep -i 'x-content-type\|x-frame\|cache-control'
{"code":"UNAUTHORIZED","message":"로그인이 필요하거나 아이디 또는 비밀번호가 올바르지 않습니다","issues":[]}
{"code":"UNAUTHORIZED","message":"로그인이 필요하거나 아이디 또는 비밀번호가 올바르지 않습니다","issues":[]}
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
없는 아이디와 틀린 비밀번호의 응답이 같아서 아이디 존재 여부를 알 수 없습니다. 비로그인 /actuator/env·beans·metrics는 모두 401이었고(위 표의 “관리자도 404”는 관리자로 요청했을 때의 이야기이며 재검증에서는 관리자 계정으로 확인하지 않았습니다), 비로그인 /actuator/health는 {"groups":["liveness","readiness"],"status":"UP"}만 보여 세부 항목이 노출되지 않았습니다.
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
| 필터 단계의 401을 기본 응답으로 둠 | 컨트롤러 오류와 모양이 다름 | ErrorBody로 직접 작성 |
| 아이디 없음/비밀번호 틀림 메시지를 다르게 함 | 아이디 존재 여부 노출 | 한 문장으로 묶음 |
WWW-Authenticate: Basic 헤더를 보냄 |
브라우저 자체 로그인 창이 뜸 | 이 프로젝트는 헤더를 보내지 않음 |
확인 문제
- 로그인 실패 응답을 같게 하는 이유는 무엇인가요?
- 이 프로젝트가 CSRF를 끈 이유는 무엇인가요?
답: 1) 공격자가 아이디의 존재 여부를 알아내지 못하게 하기 위해서입니다. 2) 쿠키 세션 없이 Authorization 헤더를 코드로 직접 실어 브라우저가 자격 증명을 자동 전송하지 않는다고 보았기 때문입니다. 세션이 없다는 사실만으로 충분한 것은 아닙니다.
직접 해 보기
- 없는 아이디와 틀린 비밀번호로 각각 요청해 응답 본문이 같은지 비교하세요.
WWW-Authenticate헤더를 일부러 넣고 브라우저의 로그인 창이 뜨는지 확인해 보세요(이 프로젝트는 브라우저에서 확인하지 못했습니다).- 관리자 전용 경로 하나를 골라 비로그인, 일반 회원, 관리자의 응답을 표로 만들어 보세요.
500 오류의 원인: 글자 수와 바이트 수
이 절은 머리말에서 소개한 문제, 즉 “비밀번호는 72자 이하”라는 검증을 통과한 한글 서른 글자 비밀번호가 500 오류를 낸 원인을 찾고, 재현 테스트를 먼저 쓴 뒤 고친 과정입니다. (Chapter 23에서 남겨 둔 이야기입니다.)
원인
로그의 원인은 한 줄이었습니다.
java.lang.IllegalArgumentException: password cannot be more than 72 bytes
bcrypt는 비밀번호를 72바이트까지만 받습니다. 그런데 @Size(max = 72)는 글자 수를 셉니다. UTF-8에서 한글은 글자당 3바이트이므로 한글 25자부터는 75바이트라 @Size는 통과하지만 bcrypt가 예외를 던져 500이 됩니다. 영문만 썼다면 드러나지 않았을 문제입니다.
| 입력 | 글자 수 | 바이트 수 | @Size(max=72) |
bcrypt |
|---|---|---|---|---|
| 영문 72자 | 72 | 72 | 통과 | 통과 |
| 한글 24자 | 24 | 72 | 통과 | 통과 |
| 한글 25자 | 25 | 75 | 통과 | 예외 → 500 |
재현 테스트부터
이 문제는 예제 저장소의 PR #14 병합 뒤 문서를 정리하며 가정을 검증하다 발견했습니다. 재현 테스트부터 썼고, 수정 전에는 400이어야 할 요청이 500으로 실패했습니다. 수정은 PR #15로 분리했습니다.
해결: 바이트를 세는 검증
@Constraint(validatedBy = MaxBytesValidator.class)
public @interface MaxBytes { int value(); ... }
public class MaxBytesValidator implements ConstraintValidator<MaxBytes, CharSequence> {
public boolean isValid(CharSequence value, ConstraintValidatorContext context) {
return value == null || value.toString().getBytes(StandardCharsets.UTF_8).length <= max;
}
}
// SignupRequest
@NotBlank @Size(min = 8, max = 72) @MaxBytes(72) String password
수정 뒤 한글 24자(72바이트)는 가입하고 로그인되며, 25자는 password 필드 오류와 함께 400을 받습니다. 영문 72자와 73자의 경계도 테스트합니다. 가입 화면에도 “한글은 24자까지”라고 안내를 넣었습니다.
두 번째 오류
처음에 public을 붙이지 않은 검증기 클래스는 실행 시 HV000064: Unable to instantiate ConstraintValidator로 실패해서 public으로 열었습니다.
교훈
이번 단계에서 가장 값어치 있었던 것은 기능이 아니라 가정을 의심한 순간이었습니다. “72자 이하”라고 적어 둔 검증이 실제로는 글자와 바이트를 혼동하고 있었고, 영문으로만 시험했다면 평생 드러나지 않았을 겁니다. 입력 상한을 정할 때는 그 값이 무엇의 단위인지를 확인합니다.
데모 계정의 비밀번호는 코드에 없다
화면을 바로 볼 수 있게 데모 계정(admin, alice, bob)을 만드는 기능이 있지만, 기본으로 꺼져 있고 비밀번호의 기본값도 없습니다.
if (demoPassword == null || demoPassword.length() < 8) {
throw new IllegalStateException("app.seed-demo-data=true이면 DEMO_PASSWORD(8자 이상)를 지정해야 합니다");
}
SEED_DEMO_DATA=true인데 DEMO_PASSWORD를 안 주고 컨테이너를 띄우면 위 메시지를 남기고 시작하지 않는 것을 직접 확인했습니다. CI에서는 실행할 때마다 무작위 값을 만들어 로그에 가립니다. 비밀번호 기본값을 코드에 두지 않는 이유는 Chapter 21의 학습용 계정 설명과 같습니다.
따라 하기
K24=$(python3 -c "print('가'*24)"); K25=$(python3 -c "print('가'*25)")
curl -s -o /dev/null -w '%{http_code}\n' -X POST http://localhost:8080/api/v1/users -H 'Content-Type: application/json' \
-d "{\"username\":\"kor24\",\"password\":\"$K24\",\"displayName\":\"a\"}"
curl -s -w '\n%{http_code}\n' -X POST http://localhost:8080/api/v1/users -H 'Content-Type: application/json' \
-d "{\"username\":\"kor25\",\"password\":\"$K25\",\"displayName\":\"a\"}"
201 (한글 24자 = 72바이트)
{"code":"VALIDATION_FAILED",...,"issues":[{"field":"password","reason":"UTF-8 기준 72바이트를 넘을 수 없습니다 (한글은 글자당 3바이트)"}]}
400 (한글 25자 = 75바이트)
24자로 가입한 계정은 같은 비밀번호로 로그인(/users/me)이 200이었습니다.
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
| 글자 수 상한을 바이트 상한으로 착각 | 한글 25자에서 500 | @MaxBytes로 바이트 검증 |
검증기 클래스가 public이 아님 |
HV000064 (인스턴스화 실패) |
public 클래스 |
| 재현 테스트 없이 수정 | 고쳐졌는지 확신 못 함 | 재현 테스트 → 수정 → 경계(24/25자) 테스트 |
확인 문제
- 한글 25자의 바이트 수는 얼마인가요?
@Size(max = 72)만으로 부족한 이유는 무엇인가요?
답: 1) UTF-8 기준 75바이트입니다. 2) @Size는 글자 수를 세는데 bcrypt는 72바이트까지만 받기 때문입니다.
직접 해 보기
- 한글 24자와 25자로 가입해 응답 상태를 확인하세요.
@MaxBytes를 빼고 25자로 가입해 500을 재현해 보세요.- 자신의 프로젝트에서 길이 상한을 정한 입력과, 그 상한이 글자인지 바이트인지 점검하세요.
한 이미지로 묶고 스모크 테스트와 CI 숫자
마지막으로 화면과 서버를 한 이미지로 묶고, 그 이미지가 실제로 뜨는지 스모크 테스트로 확인합니다. Chapter 22의 Dockerfile, compose, CI가 종합 프로젝트에서 어떻게 합쳐지는지 봅니다.
3단계 Dockerfile
| 단계 | 하는 일 |
|---|---|
| 1. frontend | npm ci, npm run build |
| 2. build | React 결과를 static/app에 넣고 bootJar, 계층(layer)으로 풀기 |
| 3. 실행 | JRE만, root가 아닌 사용자(uid 10001), 헬스체크 |
Chapter 22의 멀티 스테이지에 프런트 빌드 단계가 하나 앞에 붙은 형태입니다. 테스트는 이미지를 만들 때 돌리지 않습니다. CI의 build 잡이 이미 돌렸고, 이미지 잡은 “이 이미지가 실제로 뜨는가”를 확인합니다.
스모크 테스트
스크립트는 Chapter 22의 것과 같은 원칙으로, 응답 코드뿐 아니라 내용을 봅니다. 실제 CI 로그입니다.
readiness UP after about 6s
/pages/posts ok
/app/index.html ok
signup/login ok
security ok
post create/search ok
SMOKE TEST PASSED
| 줄 | 확인한 것 |
|---|---|
/app/index.html ok |
React 빌드가 실제로 이미지에 들어 있음 (id="root"가 있는지로만 확인. 스크립트가 브라우저에서 실행되지는 않음) |
signup/login ok |
가입과 로그인 |
security ok |
비로그인 쓰기 401, 일반 회원의 관리자 API 403, 틀린 비밀번호 401, 비로그인 /actuator/metrics 401 |
post create/search ok |
글을 쓴 뒤 방금 붙인 태그로 검색해 다시 찾는 흐름. 데이터베이스와 검색 SQL까지 거침 |
CI 결과는 로그에서 직접 센다
수정(PR #15)까지 반영한 최종 CI 로그에서 센 값입니다.
| 잡 | 통과 | 건너뜀 | 실패 |
|---|---|---|---|
build |
497 | 33 | 0 |
oracle |
126 | 0 | 0 |
frontend (종합 프로젝트) |
36 | - | 0 |
image (종합 프로젝트 스모크) |
통과 | - | - |
종합 프로젝트의 서버 테스트는 88건입니다. 이 중 Oracle이 필요한 13건은 build 잡에서 건너뛰고(build의 건너뜀 33건에 포함), oracle 잡에서 건너뜀 없이 통과했습니다. Chapter 22의 PR #13 시점 build 통과 422건에서 497건으로 늘어난 75건이 종합 프로젝트 서버 테스트 중 Oracle이 아닌 건수(88건에서 Oracle 13건을 뺀 값)와 맞습니다. 비밀번호 수정(PR #15) 전 PR #14의 값은 build 494건, oracle 123건이었습니다.
로컬에서 못 돌린 것
원고 작성 당시에는 Docker 안에서 Gradle을 실행하는 3단계 빌드를 그 환경에서 끝까지 돌리지 못했습니다. 기본 네트워크에서는 Gradle 배포판 다운로드가 타임아웃(failed: timeout (10000ms)), --network host에서는 Could not connect to the Gradle daemon으로 실패했습니다. 코드 문제가 아니라 환경 제약이며, 같은 Dockerfile이 GitHub Actions에서는 빌드·실행·스모크 테스트를 통과했습니다. 로컬에서는 JAR를 먼저 만든 뒤 실행 단계만 이미지로 만들어 컨테이너가 뜨는지 확인했습니다(스모크 통과, healthy, uid 10001, SEED_DEMO_DATA=true에 비밀번호가 없으면 시작 거부). Chapter 20의 로컬 한계와 같은 종류의 사정입니다.
재검증에서 로컬로 끝까지 돌린 결과
docker build -f projects/final-project/Dockerfile -t final-project:local .
docker run -d --name fp-app -p 18087:8080 final-project:local
projects/final-project/smoke-test.sh http://localhost:18087 60
| 단계 | 결과 |
|---|---|
| 3단계 빌드 | 성공, 약 2분 46초 |
| 헬스 체크 | 약 18초 안에 healthy |
| 사용자 | uid=10001(app) |
| 스모크 테스트 | readiness UP after about 0s, /pages/posts ok, /app/index.html ok, signup/login ok, security ok, post create/search ok, SMOKE TEST PASSED |
위 “로컬에서 못 돌린 것”과 달리 재검증 환경에서는 기본 네트워크로 끝까지 돌았습니다. 같은 Docker 안 Gradle 빌드가 네트워크 상태에 따라 실패하기도 하므로(Chapter 22의 ch32-docker 이미지 빌드는 첫 시도에 실패하고 재시도에 성공했습니다) 환경 의존적인 항목으로 분류해 둡니다.
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
| 빌드 컨텍스트를 모듈 폴더로 지정 | COPY 경로를 찾지 못함 |
저장소 루트에서 -f로 Dockerfile 지정 |
| 스모크 테스트가 한 흐름만 확인 | 이미지에 빠진 파일을 놓침 | /app/index.html, 가입·로그인, 보안, 검색까지 |
| CI 숫자를 초록색으로 대체 | 건너뛴 테스트를 놓침 | 로그에서 통과·건너뜀·실패를 직접 셈 |
확인 문제
- 3단계 빌드에서 React 빌드 결과는 어디에 들어가나요?
- 스모크 테스트가
/app/index.html에서 확인하는 것은 무엇인가요?
답: 1) 서버 빌드 단계에서 static/app 아래로 복사되어 한 JAR에 묶입니다. 2) 응답에 id="root"가 있는지, 즉 React 빌드 결과가 이미지에 들어 있는지입니다.
직접 해 보기
- 스모크 테스트에서
post create/search가 실패하도록 태그 검색 SQL을 일부러 깨 보세요(주의: 되돌리세요). - CI 로그에서
build/oracle/frontend의 통과 건수를 직접 세어 위 표와 비교하세요. - 스모크 테스트에 자신의 서비스의 가장 중요한 흐름 한 가지를 추가해 보세요.
한계와 이 과정을 마치며
종합 프로젝트와 Spring Boot 과정 전체를 마무리하는 절입니다. 만든 것과, 만들지 않았거나 확인하지 못한 것을 정리하고 과정 전체를 돌아봅니다.
만든 것
- 서버 렌더링 읽기 화면과 React 쓰기 화면, XSS 방지 테스트, Swagger 문서 테스트.
CurrentActor한 클래스로 바꾼 HTTP Basic 인증, 기본 거부 인가, 보안 테스트 11건.- 글자 수와 바이트 수 문제의 재현과 수정(
@MaxBytes). - 3단계 이미지와 스모크 테스트, 서버 H2 테스트 75건·React 36건을 재검증에서 확인. Oracle 테스트 13건은 원고 작성 시 CI 기록만 확인.
한계와 확인하지 않은 것
| 영역 | 항목 | 상태 |
|---|---|---|
| 보안 | HTTPS(TLS) | 만들지 않음. HTTP Basic은 TLS 없이는 자격 증명이 읽힘 |
| 보안 | 로그인 시도 횟수 제한, 계정 잠금 | 없음 (무차별 대입을 막지 못함) |
| 보안 | Authorization 값을 sessionStorage에 보관 |
같은 출처 스크립트가 읽을 수 있음. 토큰·HttpOnly 쿠키 방식과 비교하지 않음 |
| 보안 | Content-Security-Policy | 설정하지 않음 |
| 보안 | Swagger UI·API 문서 | 누구나 열 수 있음 |
| 화면 | 실제 브라우저, 레이아웃, 모바일, 접근성 | 확인하지 못함 |
| 화면 | 상세 화면 제목의 이스케이프 테스트 | 추가하지 않음 (사각으로 남김) |
| 화면 | Swagger 문서의 오류 응답 모양 | 나오지 않음 |
| 화면 | 목록 정렬 변경, 낙관적 락, 파일 첨부 | 다루지 않음 |
| 배포 | 이미지 층 캐시의 효과 | 비교하지 않음 |
| 배포 | 레지스트리 배포, Oracle을 함께 띄우는 compose | 만들지 않음 |

과정을 돌아보며
- 설계의 가치는 그림이 아니라 깨지면 실패하는 규칙이었습니다. 구조 테스트 한 줄이 마지막까지 한 번도 고쳐지지 않고 변경 범위를 줄였습니다(Chapter 23).
- 통과는 증거가 아닙니다. 규칙을 지우거나 틀리게 고쳐서 테스트가 실패하는지 직접 보았습니다(Chapter 19, 21).
- 확인하지 않은 것은 확인하지 않았다고 썼습니다. 로컬에서 못 돌린 테스트, 측정하지 않은 성능, 만들지 않은 기능을 각 Chapter의 한계에 남겼습니다.
- 가정을 의심하는 순간이 가장 값어치 있었습니다. “72자 이하” 검증이 글자와 바이트를 혼동했던 것처럼, 영문으로만 시험했다면 드러나지 않았을 문제가 있었습니다.
다음에 해 볼 것
- HTTPS를 붙이고 인증을 토큰 기반이나 쿠키 세션과 비교해 보세요.
- 실제 브라우저와 모바일에서 화면을 열어 보고 접근성을 점검해 보세요.
- 배포(CD)를 만들고, 레지스트리와 환경별 승인을 연습해 보세요.
- 처음부터 자신의 요구사항으로 이 흐름(범위 정하기 → 구조 테스트 → 두 DB → 화면 → 보안 → 이미지)을 한 번 더 돌려 보세요.
재검증에서 직접 확인한 것과 못 한 것
| 항목 | 재검증 |
|---|---|
| 서버 테스트(H2) 75건, 3단계 이미지 빌드·기동·스모크, React 36건 | 직접 실행 |
| Oracle 테스트 13건, GitHub Actions, 실제 브라우저·모바일·접근성 | 실행하지 못함 |
관리자 계정으로 /actuator/env·beans가 404인지 |
확인하지 않음 |
직접 해 보기
- 위 한계 표에서 하나를 골라 보완 계획을 세워 보세요.
- 이 과정의 각 Chapter “용어와 참고 자료” 절을 훑어 낯선 용어가 남아 있는지 점검하세요.
- Chapter 01의 첫
GET /hello부터 여기까지의 여정을 한 장으로 그려 보세요.
용어와 참고 자료
Chapter 24의 용어를 모았습니다. 보안 용어는 Chapter 21 용어 정리, Docker와 CI는 Chapter 22 용어 정리도 참고하세요.
용어
| 용어 | 설명 | 나온 곳 |
|---|---|---|
| 서버 렌더링 | 서버가 완성된 HTML을 만들어 보내는 방식입니다. | 화면을 나누는 기준: 두 컨트롤러, 서비스는 하나 |
| XSS | 다른 사람이 쓴 글에 심은 스크립트가 내 화면에서 실행되는 공격입니다. | 사용자 입력이 HTML로 해석되지 않는지 확인하기 |
| 이스케이프 | <를 <로 바꿔 HTML이 아니라 글자로 보이게 하는 처리입니다. |
사용자 입력이 HTML로 해석되지 않는지 확인하기 |
| 프록시(개발 서버) | 개발 서버가 특정 경로의 요청을 다른 서버로 대신 전달하는 기능입니다. | React 화면의 구조와 두 가지 배포 설정 |
| HashRouter | 주소의 # 뒤 부분으로 화면 경로를 정하는 라우터입니다. 서버가 경로를 몰라도 새로고침이 됩니다. |
React 화면의 구조와 두 가지 배포 설정 |
| jsdom | 브라우저 없이 Node에서 DOM을 흉내 내는 환경입니다. | React 화면의 구조와 두 가지 배포 설정 |
/v3/api-docs |
springdoc이 만드는 OpenAPI 문서의 경로입니다. | Swagger 문서가 코드와 맞는지 테스트하기 |
| 기본 거부 | 허용한다고 적은 것만 열고 나머지는 닫는 규칙 작성 방식입니다. | 인증을 바꿔도 서비스는 그대로 |
| HTTP Basic | 요청마다 아이디:비밀번호를 Base64로 인코딩해 Authorization 헤더에 싣는 인증 방식입니다. |
401 응답과 보안 테스트 |
WWW-Authenticate |
401과 함께 보내 브라우저가 로그인 창을 띄우게 하는 응답 헤더입니다. | 401 응답과 보안 테스트 |
| bcrypt | 비밀번호를 느리게 해시하도록 설계된 알고리즘으로, 입력을 72바이트까지만 받습니다. | 500 오류의 원인: 글자 수와 바이트 수 |
@MaxBytes |
문자열의 UTF-8 바이트 수를 제한하는 이 프로젝트의 검증 어노테이션입니다. | 500 오류의 원인: 글자 수와 바이트 수 |
| 스모크 테스트 | 배포된 것이 기본적으로 동작하는지 빠르게 확인하는 최소한의 점검입니다. | 한 이미지로 묶고 스모크 테스트와 CI 숫자 |
| 멀티 스테이지 빌드 | 빌드 도구가 든 단계와 실행만 하는 단계를 나눠 최종 이미지를 작게 만드는 방식입니다. | 한 이미지로 묶고 스모크 테스트와 CI 숫자 |
참고 자료
- Thymeleaf - Using Thymeleaf:
th:text와th:utext의 차이, 이스케이프 규칙을 확인했습니다. - React - Common components:
dangerouslySetInnerHTML이 왜 위험한지 설명을 확인했습니다. - Vite - Server options:
server.proxy설정을 확인했습니다. - React Router - HashRouter: 해시 기반 라우팅의 동작을 확인했습니다.
- springdoc-openapi:
/v3/api-docs와 Swagger UI 경로를 확인했습니다. - Spring Security - Authorize HttpServletRequests:
requestMatchers순서와anyRequest()의 역할을 확인했습니다. - Spring Security - Basic Authentication: Basic 인증 흐름과
AuthenticationEntryPoint를 확인했습니다. - Spring Security - Password Storage:
{bcrypt}접두사로 알고리즘을 구분하는 방식을 확인했습니다. - Spring Security - CSRF: CSRF 보호를 끄는 조건에 대한 설명을 확인했습니다.
- Spring Boot - Endpoints (Actuator): 노출할 엔드포인트와 헬스 세부 정보 공개 범위 설정을 확인했습니다.
- Spring Boot - Efficient Container Images: 계층(layer)으로 풀어 이미지 캐시를 살리는 방법을 확인했습니다.
- Docker - Multi-stage builds: 빌드 단계와 실행 단계를 나누는 방법을 확인했습니다.
직접 해보기
/pages/posts와/api/v1/posts에 같은 검색어를 주고 결과가 같은지 비교해 보세요.curl -s -i -H 'Accept: text/html' http://localhost:8080/pages/posts/9999로 화면용 404 페이지가 오는지 확인한 뒤,PageController의@ExceptionHandler를 지우면 어떻게 달라지는지도 봅니다.- 상세 화면 제목의
th:text를th:utext로 바꾸고 서버 테스트가 모두 통과하는 사각을 직접 확인하세요. 그다음 상세 화면 제목을 검사하는 테스트를 한 줄 더해 같은 변경에서 실패하는지 보고, 소스 전체에서th:utext와dangerouslySetInnerHTML을 검색해 봅니다. - 로그인하지 않은 상태에서
curl -s -o /dev/null -w '%{http_code}\n'으로/nothing-here,/actuator/health,/actuator/metrics를 요청해 401, 200, 401이 나오는지 확인하세요.-u nobody:xxxxxxxx처럼 없는 아이디와 틀린 비밀번호로/api/v1/users/me를 요청해 두 응답 본문이 같은지도 비교합니다. - 한글 24자와 25자 비밀번호로 가입해 201과 400이 나오는지 확인하세요.
@MaxBytes를 빼고 25자로 다시 가입해 500을 재현해 보고, 자신의 프로젝트에서 길이 상한이 글자 기준인지 바이트 기준인지 점검합니다. - 저장소 루트에서
docker build -f projects/final-project/Dockerfile -t final-project:local .로 이미지를 만들어 띄우고projects/final-project/smoke-test.sh http://localhost:18087 60을 실행해 보세요. 태그 검색 SQL을 일부러 깨면post create/search에서 실패하는지 확인한 뒤 반드시 되돌립니다.
이번 장의 정리
- 읽기 화면(
/pages/posts)은 Thymeleaf, 입력이 많은 쓰기 화면(/app/)은 React가 맡고,PageController와PostController는 같은PostApi.search를 부릅니다.PageController안의@ExceptionHandler가 화면용 오류를 HTML 페이지로 돌려줍니다. - 사용자 입력은
th:text와 React의 기본 출력으로만 넣고, 원문 태그가 없고(doesNotContain) 이스케이프된<가 있는지(contains) 함께 검사합니다. 다만 상세 화면 제목은 테스트가 검사하지 않는 사각으로 남아 있어, 테스트가 어느 화면의 어느 필드까지 보는지 확인해야 합니다. - React 화면은
fetch를src/api에, 로그인 상태를session.js에 모읍니다. 개발 중에는 Vite 프록시로 CORS 없이 백엔드를 부르고, 배포할 때는base: './'와HashRouter로/app/아래에서 동작하게 합니다. - Swagger 문서는 있어야 할 경로(
exists())와 없어야 할 경로(doesNotExist())를 테스트로 확인합니다. 오류 응답 모양은 문서에 나오지 않는 한계로 남았습니다. - 임시 헤더 인증을 HTTP Basic으로 바꿀 때 고친 곳은
CurrentActor한 클래스였고 서비스는 그대로였습니다. 인가는 열 곳만 나열하고anyRequest().authenticated()로 나머지를 닫는 기본 거부이며, “내 글인가”는 서비스가 판단합니다. - 401 본문은
ErrorBody모양으로 직접 쓰고WWW-Authenticate헤더를 보내지 않으며, 없는 아이디와 틀린 비밀번호의 응답을 같게 둡니다. 보안 테스트 11건이 이 규칙들을 고정하고, CSRF는 브라우저가 자격 증명을 자동으로 붙이는지를 기준으로 판단합니다. @Size(max = 72)는 글자 수를 세지만 bcrypt는 72바이트까지만 받아서, 한글 25자(75바이트)가 500을 냈습니다. 재현 테스트를 먼저 쓰고@MaxBytes(72)로 바이트를 세게 고쳐 400을 돌려줍니다.- 3단계 Dockerfile(frontend, build, 실행)로 화면과 서버를 한 이미지에 묶고, 스모크 테스트는 화면, 가입·로그인, 보안 차단, 글 작성과 검색까지 확인합니다. CI 결과는 초록색 표시 대신 로그에서 직접 센 건수(
build497건 통과·33건 건너뜀,oracle126건 통과)로 판단합니다.
이것으로 Spring Boot 과정을 마칩니다. 이어서 해 볼 만한 것은 위 “다음에 해 볼 것”에 정리해 두었습니다.