본 포스팅은 인프런 - 스프링 MVC 2편을 강의를 바탕으로 공부하고 정리한 글입니다.
프로젝트 준비
로그인 요구사항
- 홈 화면 - 로그인 전
- 회원 가입
- 로그인
- 홈 화면 - 로그인 후
- 본인 이름 ( __님 환영합니다. )
- 상품 관리
- 로그아웃
- 보안 요구사항
- 로그인 한 사용자만 상품에 접근하고, 관리할 수 있음
- 로그인 하지 않은 사용자가 상품 관리에 접근하면 로그인 화면으로 이동
- 회원 가입, 상품관리
패키지 구조 설계
📁 hello.login
ㄴ domain
ㄴ item
ㄴ member
ㄴ login
ㄴ web
ㄴ item
ㄴ member
ㄴ login구조 설계시 도메인이 가장 중요하다. 도메인은 시스템이 구현해야 하는 핵심 비즈니스 업무 영역을 말한다.
이때 web은 domain을 의존하지만 domain은 web을 의존하지 않도록 의존관계를 설계하는 것이 중요하다.
예를 들어 web 패키지를 모두 변경하거나 삭제해도 domain에는 전혀 영향이 없도록 하는 것이 좋은 설계라 할 수 있다.
홈 화면 개발
👉🏻 홈 컨트롤러
📂 web/HomeController
@Slf4j
@Controller
public class HomeController {
@GetMapping("/")
public String home() {
return "home";
}
}👉🏻 홈 뷰
📂 resource/templates/home.html
<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="utf-8">
<link th:href="@{/css/bootstrap.min.css}"
href="css/bootstrap.min.css" rel="stylesheet">
</head>
<body>
<div class="container" style="max-width: 600px">
<div class="py-5 text-center">
<h2>홈 화면</h2>
</div>
<div class="row">
<div class="col">
<button class="w-100 btn btn-secondary btn-lg" type="button"
th:onclick="|location.href='@{/members/add}'|">
회원 가입
</button>
</div>
<div class="col">
<button class="w-100 btn btn-dark btn-lg"
onclick="location.href='items.html'"
th:onclick="|location.href='@{/login}'|" type="button">
로그인
</button>
</div>
</div>
<hr class="my-4">
</div> <!-- /container -->
</body>
</html>👉🏻 실행 확인 (http://localhost:8080/)
회원가입 개발
👉🏻 회원 객체
📂 domain/member/Member
@Data
public class Member {
private Long id;
@NotEmpty
private String loginId; // 로그인 ID
@NotEmpty
private String name; // 사용자 이름
@NotEmpty
private String password; // 비밀번호
}👉🏻 회원 리포지토리
📂 domain/member/MemberRepository
@Slf4j
@Repository
public class MemberRepository {
/**
* 동시성 문제가 고려되어 있지 않음, 실무에서는 ConcurrentHashMap, AtomicLong 사용 고려
*/
private static Map<Long, Member> store = new HashMap<>(); // static 사용
private static long sequence = 0L; // static 사용
public Member save(Member member) {
member.setId(sequence++);
log.info("save : member={}", member);
store.put(member.getId(), member);
return member;
}
public Member findById(Long id) {
return store.get(id);
}
public Optional<Member> findByLoginId(String loginId) {
return findAll().stream()
.filter(m -> m.getLoginId().equals(loginId))
.findFirst();
}
public List<Member> findAll() {
return new ArrayList<>(store.values());
}
public void clearStore() {
store.clear();
}
}👉🏻 회원 컨트롤러
📂 web/member/MemberController
@Controller
@RequiredArgsConstructor
@RequestMapping("/members")
public class MemberController {
private final MemberRepository memberRepository;
@GetMapping("/add")
public String addForm(@ModelAttribute Member member) {
return "members/addMemberForm";
}
@PostMapping("/add")
public String save(@Valid @ModelAttribute Member member, BindingResult bindingResult) {
// 검증 실패
if (bindingResult.hasErrors()) {
return "members/addMemberForm";
}
// 성공 로직
memberRepository.save(member);
return "redirect:/";
}
}👉🏻 회원가입 뷰
📂 resource/templates/members/addMemberForm.html
<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="utf-8">
<link th:href="@{/css/bootstrap.min.css}"
href="../css/bootstrap.min.css" rel="stylesheet">
<style>
.container {
max-width: 560px;
}
.field-error {
border-color: #dc3545;
color: #dc3545;
}
</style>
</head>
<body>
<div class="container">
<div class="py-5 text-center">
<h2>회원 가입</h2>
</div>
<h4 class="mb-3">회원 정보 입력</h4>
<form action="" th:action th:object="${member}" method="post">
<div th:if="${#fields.hasGlobalErrors()}">
<p class="field-error" th:each="err : ${#fields.globalErrors()}"
th:text="${err}">전체 오류 메시지</p>
</div>
<div>
<label for="loginId">로그인 ID</label>
<input type="text" id="loginId" th:field="*{loginId}" class="form-control"
th:errorclass="field-error">
<div class="field-error" th:errors="*{loginId}"></div>
</div>
<div>
<label for="password">비밀번호</label>
<input type="password" id="password" th:field="*{password}"
class="form-control"
th:errorclass="field-error">
<div class="field-error" th:errors="*{password}"></div>
</div>
<div>
<label for="name">이름</label>
<input type="text" id="name" th:field="*{name}" class="form-control"
th:errorclass="field-error">
<div class="field-error" th:errors="*{name}"></div>
</div>
<hr class="my-4">
<div class="row">
<div class="col">
<button class="w-100 btn btn-primary btn-lg" type="submit">회원 가입</button>
</div>
<div class="col">
<button class="w-100 btn btn-secondary btn-lg"
onclick="location.href='items.html'"
th:onclick="|location.href='@{/}'|"
type="button">취소</button>
</div>
</div>
</form>
</div> <!-- /container -->
</body>
</html>
이때 서버를 껏다 켜면 데이터가 초기화 되기 때문에 테스트용 회원 데이터를 추가해주도록 하자.
👉🏻 테스트 데이터 추가
📂 TestDataInit
@Component
@RequiredArgsConstructor
public class TestDataInit {
...
private final MemberRepository memberRepository;
/**
* 테스트용 데이터 추가
*/
@PostConstruct
public void init() {
...
Member member = new Member();
member.setLoginId("test");
member.setName("테스터");
member.setPassword("test!");
memberRepository.save(member);
}
}
로그인 개발 (쿠키)
로그인 기능
👉🏻 로그인 서비스
📂 domain/login/LoginService
@Service
@RequiredArgsConstructor
public class LoginService {
private final MemberRepository memberRepository;
/**
* @return null이면 로그인 실패
*/
public Member login(String loginId, String password) {
return memberRepository.findByLoginId(loginId) // 회원 조회
.filter(m -> m.getPassword().equals(password)) // password 비교
.orElse(null);
}
}- 로그인 시 아이디와 비밀번호가 맞는지 판단하는 로직을 만들어준다.
- 회원을 조회한다.
- 조회된 회원의 password와 파라미터로 넘어온 password와 같은지 확인한다.
- 같으면 회원을 반환
- 다르면 null을 반환
👉🏻 로그인 폼 객체
📂 web/login/LoginForm
@Data
public class LoginForm {
@NotEmpty
private String loginId;
@NotEmpty
private String password;
}- 로그인 폼에 맞는 객체를 만들어 준다.
👉🏻 로그인 컨트롤러
📂 web/login/LoginController
@Slf4j
@Controller
@RequiredArgsConstructor
public class LoginController {
private final LoginService loginService;
@GetMapping("/login")
public String loginForm(@ModelAttribute LoginForm form) {
return "login/loginForm";
}
@PostMapping("/login")
public String login(@Valid @ModelAttribute LoginForm form, BindingResult bindingResult) {
// 검증 실패
if (bindingResult.hasErrors()) {
return "login/loginForm";
}
// 검증 성공
Member loginMember = loginService.login(form.getLoginId(), form.getPassword());
log.info("login? {}", loginMember);
// 로그인 실패
if (loginMember == null) {
bindingResult.reject("loginFail", "아이디 또는 비밀번호가 맞지 않습니다."); // 글로벌 오류 생성
return "login/loginForm";
}
// 로그인 성공 처리 TODO
return "redirect:/"; // 홈 화면으로 이동
}
}- 로그인 서비스를 호출한다.
- 회원이 반환되면 로그인 성공 : 홈 화면으로 이동
- null이 반환되면 로그인 실패 : bindingResult.reject()를 사용해 글로벌 오류를 생성하고, 정보를 다시 입력하도록 로그인 폼으로 이동한다.
👉🏻 로그인 뷰
📂 resource/templates/login/loginForm.html
<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="utf-8">
<link th:href="@{/css/bootstrap.min.css}"
href="../css/bootstrap.min.css" rel="stylesheet">
<style>
.container {
max-width: 560px;
}
.field-error {
border-color: #dc3545;
color: #dc3545;
}
</style>
</head>
<body>
<div class="container">
<div class="py-5 text-center">
<h2>로그인</h2>
</div>
<form action="item.html" th:action th:object="${loginForm}" method="post">
<div th:if="${#fields.hasGlobalErrors()}">
<p class="field-error" th:each="err : ${#fields.globalErrors()}"
th:text="${err}">전체 오류 메시지</p>
</div>
<div>
<label for="loginId">로그인 ID</label>
<input type="text" id="loginId" th:field="*{loginId}" class="form-control"
th:errorclass="field-error">
<div class="field-error" th:errors="*{loginId}"></div>
</div>
<div>
<label for="password">비밀번호</label>
<input type="password" id="password" th:field="*{password}"
class="form-control"
th:errorclass="field-error">
<div class="field-error" th:errors="*{password}"></div>
</div>
<hr class="my-4">
<div class="row">
<div class="col">
<button class="w-100 btn btn-primary btn-lg" type="submit">로그인</button>
</div>
<div class="col">
<button class="w-100 btn btn-secondary btn-lg"
onclick="location.href='items.html'"
th:onclick="|location.href='@{/}'|"
type="button">취소</button>
</div>
</div>
</form>
</div> <!-- /container -->
</body>
</html>- loginId, password가 틀리면 글로벌 오류가 나타난다.
실행 시 로그인이 성공하면 홈으로 이동하고, 실패하면 "아이디 또는 비밀번호가 맞지 않습니다" 라는 경고가 나타나는 것을 확인할 수 있다. 하지만, 로그인 성공 시 홈 화면에 사용자 이름이 보여야 한다는 요구사항을 아직 만족하지 못한다!
다음으로 로그인의 상태를 유지하면서, 로그인에 성공한 사용자는 홈 화면에 접근 시 이름을 보여주도록 하는 방법을 알아보자.
로그인 처리 (쿠키 사용)
로그인의 상태를 유지하기 위해 쿠키를 사용할 수 있다.
서버에서 로그인에 성공하면 HTTP 응답에 쿠키를 담아서 브라우저에 전달하고, 브라우저는 해당 쿠키를 지속해서 보내준다.
쿠키에 대한 이해가 부족하다면, 여기를 먼저 읽어보고 오자.
쿠키는 다음 두가지 종류가 있다.
- 영속 쿠키 : 만료 날짜를 입력하면 해당 날짜까지 유지
- 세션 쿠키 : 만료 날짜를 생략하면 브라우저 종료시 까지만 유지
우리는 브라우저 종료시 로그아웃이 되도록 구현할 것이므로, 세션 쿠키를 사용하도록 하자.
👉🏻 로그인 컨트롤러 - 쿠키 생성 추가
📂 web/login/LoginController
@PostMapping("/login")
public String login(@Valid @ModelAttribue LoginForm form, BindingResult bindingresult, HttpServletResponse response) {
...
// 로그인 성공 처리
// 쿠키 생성 (시간 정보를 주지 않으면 세션 쿠키 -> 브라우저 종료시 모두 종료)
Cookie idCookie = new Cookie("memberId", String.valueOf(loginMember.getId()));
response.addCookie(idCookie);
return "redirect:/"; // 홈 화면으로 이동
}- 로그인 성공시 쿠키를 생성해 HttpServletRespose에 담는다.
- 만들어준 쿠키를 서버에서 클라이언트로 보낼 때 응답메세지에 추가해줘야 한다.
- 쿠키 이름은 "memberId"이며, 회원의 id값을 웹 브라우저 종료 전까지 담아 둔다.
- 이후 웹 브라우저는 종료 전까지 모든 요청 시 회원의 id를 서버에 계속 보내줄 것이다.
그럼 이제 쿠키를 받아 로그인 된 화면과 로그인 되지 않은 화면을 처리하도록 하자.
👉🏻 홈 컨트롤러
📂 web/HomeController
@Slf4j
@Controller
@RequiredArgsConstructor
public class HomeController {
private final MemberRepository memberRepository;
@GetMapping("/")
public String homeLogin(@CookieValue(name = "memberId", required = false) Long memberId, Model model) {
// 로그인 쿠키가 없는 경우
if (memberId == null) {
return "home";
}
// 로그인 쿠키가 있는 경우
Member loginMember = memberRepository.findById(memberId);
if (loginMember == null) { // 쿠키가 있어도 회원이 없는 경우
return "home";
}
model.addAttribute("member", loginMember);
return "loginHome"; // 로그인 사용자 전용 홈 화면으로 이동
}
}- @CookieValue를 사용해 쿠키를 조회할 수 있다.
- 로그인 하지 않은 사용자도 홈에 접근할 수 있기 때문에 required = false를 사용한다.
- 쿠키가 없는 사용자
- 기존 home으로 이동한다.
- 쿠키가 있는 사용자
- 쿠키가 있지만 회원이 없는 경우도 기존 home으로 이동한다.
- 로그인 전용 홈 화면인 loginHome으로 이동한다.
- 이때 로그인 전용 홈 회면에 회원 관련 정보를 출력해야 하기 때문에 member 데이터를 model에 담아서 전달한다.
👉🏻 로그인 사용자 홈 뷰
📂 resoureces/templates/loginHome.html
<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="utf-8">
<link th:href="@{/css/bootstrap.min.css}"
href="../css/bootstrap.min.css" rel="stylesheet">
</head>
<body>
<div class="container" style="max-width: 600px">
<div class="py-5 text-center">
<h2>홈 화면</h2>
</div>
<h4 class="mb-3" th:text="|로그인: ${member.name}|">로그인 사용자 이름</h4>
<hr class="my-4">
<div class="row">
<div class="col">
<button class="w-100 btn btn-secondary btn-lg" type="button"
th:onclick="|location.href='@{/items}'|">
상품 관리
</button>
</div>
<div class="col">
<form th:action="@{/logout}" method="post">
<button class="w-100 btn btn-dark btn-lg"
onclick="location.href='items.html'" type="submit">
로그아웃
</button>
</form>
</div>
</div>
<hr class="my-4">
</div> <!-- /container -->
</body>
</html>- th:text="|로그인: ${member.name}|" : 로그인에 성공한 사용자 이름을 출력한다.
- 로그인 된 사용자에게는 상품 관리, 로그아웃 버튼을 노출한다.
👉🏻 실행 확인
로그아웃 처리
👉🏻 로그인 컨트롤러
📂 web/login/LoginController
@PostMapping("/logout")
public String logout(HttpServletResponse response) {
expireCookie(response, "memberId");
return "redirect:/";
}
private void expireCookie(HttpServletResponse response, String cookieName) {
Cookie cookie = new Cookie(cookieName, null); // 응답 쿠키 생성
cookie.setMaxAge(0); // 0으로 설정해 즉시 종료
response.addCookie(cookie);
}- 로그아웃도 응답 쿠키를 생성하는데 Max-Age=0으로 생성해, 즉시 종료시킨다.
쿠키의 보안문제
이렇게 쿠키를 사용해서 로그인 id를 전달해 로그인을 유지할 수 있지만, 이 방법에는 심각한 보안 문제가 있다.
- 쿠키 값은 임의로 변경할 수 있다.
- 클라이언트가 쿠키를 강제로 변경하면 다른 사용자가 된다.
- 실제 웹 브라우저 개발자 모드 ➡ Application ➡ Cookie 변경으로 확인 가능
- 예) Cookie : memberId = 1 ➡ Cookie : memberId = 2 로 변경 시 다른 사용자의 이름이 보인다.
- 클라이언트가 쿠키를 강제로 변경하면 다른 사용자가 된다.
- 쿠키에 보관된 정보는 훔쳐갈 수 있다.
- 만약 쿠키에 개인정보나 신용카드 정보가 있다면 이 정보가 웹 브라우저에도 보관되고, 네트워크 요청마다 계속 클라이언트에서 서버로 전달된다.
- 그 과정에서 로컬 pc가 털릴 수도 있고, 네트워크 전송 구간에서 털릴 수도 있다.
- 해커가 쿠키를 한번 훔쳐가면 평생 사용할 수 있다.
- 해커가 쿠키를 훔쳐가서 그 쿠키로 악의적인 요청을 계속 시도할 수 있다.
💡 대안점
- 쿠키에 중요한 값을 노출하지 않고, 사용자 별로 예측 불가능한 임의의 토큰(랜덤 값)을 노출하고, 서버에서 토큰과 사용자 id를 매핑해서 인식해야 한다. 그리고 서버에서 토큰을 관리한다
- 토큰은 해커가 임의의 값을 넣어도 찾을 수 없도록 예상 불가능 해야 한다.
- 해커가 토큰을 털어가도 시간이 지나면 사용할 수 없도록 서버에서 해당 토큰의 만료시간을 짧게 유지해야 한다.
- 해킹이 의심되는 경우 서버에서 해당 토큰을 강제로 제거하도록 한다.
로그인 개발 (세션)
세션 동작 방식
앞서 얘기한 보안문제를 해결하기 위해서는 중요한 정보는 쿠키가 아닌 서버에 저장하고, 클라이언트와 서버는 추정 불가능한 임의의 식별자 값으로 연결해야 한다고 했다.
이렇게 서버에 중요한 정보를 보관하고 연결을 유지하는 방법을 세션이라 한다.
💡 세션 동작 방식
- 사용자가 loginId, password 정보를 전달하면 서버에서 해당 사용자가 맞는지 확인한다.
- 추정 불가능한 세션 ID를 생성한다.
- UUID를 사용해 유일무이한 랜덤값을 생성할 수 있다.
- 예) Cookie: mySessionId=zz0101xx-bab9-4b92-9b32-dadb280f4b61
- 생성된 세션 ID와 세션에 보관할 값(memberA)을 서버의 세션 저장소에 보관한다.
- 세션 저장소에 보관된 세션 ID를 응답 쿠키로 전달한다.
결국 클라이언트와 서버는 쿠키로 연결 되어야 한다.
- 서버는 클라이언트에 mySessionId라는 이름으로 세션ID만 쿠키에 담아서 전달한다.
- 클라이언트는 쿠키 저장소에 mySessionId 쿠키를 보관한다.
- 이후 클라이언트는 요청시 항상 mySessionId 쿠키를 전달하며,
서버에서는 클라이언트가 전달한 mySessionId 쿠키 정보로 세션 저장소를 조회하여 로그인시 보관한 세션 정보를 사용한다.
⭐ 중요
- 세션의 중요한 포인트는 회원과 관련된 정보는 전혀 클라이언트에 전달하지 않는다는 것이다.
- 오직 추정 불가능한 세션 ID만 쿠키를 통해 클라이언트에 전달한다.
이렇게 세션을 사용하면 다음과 같은 보안 문제들을 해결할 수 있게 된다.
- 쿠키 값을 변조 가능
→ 예상 불가능한 복잡한 세션 ID를 사용 - 쿠키에 보관하는 정보는 클라이언트 해킹시 털릴 가능성이 있음
→ 세션 ID가 털려도 여기는 중요한 정보가 없음 - 쿠키 탈취 후 사용
→ 해커가 토큰을 털어가도 시간이 지나면 사용할 수 없도록 서버에서 세션의 만료시간을 짧게 유지
→ 해킹이 의심되는 경우 서버에서 해당 세션을 강제로 제거 가능
세션 직접 개발
먼저 세션을 직접 개발해보며 알아보자
세션 관리는 크게 3가지 기능을 제공하면 된다.
- 세션 생성
- sessionId 생성 (임의의 추정 불가능한 랜덤 값)
- 세션 저장소에 sessionId와 보관할 값 저장
- sessionId로 응답 쿠키를 생성해서 클라이언트에 전달
- 세션 조회
- 클라이언트가 요청한 sessionId 쿠키의 값으로, 세션 저장소에 보관한 값 조회
- 세션 만료
- 클라이언트가 요청한 sessionId 쿠키의 값으로, 세션 저장소에 보관한 sessionId와 값 제거
👉🏻 세션 관리 생성
📂 web/session/SessionManager
/**
* 세션 관리
*/
@Component
public class SessionManager {
public static final String SESSION_COOKIE_NAME = "mySessionId";
private Map<String, Object> sessionStore = new ConcurrentHashMap<>();
/**
* 세션 생성
*/
public void createSession(Object value, HttpServletResponse response) {
// 세션 ID를 생성하고, 값을 세션에 저장
String sessionId = UUID.randomUUID().toString();
sessionStore.put(sessionId, value);
// 쿠키 생성
Cookie mySessionCookie = new Cookie(SESSION_COOKIE_NAME, sessionId);
response.addCookie(mySessionCookie);
}
/**
* 세션 조회
*/
public Object getSession(HttpServletRequest request) {
Cookie sessionCookie = findCookie(request, SESSION_COOKIE_NAME);
// 세션이 없을 경우
if (sessionCookie == null) {
return null;
}
// 세션이 있을 경우
return sessionStore.get(sessionCookie.getValue());
}
/**
* 세션 만료
*/
public void expire(HttpServletRequest request) {
Cookie sessionCookie = findCookie(request, SESSION_COOKIE_NAME);
if (sessionCookie != null) {
sessionStore.remove(sessionCookie.getValue());
}
}
private Cookie findCookie(HttpServletRequest request, String cookieName) {
// 요청에 쿠키가 없을 경우
if (request.getCookies() == null) {
return null;
}
// 요청에 쿠키가 있을 경우
return Arrays.stream(request.getCookies())
.filter(cookie -> cookie.getName().equals(cookieName))
.findAny()
.orElse(null);
}
}👉🏻 테스트 코드
class SessionManagerTest {
SessionManager sessionManager = new SessionManager();
@Test
void sessionTest() {
// 세션 생성
MockHttpServletResponse response = new MockHttpServletResponse();
Member member = new Member();
sessionManager.createSession(member, response);
// 요청에 응답 쿠키 저장
MockHttpServletRequest request = new MockHttpServletRequest();
request.setCookies(response.getCookies());
// 세션 조회
Object result = sessionManager.getSession(request);
assertThat(result).isEqualTo(member);
// 세션 만료
sessionManager.expire(request);
Object expired = sessionManager.getSession(request);
assertThat(expired).isNull();
}
}- HttpServletResponse, HttpServletRequest는 인터페이스이기 때문에 테스트가 어렵다. 이를 위해 스프링은 비슷한 역할을 해주는 가짜 MockHttpServletResponse(), MockHttpServletRequest()를 제공한다.
이제 지금까지 개발한 세션 관리 기능을 웹 어플리케이션에 적용해보도록 하자.
👉🏻 로그인 컨트롤러
📂 web/login/LoginController - loginV2, logoutV2
private final SessionManager sessionManager;
@PostMapping("/login")
public String loginV2(@Valid @ModelAttribute LoginForm form, BindingResult bindingResult, HttpServletResponse response) {
...
// 로그인 성공 처리
// 세션 관리자를 통해 세션을 생성해 회원 데이터를 보관하고, 쿠키를 발행
sessionManager.createSession(loginMember, response);
return "redirect:/";
}
@PostMapping("/logout")
public String logoutV2(HttpServletRequest request) {
sessionManager.expire(request);
return "redirect:/";
}- 로그인 성공시 세션을 등록하는데, 세션에 loginMeber를 저장해도고, 쿠키도 함께 발행한다.
- 로그 아웃시 해당 세션의 정보를 제거한다.
👉🏻 홈 컨트롤러 - 로그인/로그아웃 처리
📂 web/HomeController - homeLoginV2
@Slf4j
@Controller
@RequiredArgsConstructor
public class HomeController {
private final SessionManager sessionManager;
@GetMapping("/")
public String homeLoginV2(HttpServletRequest request, Model model) {
// 세션 관리자에 저장된 회원 정보 조회
Member member = (Member) sessionManager.getSession(request);
if (member == null) {
return "home";
}
model.addAttribute("member", member);
return "loginHome"; // 로그인 사용자 전용 홈 화면으로 이동
}
}- 로그인 된 사용자인지 확인하기 위해 세션 관리자에서 저장된 회원 정보를 조회한다.
- 만약 조회되는 회원 정보가 없으면 쿠키나 세션이 없는 것 이므로 로그인 되지 않은 것으로 처리한다.
지금까지는 이해를 위해 세션을 직접 만들어보았다.
세션이라는 것은 단지 쿠키를 사용하는데, 서버에서 데이터를 유지하는 방법이라는 것을 알게 되었다.
하지만 매번 이렇게 세션을 직접 개발하는 것은 불편하기 때문에, 서블릿은 세션 개념을 지원한다.
그럼 서블릿이 공식 지원하는 세션을 알아보도록 하자.
서블릿 HttpSession 사용
서블릿은 세션을 위해 HttpSession이라는 기능을 제공한다.
서블릿이 제공하는 HttpSession은 앞서 만들어봤던 SessionManager와 같은 방식으로 동작한다.
서블릿을 통해 HttpSession을 생성하면 다음과 같은 쿠키를 생성한다.
- Cookie : JSESSIONID=5B78E23B513F50164D6FDD8C97B0AD05
그럼 코드를 통해 확인해보자.
👉🏻 세션상수 정의
public class SessionConst {
// HttpSession에 데이터를 보관하고 조회할 때 사용할 이름을 상수로 정의
public static final String LOGIN_MEMBER = "loginMember";
}
👉🏻 로그인 컨트롤러
📂 web/login/LoginController - loginV3, logoutV3
@PostMapping("/login")
public String loginV3(@Valid @ModelAttribute LoginForm form, BindingResult bindingResult, HttpServletRequest request) {
...
// 로그인 성공 처리
// 세션이 있으면 세션 반환, 없으면 신규 세션 생성
HttpSession session = request.getSession();
// 세션에 로그인 회원 정보 보관
session.setAttribute(SessionConst.LOGIN_MEMBER, loginMember);
return "redirect:/";
}
@PostMapping("/logout")
public String logoutV3(HttpServletRequest request) {
HttpSession session = request.getSession(false);
if (session != null) {
session.invalidate(); // 세션 제거
}
return "redirect:/";
}- 세션 생성
- request.getSession(true)
- 이때 true가 defalut값으로 생략 가능하다.
- 세션이 있으면 기존 세션을 반환한다.
- 세션이 없으면 새로운 세션을 생성해 반환한다.
- request.getSession(false)
- 세션이 있으면 기존 세션을 반환한다.
- 세션이 없으면 새로운 세션을 생성하지 않고, null을 반환한다.
- request.getSession(true)
- 세션에 로그인 회원 정보 보관
- session.setAttribute(SessionConst.LOGIN_MEMBER, longinMember)
- 하나의 세션에 여러 값을 저장할 수 있다.
- 세션 삭제
- session.invalidate()
👉🏻 홈 컨트롤러 - 로그인/로그아웃 처리
@GetMapping("/")
public String homeLoginV3(HttpServletRequest request, Model model) {
// 조회 시 세션이 없으면 홈 화면으로 이동
HttpSession session = request.getSession(false);
if (session == null) {
return "home";
}
Member loginMember = (Member) session.getAttribute(SessionConst.LOGIN_MEMBER);
// 세션에 회원 정보가 없으면 홈 화면 으로 이동
if (loginMember == null) {
return "home";
}
// 세션이 유지되면 로그인 사용자 전용 홈 화면으로 이동
model.addAttribute("member", loginMember);
return "loginHome";
}- 로그인 하지 않은 사용자는 세션을 만들지 않기 위해, 세션을 찾아서 사용하는 시점에는 request.getSession(false) 옵션을 사용한다.
- session.getAttribute(SessionConst.LOGIN_MEMBER)
- 로그인 시점에 세션에 보관한 회원 객체를 찾는다.
실행 시 JSESSIONID 쿠키가 생성되는 것을 확인할 수 있다.
스프링 @SessionAttribute 사용
스프링은 세션을 더 편리하게 사용할 수 있도록 @SessionAttribute를 지원한다.
이미 로그인 된 사용자를 찾을 때 유용하게 사용할 수 있다.
이 기능은 세션을 생성하지 않는다.
👉🏻 홈 컨트롤러 - 로그인/로그아웃 처리
@GetMapping("/")
public String homeLoginV3Spring(
@SessionAttribute(name = SessionConst.LOGIN_MEMBER, required = false) Member loginMember,
Model model) {
// 조회 시 세션이 없으면 홈 화면으로 이동
if (loginMember == null) {
return "home";
}
// 세션이 유지되면 로그인 사용자 전용 홈 화면으로 이동
model.addAttribute("member", loginMember);
return "loginHome";
}- 세션을 찾고, 세션에 들어있는 데이터를 찾는 번거로운 과정을 스프링이 @SessionAttribute를 통해 한번에 처리해준다.
TrackingMode
로그인을 처음 시도한 경우 URL이 다음과 같이 jsessionid를 포함하고 있는 것을 볼 수 있다.
http://localhost:8080/;jsessionid=F59911518B921DF62D09F0DF8F83F872이것은 웹 브라우저가 쿠키를 지원하지 않을 때 쿠키 대신 URL을 통해서 세션을 유지하는 방법이다.
이 방법을 사용하려면 URL에 이 값을 계속 포함해서 전달해야 한다. (이 과정이 매우 번거롭기 때문에 거의 사용하지 않음)
서버 입장에서 웹 브라우저가 쿠키를 지원하는지 하지 않는지 최초에는 판단하지 못하므로, 쿠키 값도 전달하고 URL에 jsessionid도 함께 전달하는 것이다.
URL 전달 방식을 끄고 항상 쿠키를 통해 세션을 유지하고 싶다면 다음과 같은 옵션을 넣어주면 된다.
📂 application.properties
server.servlet.session.tracking-modes=cookie
세션 정보
세션이 제공하는 정보를 확인해보도록 하자.
👉🏻 세션 정보 컨트롤러
@Slf4j
@RestController
public class SessionInfoController {
@GetMapping("/session-info")
public String sessionInfo(HttpServletRequest request) {
HttpSession session = request.getSession();
if (session == null) {
return "세션이 없습니다.";
}
// 세션 데이터 출력
session.getAttributeNames().asIterator()
.forEachRemaining(name -> log.info("session name={}, value={}", name, session.getAttribute(name)));
log.info("sessionId={}", session.getId()); // 세션의 id (JSESSIONID 값)
log.info("maxInactiveInterval={}", session.getMaxInactiveInterval()); // 세션의 유효 시간
log.info("creationTime={}", new Date(session.getCreationTime())); // 세션의 생성 일시
log.info("lastAccessedTime={}", new Date(session.getLastAccessedTime())); // 세션과 연결된 사용자가 최근에 서버에 접근한 시간
log.info("isNew={}", session.isNew()); // 새로 생성된 세션인지 여부
return "세션 출력";
}
}👉🏻 실행 확인 (http://localhost:8080/session-info)
| sessionId | 세션 ID, JSESSIONID의 값 |
| maxInactiveInterval | 세션의 유효 시간 |
| creationtime | 세션 생성 일시 |
| lastAccessedTime | 세션과 연결된 사용자가 최근에 서버에 접근한 시간 클라이언트에서 서버로 세션을 요청한 경우에 갱신된다. |
| isNew | 새로 생성된 세션인지, 과거에 만들어진 세션을 요청해서 조회된 세션인지 여부 |
세션 타임 아웃
세션은 사용자가 로그아웃을 직접 호출해 session.invalidate()가 호출 되는 경우 삭제된다.
하지만, 실제 대부분의 사용자는 로그아웃을 누르지 않고, 그냥 웹 브라우저를 종료한다.
문제는 HTTP가 비연결성이기 때문에 서버 입장에서는 해당 사용자가 웹 브라우저를 종료한 건지 아닌지 알 수 가 없다는 것이다.
이런 경우 서버에서 세션 데이터를 언제 삭제해야 하는지 판단하기가 어렵다.
따라서 세션의 종료 시점을 정해줄 필요가 있다.
만약 세션을 무한정 보관한다면 다음과 같은 문제가 발생 할 수 있다.
- 세션과 관련된 쿠키(JSESSIONID)를 해킹 당했을 경우 오랜 시간이 지나도 해당 쿠키로 악의적인 요청을 할 수 있다.
- 세션은 기본적으로 메모리에 생성되는데, 메모리의 크기가 무한하지 않기 때문에 꼭 필요한 경우만 생성해서 사용해야 한다.
하지만 만약 세션을 무한정 보관할 경우 사용자 수만큼 메모리 사용량이 급격하게 늘어나서 장애로 이어질 수 있다.
그렇다면 세션의 종료 시점을 어떻게 정해주는 것이 좋을까?
사용자가 서버에 최근에 요청한 시간을 기준으로 30분 정도를 유지하도록 하면, 사용자가 서비스를 사용하고 있는 동안 세션의 생존 시간이 30분씩 계속 늘어날 것 이므로, 계속 로그인해야하는 번거로움이 사라질 수 있다.
HttpSession은 이러한 방식을 사용해 세션의 종료 시점을 관리한다 !
정리하자면 다음과 같다.
- 세션의 타임 아웃 시간은 해당 세션과 관련된 세션 ID로 전달하는 HTTP 요청이 있으면 현재 시간으로 다시 초기화 된다.
- 초기화 되면 세션 타임아웃으로 설정한 시간동안 세션을 추가로 사용할 수 있다.
- session.getLastAccessedTime() : 최근 세션 접근 시간
- LastAccessedTime 이후로 타임 아웃 시간이 지나면, WAS가 내부에서 해당 세션을 제거한다.
👉🏻 세션 타임 아웃 설정 (글로벌)
📂 application.properties
server.servlet.session.timeout=60- 글로벌 설정은 분 단위로 설정한다. (예 - 60(1분), 120(2분),...)
- 기본값은 1800(30분)이다.
👉🏻 세션 타임 아웃 설정 (특정 세션 단위)
session.setMaxInactiveInterval(1800); // 1800초이렇게 서블릿의 HttpSession이 제공하는 타임아웃 기능을 사용하면 세션을 안전하고 편리하게 사용할 수 있다.
세션 저장소 사용하기
보통 서버를 재시작 했을 때 세션도 초기화된다.
이러한 세션을 관리하는 방법에는 여러 방법이 있지만, 여기서는 가장 쉬운 방법인 데이터베이스를 세션 저장소로 사용하는 방법을 소개한다.
데이터베이스를 세션 저장소로 사용하는 방법은 많은 설정이 필요 없지만, 로그인 요청마다 DB IO가 발생해 성능상 이슈가 발생할 수 있기 때문에 로그인 요청이 많이 없는 백오피스, 사내 시스템 용도에 적합하다는 것을 참고하자.
Spring Session JDBC
spring에는 간단하게 세션 저장소를 만들수 있는 spring session jdbc를 제공한다.
spring session jdbc는 관계형 데이터베이스 및 구성 지원에 의해 지원되는 SessionRepository 구현한다.
👉🏻 spring-session-jdbc 설정
📁 build.gradle
compile 'org.springframework.session:spring-session-jdbc'📁 application.properties
spring.session.store-type=jdbc
위 설정만 추가해준 뒤 애플리케이션을 실행하면 SPRING_SESSION, SPIRING_SESSION_ATTRIBUTES라는 2개의 테이블이 생성된다.
Reference
https://www.clien.net/service/board/cm_app/16233457
'🌱 Spring > Web MVC' 카테고리의 다른 글
| 스프링 타입 컨버터 (0) | 2022.05.25 |
|---|---|
| API 예외처리 (0) | 2022.05.19 |
| 예외처리, 오류 페이지 (0) | 2022.05.16 |
| 로그인 (필터, 인터셉터) (0) | 2022.05.10 |
| Bean Validation (0) | 2022.04.30 |
| Validation (0) | 2022.04.26 |
| 타임리프(Thymeleaf) (1) | 2022.03.23 |
| 스프링 MVC 웹 페이지 만들기 (0) | 2022.03.22 |
