[Spring] 상품 관리 시스템에 회원가입 / 로그인 처리 로직 추가하기, 쿠키를 통한 식별 처리

« 2025/05 »
일	월	화	수	목	금	토
				1	2	3
4	5	6	7	8	9	10
11	12	13	14	15	16	17
18	19	20	21	22	23	24
25	26	27	28	29	30	31

Link

🌱 GitHub

Notice

🍀 깃허브 / 티스토리 닉네임의 의미

관리 메뉴

DevLog 😶

[Spring] 상품 관리 시스템에 회원가입 / 로그인 처리 로직 추가하기, 쿠키를 통한 식별 처리 본문

Back-end/Spring

[Spring] 상품 관리 시스템에 회원가입 / 로그인 처리 로직 추가하기, 쿠키를 통한 식별 처리

dolmeng2 2022. 8. 23. 17:13

김영한 님의 '스프링 MVC 2편 - 백엔드 웹 개발 활용 기술'을 보고 정리한 글입니다 😊

스프링 MVC 2편 - 백엔드 웹 개발 활용 기술 - 인프런 | 강의

웹 애플리케이션 개발에 필요한 모든 웹 기술을 기초부터 이해하고, 완성할 수 있습니다. MVC 2편에서는 MVC 1편의 핵심 원리와 구조 위에 실무 웹 개발에 필요한 모든 활용 기술들을 학습할 수 있

www.inflearn.com

- 지난 포스팅과 이어집니다 :D

[Spring] Bean Validation - 어노테이션을 통해 검증 진행하기

김영한 님의 '스프링 MVC 2편 - 백엔드 웹 개발 활용 기술'을 보고 정리한 글입니다 😊 스프링 MVC 2편 - 백엔드 웹 개발 활용 기술 - 인프런 | 강의 웹 애플리케이션 개발에 필요한 모든 웹 기술을

cl8d.tistory.com

| 회원가입, 로그인 처리 진행하기

- 지난 포스팅부터 계속해서 제작해왔던 상품 관리 시스템에 회원 가입 시스템을 추가해보자.

✔ 간단한 홈 화면 제작하기

[LHomeController.java]


  
    
    
    
    
  
@Controller
@RequiredArgsConstructor
@RequestMapping("/login")
public class LHomeController {
    @GetMapping("/")
    public String home() {
        return "login/home";
    }

}

- 간단한 메인 홈 화면이다.

[home.html] - /resources/login


  
    
    
    
    
  
<!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="mt-3 py-2 text-center">
        <h1 class="font-monospace fw-bold mb-3"
            th:text="#{page.home}"> ITEM SERVICE HOME :D</h1>
        <hr class="my-4">
    </div>

    <div class="row">

        <div class="text-center float-end mb-2 fw-bold" th:text="#{lang}">언어 선택</div>

        <select id="lang" name="lang" class="form-select mb-4"
                onchange="if(this.value) location.href=(this.value);">
            <option value="" th:text="#{select.lang.default}">== SELECT LANGUAGE TYPE ==</option>
            <option value="?lang=en" th:text="#{select.lang.en}">영어</option>
            <option value="?lang=ja" th:text="#{select.lang.ja}">일본어</option>
        </select>
        <hr class="my-4">

        <img class="my-2 mb-5"
             src="https://cdn.discordapp.com/attachments/805265715179159623/1011307630284783697/jerryHello.gif"
             alt="hello">

        <div class="col">
            <button class="font-monospace w-100 btn btn-secondary btn-lg" type="button"
                    th:text="#{label.login.join}"
                    th:onclick="|location.href='@{/login/members/add}'|">
                JOIN
            </button>
        </div>
        <div class="col">
            <button class="font-monospace w-100 btn btn-dark btn-lg"
                    onclick="location.href='items.html'"
                    th:text="#{label.login.login}"
                    th:onclick="|location.href='@{/login/members/login}'|" type="button">
                LOGIN
            </button>
        </div>
    </div>
    <hr class="my-4">
</div>
</body>
</html>

- 기존에 items.html에 있었던 언어 선택 로직을 홈 화면으로 옮겼다.

- 또한, 전반적으로 메시지를 활용한 국제화를 적용하였다.

- 이미지는 그냥 추가해주었다... 너무 허전해보여서...

✔ 멤버 도메인 제작하기

[LMember.java]


  
    
    
    
    
  
@Getter
public class LMember {
    private Long id;
    private String loginId;
    private String name;
    private String password;

    public void setId(Long id) {
        this.id = id;
    }

    @Builder(builderMethodName = "createMember")
    public LMember(String loginId, String name, String password) {
        this.loginId = loginId;
        this.name = name;
        this.password = password;
    }
}

- 하나의 프로젝트에 하다 보니 이름을 이렇게 설정하였다...!

- @Setter를 열지 않고 롬복의 Builder 패턴과 필요한 필드만 setter를 추가하도록 진행하였다.

[LMemberService.java]


  
    
    
    
    
  
@Service
@RequiredArgsConstructor
public class LMemberService {
    private final LMemberRepository repository;

    public LMember save(LMemberSaveRequest saveRequest) {
        LMember member = LMember.createMember()
                .loginId(saveRequest.getLoginId())
                .name(saveRequest.getName())
                .password(saveRequest.getPassword())
                .build();
        return repository.save(member);
    }
}

- 회원 저장 로직이다. 서비스단에서 DTO->실제 entity로 변경하는 작업을 진행한다.

[LMemberRepository.java]


  
    
    
    
    
  
@Repository
public class LMemberRepository {
    private static Map<Long, LMember> store = new ConcurrentHashMap<>();
    private static AtomicLong sequence = new AtomicLong(0L);

    public LMember save(LMember member) {
        member.setId(sequence.incrementAndGet());
        store.put(member.getId(), member);
        return member;
    }

    public Optional<LMember> findByLoginId (String loginId) {
        return findAll().stream()
                .filter(m -> m.getLoginId().equals(loginId))
                .findFirst();
    }

    public LMember findById(Long id) {
        return store.get(id);
    }

    public List<LMember> findAll() {
        return new ArrayList<>(store.values());
    }

    public void clearStore() {
        store.clear();
    }

}

- 기존의 상품 저장 시스템과 거의 유사하게 코드를 짰다.

✔ 회원가입 시스템 제작하기

[LMemeberSaveRequest.java]


  
    
    
    
    
  
@Data
public class LMemberSaveRequest {
    private Long id;
    @NotEmpty
    private String loginId;
    @NotEmpty
    private String password;
    @NotEmpty
    private String name;

    public LMemberSaveRequest(String loginId, String password, String name) {
        this.loginId = loginId;
        this.password = password;
        this.name = name;
    }
}

- 회원 저장 시 모든 정보가 필수로 들어와야 하기 때문에 @NotEmpty를 추가해주었다.

- 테스트용 데이터를 추가해주기 위해서 생성자 하나를 추가해주었다.

[LMemberController.java]


  
    
    
    
    
  
@Controller
@RequiredArgsConstructor
@RequestMapping("/login/members")
public class LMemberController {
    private final LMemberService service;

    // 테스트용 데이터 추가
    @PostConstruct
    public void addMember() {
        service.save(new LMemberSaveRequest("test@naver.com", "test1234", "Spring"));
    }

    @GetMapping("/add")
    public String addForm(@ModelAttribute("member") LMember member) {
        // 타임리프에서 th:object에서 member를 넣어주기 때문에
        // GET, POST 방식 모두 addMemberForm을 사용하기 위해 @ModelAttribute 사용
        // 이렇게 사용하지 않아도 어차피 사용자의 파라미터가 넘어오지는 않기 때문에
        // ModelAttribute가 빈 객체를 생성하게 된다. 그렇기 때문에
        // model.addAttribute("member", new LMember())로 써도 무방하다.
        return "login/members/addMemberForm";
    }

    @PostMapping("/add")
    public String save(@Valid @ModelAttribute("member") LMemberSaveRequest saveRequest,
                       BindingResult bindingResult) {
        if(bindingResult.hasErrors()) {
            return "login/members/addMemberForm";
        }
        service.save(saveRequest);
        return "redirect:/login/";
    }
}

- 테스트용 멤버 데이터를 추가해주었다. (어차피 아이템은 SItemController에서 추가해주니까)

🚩 addForm 부분에서 굳이 @ModelAttribute를 써야 하나? 라는 생각을 했었는데,

어차피 사용자의 값이 넘어오지 않기 때문에 @ModelAttribute가 LMember 객체를 만들 때 파라미터 없이 new LMember()로 만든다.

- 그래서 그냥 Model을 선언한 다음 model.addAttribute("member", new LMember())로 써도 무방하다!

[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>
        .field-error {
            border-color: #dc3545;
            color: #dc3545;
        }
    </style>
</head>
<body>
<div class="container" style="max-width: 600px">
    <div class="mt-5 mb-2 text-center">
        <h2 class="font-monospace fw-bold" th:text="#{label.login.join}">JOIN</h2>
    </div>

    <hr class="my-4">

    <form action="" th:action th:object="${member}" method="post">
        <div th:if="${#fields.hasGlobalErrors()}">
            <p class="field-error text-center fw-bold"
               th:each="err: ${#fields.globalErrors()}"
               th:text="${err}">
                전체 오류 메시지</p>
        </div>

        <div class="row fw-bold font-monospace mb-2">
            <div class="col text-center">
                <label for="loginId">ID</label>
                <input type="text"
                       id="loginId"
                       th:field="*{loginId}"
                       class="form-control text-center"
                       th:errorclass="field-error"
                       placeholder="Please Enter the Login ID.">
                <div class="field-error"
                     th:errors="*{loginId}">
                </div>
            </div>
        </div>

        <div class="row fw-bold font-monospace mb-2">
            <div class="col text-center">
                <label for="password" th:text="#{label.login.password}">PASSWORD</label>
                <input type="text"
                       id="password"
                       th:field="*{password}"
                       class="form-control text-center"
                       th:errorclass="field-error"
                       placeholder="Please Enter the Password.">
                <div class="field-error"
                     th:errors="*{password}">
                </div>
            </div>
        </div>

        <div class="row fw-bold font-monospace mb-2">
            <div class="col text-center">
                <label for="name" th:text="#{label.login.name}">NAME</label>
                <input type="text"
                       id="name"
                       th:field="*{name}"
                       class="form-control text-center"
                       th:errorclass="field-error"
                       placeholder="Please Enter the Name.">
                <div class="field-error"
                     th:errors="*{name}">
                </div>
            </div>
        </div>

        <hr class="my-4">

        <div class="row">
            <div class="col">
                <button class="w-100 btn btn-warning btn-lg"
                        type="submit">
                    ⭕
                </button>
            </div>
            <div class="col">
                <button class="w-100 btn btn-danger btn-lg"
                        th:onclick="|location.href='@{/login/}'|"
                        type="button">
                    ❌
                </button>
            </div>
        </div>

    </form>
</div>
</body>
</html>

- 회원 가입 폼이다. 따로 디자인하기 귀찮아서 그냥 상품 등록 폼이랑 유사하게 만들었다.

✔ 로그인 시스템 제작하기

[LMemberLoginRequest.java]


  
    
    
    
    
  
@Data
public class LMemberLoginRequest {
    @NotEmpty
    private String loginId;
    @NotEmpty
    private String password;
}

[LMemberService.java] - 추가


  
    
    
    
    
  
public LMember login(LMemberLoginRequest loginRequest) {
    return repository.findByLoginId(loginRequest.getLoginId())
            .filter(m -> m.getPassword().equals(loginRequest.getPassword()))
            .orElse(null);
}

- 저장된 id, pwd가 다를 경우 Member 엔티티를 null로 리턴한다.

[LMemberController.java] - 추가


  
    
    
    
    
  
@GetMapping("/login")
public String loginForm(@ModelAttribute("loginForm") LMemberLoginRequest loginRequest) {
    return "login/members/loginForm";
}

@PostMapping("/login")
public String login(@Valid @ModelAttribute("loginForm") LMemberLoginRequest loginRequest,
                    BindingResult bindingResult) {
    if(bindingResult.hasErrors()) {
        return "login/members/loginForm";
    }

    LMember loginMember = service.login(loginRequest);
    if(loginMember == null) {
        bindingResult.reject("loginFail", "아이디 또는 비밀번호가 일치하지 않습니다.");
        return "login/members/loginForm";
    }
    return "redirect:/login/";
}

- 1차적으로 글로벌 오류 (@NotEmpty)를 체크하고, 만약 서비스에서 member가 null로 리턴된다면 bindingResult에 해당 결과를 추가한다.

[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>
        .field-error {
            border-color: #dc3545;
            color: #dc3545;
        }
    </style>
</head>
<body>
<div class="container" style="max-width: 600px">
    <div class="mt-5 mb-2 text-center">
        <h2 class="font-monospace fw-bold" th:text="#{label.login.login}">LOGIN</h2>
    </div>

    <hr class="my-4">

    <form action="" th:action th:object="${loginForm}" method="post">
        <div th:if="${#fields.hasGlobalErrors()}">
            <p class="field-error text-center fw-bold"
               th:each="err: ${#fields.globalErrors()}"
               th:text="${err}">
                전체 오류 메시지</p>
        </div>

        <div class="row fw-bold font-monospace mb-2">
            <div class="col text-center">
                <label for="loginId">ID</label>
                <input type="text"
                       id="loginId"
                       th:field="*{loginId}"
                       class="form-control text-center"
                       th:errorclass="field-error"
                       placeholder="Please Enter the Login ID.">
                <div class="field-error"
                     th:errors="*{loginId}">
                </div>
            </div>
        </div>

        <div class="row fw-bold font-monospace mb-2">
            <div class="col text-center">
                <label for="password" th:text="#{label.login.password}">PASSWORD</label>
                <input type="password"
                       id="password"
                       th:field="*{password}"
                       class="form-control text-center"
                       th:errorclass="field-error"
                       placeholder="Please Enter the Password.">
                <div class="field-error"
                     th:errors="*{password}">
                </div>
            </div>
        </div>

        <hr class="my-4">

        <div class="row">
            <div class="col">
                <button class="w-100 btn btn-warning btn-lg"
                        type="submit">
                    ⭕
                </button>
            </div>
            <div class="col">
                <button class="w-100 btn btn-danger btn-lg"
                        th:onclick="|location.href='@{/login/}'|"
                        type="button">
                    ❌
                </button>
            </div>
        </div>

    </form>
</div>
</body>
</html>

- 로그인 페이지이다. 마찬가지로 회원가입이랑 거의 똑같이 제작하였다.

- 글로벌 오류 메시지 및 ID/PWD 검증도 성공적으로 실행되는 것을 볼 수 있다.

| 쿠키를 이용하여 로그인 처리하기

- 기본적인 회원가입, 로그인 처리 로직을 구현하였다.

- 그러나, 단순히 쿼리 파라미터를 계속해서 소모하면서 보내는 것은 번거롭기 때문에 우리는 HTTP 응답에 쿠키를 담을 예정이다.

- ⭐ 브라우저는 해당 쿠키 값을 받아서 쿠키 저장소에 넣어두고, 앞으로 요청을 보낼 때마다 쿠키 값을 함께 보내줄 것이다.

- 그럼 서버는 요청과 함께 온 쿠키 값을 통해 회원을 식별하고, 그에 맞는 행동을 처리할 수 있다!

- 브라우저가 종료되면 로그아웃이 되도록 세션 쿠키를 구현하자.

[LMemberController.java] - 수정


  
    
    
    
    
  
@PostMapping("/login")
public String login(@Valid @ModelAttribute("loginForm") LMemberLoginRequest loginRequest,
                    BindingResult bindingResult, HttpServletResponse response) {
    if(bindingResult.hasErrors()) {
        return "login/members/loginForm";
    }

    LMember loginMember = service.login(loginRequest);
    if(loginMember == null) {
        bindingResult.reject("loginFail", "아이디 또는 비밀번호가 일치하지 않습니다.");
        return "login/members/loginForm";
    }

    Cookie cookie = new Cookie("memberId", String.valueOf(loginMember.getId()));
    cookie.setPath("/");
    response.addCookie(cookie);
    return "redirect:/login/";
}

- 로그인 성공 시 쿠키를 생성하고 HttpServletResponse에 담아준다.

- 이때, 쿠키 이름을 memberId로 설정하여 회원 Id를 담아둔다.

- 참고로, cookie의 path를 지정해줘야 한다.

🚩보니까 path 값을 따로 설정하지 않으면 쿠키를 생성했던 페이지의 경로로만 전송된다고 한다.

모든 경로가 호출될 때 cookie 값을 전달하도록 하기 위해 다음과 같이 설정해주었다.

[LHomeController.java] - 로그인 전용 페이지


  
    
    
    
    
  
@GetMapping("/")
public String home(@CookieValue(name = "memberId", required = false) Long memberId,
                   Model model) {
    if(memberId == null) {
        return "login/home";
    }
    LMember member = service.findById(memberId);
    if(member == null) {
        return "login/home";
    }
    model.addAttribute("member", member);
    return "login/loginHome";
}

- 다음과 같이 @CookieValue를 사용하여 쿠키에 있는 값을 쉽게 접근하도록 제작하였다.

- 이때, 로그인하지 않은 사용자도 홈 화면에 접근이 가능하기 때문에 required=false 조건을 걸어주었다.

[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="mt-5 py-2 text-center">
        <h1 class="font-monospace fw-bold mb-3"
            th:text="#{start.message(${member.name})}">👋🏻 Hello</h1>
        <hr class="my-4">
    </div>

    <div class="row">
        <div class="text-center float-end mb-2 fw-bold" th:text="#{lang}">언어 선택</div>

        <select id="lang" name="lang" class="form-select mb-4"
                onchange="if(this.value) location.href=(this.value);">
            <option value="" th:text="#{select.lang.default}">== SELECT LANGUAGE TYPE ==</option>
            <option value="?lang=en" th:text="#{select.lang.en}">영어</option>
            <option value="?lang=ja" th:text="#{select.lang.ja}">일본어</option>
        </select>
        <hr class="my-4">

        <img class="my-2 mb-5"
             src="https://cdn.discordapp.com/attachments/703627120320184320/1011530716741369927/img.gif"
             alt="hello">

        <div class="col">
            <button class="font-monospace w-100 btn btn-secondary btn-lg" type="button"
                    th:onclick="|location.href='@{/basic/items}'|">
                📑
            </button>
        </div>
        <div class="col">
            <form th:action="@{/login/members/logout}"  method="post">
                <button class="font-monospace w-100 btn btn-dark btn-lg"
                        th:onclick="|location.href='@{/login/}'|"
                        th:text="#{label.login.logout}"
                        type="submit">
                    LOGOUT
                </button>
            </form>
        </div>
    </div>
    <hr class="my-4">
</div>
</body>
</html>

- 로그인한 사용자 전용 화면이다. 상단에 사용자의 이름이 뜬다.

- 로그인하지 않은 사용자에게는 제리를, 로그인한 사용자에게는 톰을 띄워주었다... ㅎㅎㅎ

✔ 로그아웃 처리하기

- 세션 쿠키이기 때문에 웹 브라우저 종료 시 로그아웃 처리가 된다.

- 혹은, 서버에서 임의로 쿠키의 종료 날짜를 0으로 설정할 수 있다.

[LMemberController.java]


  
    
    
    
    
  
@PostMapping("/logout")
public String logout(HttpServletResponse response) {
    Cookie cookie = new Cookie("memberId", null);
    cookie.setMaxAge(0);
    cookie.setPath("/");
    response.addCookie(cookie);
    return "redirect:/login/";
}

- 여기서 약간 의문인 점이, 기존에 존재하는 쿠키를 가져오는 게 아니라 굳이 Cookie를 new로 만들어야 하나? 라는 것이었는데

⭐ 찾아보니까 cookie의 name 속성이 동일할 경우 가장 마지막에 추가된 쿠키만 저장된다고 한다!

- 그래서 어차피 쿠키 1개니까 그냥 새롭게 생성해서 "memberId"인 쿠키의 종료 날짜를 0으로 설정하였다.

| 쿠키의 보안 이슈

- 기본적으로 쿠키의 값은 임의로 변경이 가능하다.

- 개발자 모드 -> Application -> Cookie에서 확인

- 쿠키에 보관된 정보는 탈취가 가능하다.

- 탈취된 쿠키는 해커가 악의적인 요청을 할 수도 있다.

- 그래서 쿠키의 값은 중요한 값을 노출하지 않고, 사용자별로 예측이 안 되는 랜덤값을 노출해야 한다.

- 서버에서 토큰을 관리해서 랜덤값을 통해 매핑된 사용자 정보를 얻어오는 게 바람직하다.

- 해커가 쿠키의 값을 훔쳐가더라도 지속 시간을 짧게 한다.

- 혹은, 해킹이 의심된다면 해당 토큰은 강제로 제거시킨다.

- 다음 포스팅에서는 쿠키 대신 세션을 통해 로그인 처리를 변경해보자.

'Back-end > Spring' 카테고리의 다른 글

[Spring] 서블릿 필터, 스프링 인터셉터, 어노테이션으로 로그인 검증하기 (1)	2022.08.28
[Spring] 상품 관리 시스템에 세션으로 로그인 처리하기 (0)	2022.08.23
[Spring] Bean Validation - 어노테이션을 통해 검증 진행하기 (0)	2022.08.22
[Spring] BindingResult를 활용해서 검증 로직 추가하기, MessageCodesResolver 알아보기 (0)	2022.08.22
[Spring] 메시지와 국제화를 통해 언어 설정 커스텀하기 (0)	2022.08.21