스프링 부트 백엔드 개발 강좌, 스프링 시큐리티로 로그인 로그아웃, 회원 가입 구현, 리포지터리 만들기

안녕하세요! 이번 블로그 포스트에서는 스프링 부트를 이용하여 백엔드 개발을 하는 방법을 배우고, 스프링 시큐리티를 활용하여 로그인 및 로그아웃 기능을 구현하는 방법, 그리고 회원 가입 기능을 추가하는 방법에 대해 자세히 알아보겠습니다. 또한, 데이터베이스와의 상호작용을 위해 리포지터리를 만드는 방법도 함께 다뤄볼 것입니다. 이 강좌는 초보자부터 중급者까지 모두에게 적합한 내용으로 구성되어 있습니다.

1. 스프링 부트란?

스프링 부트(Spring Boot)는 스프링 프레임워크를 기반으로 하여 빠르게 애플리케이션을 개발할 수 있도록 도와주는 프레임워크입니다. 스프링 부트를 사용하면 복잡한 설정을 최소화하고 신속하게 마이크로서비스 또는 독립 실행형 애플리케이션을 제작할 수 있습니다. 스프링 부트의 주요 특징은 다음과 같습니다:

• 자동 구성(Auto Configuration): 복잡한 XML 설정 없이 코드와 어노테이션을 통해 쉽게 설정할 수 있습니다.
• 스타터(Starters): 필요한 의존성을 묶어놓은 스타터를 사용하여 손쉬운 의존성 관리가 가능합니다.
• 배포 용이성: 단독 실행 가능한 JAR 파일로 쉽게 배포할 수 있습니다.

2. 프로젝트 설정하기

스프링 부트 프로젝트는 Spring Initializr를 사용하여 빠르게 생성할 수 있습니다. 필요한 의존성을 선택하고, Maven 프로젝트를 생성하여 IDE에 불러옵니다. 아래는 필수 의존성 리스트입니다:

• Spring Web
• Spring Security
• Spring Data JPA
• H2 Database

2.1 인텔리J를 이용한 프로젝트 생성

인텔리J를 이용하여 프로젝트를 생성하는 방법을 살펴보겠습니다. 먼저, 인텔리J를 열고 다음 단계를 따릅니다:

1. File > New > Project 선택
2. Spring Initializr 선택 후 ‘Next’
3. Group, Artifact, Name 입력 후 ‘Next’
4. 필요한 의존성 선택 후 ‘Finish’

3. 스프링 시큐리티 설정

스프링 시큐리티(Spring Security)는 스프링 애플리케이션에 보안 기능을 추가하는 데 사용되는 강력한 프레임워크입니다. 인증(Authentication)과 인가(Authorization) 기능을 쉽게 구현할 수 있도록 지원합니다. 여기서는 기본적인 로그인/로그아웃 기능을 구현해보겠습니다.

3.1 스프링 시큐리티 의존성 추가

Spring Initializr에서 선택한 의존성에 이미 포함되어 있지만, 추가로 필요시 pom.xml 파일에 스프링 시큐리티 의존성을 추가할 수 있습니다:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>

3.2 SecurityConfig 클래스 생성

스프링 시큐리티를 설정하기 위해 `SecurityConfig` 클래스를 생성합니다. 이 클래스는 스프링 시큐리티의 보안 필터 체인을 구성합니다:

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .antMatchers("/login", "/register").permitAll() // 로그인, 회원가입 페이지 접근 허용
                .anyRequest().authenticated() // 다른 모든 요청은 인증 필요
            .and()
            .formLogin()
                .loginPage("/login") // 로그인 페이지 설정
                .permitAll() // 모든 사용자 접근 허용
            .and()
            .logout()
                .permitAll(); // 로그아웃 기능 허용
    }
}

4. 회원 가입 구현

회원 가입 기능을 구현하기 위해 User 엔티티와 UserRepository를 생성하겠습니다. 이후 회원 정보를 데이터베이스에 저장하는 서비스를 만들어 보겠습니다.

4.1 User 엔티티 생성

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String username;
    private String password;
    
    // getters and setters
}

4.2 UserRepository 인터페이스 생성

import org.springframework.data.jpa.repository.JpaRepository;
import java.util.Optional;

public interface UserRepository extends JpaRepository<User, Long> {
    Optional<User> findByUsername(String username);
}

4.3 회원가입 서비스 구현

회원 가입을 위해 UserService 클래스를 생성하여 사용자 정보를 처리합니다:

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.stereotype.Service;

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;

    private BCryptPasswordEncoder passwordEncoder = new BCryptPasswordEncoder();

    public void registerUser(User user) {
        String encodedPassword = passwordEncoder.encode(user.getPassword());
        user.setPassword(encodedPassword); // 비밀번호 암호화
        userRepository.save(user); // 사용자 정보 저장
    }
}

4.4 회원가입 컨트롤러 구현

회원가입 요청을 처리할 컨트롤러를 생성합니다:

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.ModelAttribute;

@Controller
public class UserController {
    @Autowired
    private UserService userService;

    @GetMapping("/register")
    public String showRegistrationForm(Model model) {
        model.addAttribute("user", new User());
        return "register"; // 회원가입 페이지로 이동
    }

    @PostMapping("/register")
    public String registerUser(@ModelAttribute User user) {
        userService.registerUser(user); // 사용자 등록 처리
        return "redirect:/login"; // 로그인 페이지로 리다이렉트
    }
}

5. 뷰 템플릿 구현

스프링 부트에서는 Thymeleaf를 주로 사용하여 HTML 템플릿을 작성합니다. 뷰 템플릿을 생성하여 로그인 및 회원가입 페이지를 만들어 보겠습니다.

5.1 로그인 페이지

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>로그인 페이지</title>
</head>
<body>
    <h1>로그인</h1>
    <form th:action="@{/login}" method="post">
        <div>
            <label>아이디:</label>
            <input type="text" name="username" required />
        </div>
        <div>
            <label>비밀번호:</label>
            <input type="password" name="password" required />
        </div>
        <button type="submit">로그인</button>
    </form>
    <a th:href="@{/register}">회원가입 하러가기</a>
</body>
</html>

5.2 회원가입 페이지

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>회원가입 페이지</title>
</head>
<body>
    <h1>회원가입</h1>
    <form th:action="@{/register}" method="post">
        <div>
            <label>아이디:</label>
            <input type="text" name="username" required />
        </div>
        <div>
            <label>비밀번호:</label>
            <input type="password" name="password" required />
        </div>
        <button type="submit">가입하기</button>
    </form>
    <a th:href="@{/login}">로그인 하러가기</a>
</body>
</html>

6. 결론

이번 포스트에서는 스프링 부트를 사용하여 백엔드 애플리케이션을 개발하는 방법과 스프링 시큐리티를 통한 로그인 및 회원가입 기능을 구현하는 방법에 대해 알아보았습니다. 간단한 예제를 통해 스프링 부트의 기본 사용법과 보안 기능을 이해할 수 있었습니다. 실습을 통해 효과적인 학습이 이뤄지길 바랍니다.

향후 프로젝트를 진행하면서 더 복잡한 기능들을 구현하고 심화된 기술을 배워보세요. 계속해서 학습하고 성장해 가는 개발자가 되시길 바랍니다. 감사합니다!