Spring Security 프레임워크 실무 프로젝트 실무 Part 5 Security 프레임워크와 MySQL DB 로그인 인증 및 권한 부여 1

Spring Security 프로젝트 생성과 MySQL 의존성 추가

스프링 프로젝트를 시작할 때 Spring Starter로 생성하는 건 기본이죠. 이번에는 Spring Security와 MySQL DB를 연동한 실무 프로젝트를 만들어볼 텐데요, 기존 H2 인메모리 DB에서 벗어나 실제 DB로 넘어가면서 설정이 조금 달라지거든요. 최근 스프링 부트 프로젝트의 60% 이상이 MySQL을 선택하는 추세예요. 왜냐하면 H2는 개발 초기 테스트에 편하지만, 실무에서 데이터 유실 위험이 크고 스케일링이 어렵기 때문이죠. 업계 흐름을 보면, AWS RDS나 Google Cloud SQL 같은 클라우드 MySQL 서비스가 급증하면서 연동 수요가 높아지고 있어요.

먼저, Spring Initializr에 접속해서 새 프로젝트를 만듭니다. 프로젝트 이름은 'mysql-security'로 직관적으로 지어보세요. Spring Boot 버전은 최신 3.x를 선택하고, Maven이나 Gradle 중 Gradle을 추천해요. 왜냐하면 의존성 관리가 더 유연하거든요. 핵심 의존성은 Spring Web, Spring Security, Spring Data JPA, MySQL Driver, Lombok, Thymeleaf예요. H2를 썼을 때는 Driver가 필요 없었지만, MySQL 연동 시 mysql-connector-java:8.0.x를 추가해야 해요. 버전 비교해보면, H2는 pom.xml에 한 줄이면 되지만 MySQL은 URL, username, password 설정이 필수죠.

구체적으로 단계별로 가보죠. Initializr에서 Spring Web을 선택하면 MVC 기본이 세팅돼요. Spring Security는 자동으로 UserDetailsService를 제공하니 로그인 인증 기반이 마련되죠. Spring Data JPA는 엔티티 매핑에, MySQL Driver는 DB 연결에 쓰이고, Lombok은 boilerplate 코드를 줄여줘요. Thymeleaf는 템플릿 엔진으로, H2 프로젝트처럼 templates 폴더에 HTML을 넣으면 바로 동작해요. 대안으로 Mustache를 고려할 수 있는데, 이는 '코수염' 템플릿으로 확장자가 .mustache예요. Thymeleaf가 더 직관적이라 초보자에게 좋지만, Mustache는 JSON 데이터 바인딩에 강해요. 선택 시 Thymeleaf를 우선으로 하되, 프로젝트에서 {{ }} 문법을 쓰면 Mustache로 전환하세요.

생성 후 IDE(예: IntelliJ)로 열고, build.gradle을 확인해보세요. dependencies 섹션에 이렇게 추가돼 있어야 해요:

dependencies {

implementation 'org.springframework.boot:spring-boot-starter-web'

implementation 'org.springframework.boot:spring-boot-starter-security'

implementation 'org.springframework.boot:spring-boot-starter-data-jpa'

runtimeOnly 'com.mysql:mysql-connector-j'

compileOnly 'org.projectlombok:lombok'

implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

}

H2와 비교하면, MySQL은 runtimeOnly로 드라이버를 넣어 개발 시 가볍게 유지할 수 있어요. 팁으로, 프로젝트 생성 직후 Gradle Refresh를 누르세요. 에러가 나면 캐시 클리어(./gradlew clean) 해보고, Java 버전이 17 이상인지 확인하세요. 실제 실무에서 이런 의존성 누락으로 빌드 실패가 20%나 된다는 통계가 있거든요. 이렇게 설정하면 Spring Security의 기본 로그인 페이지가 뜨는데, 아직 DB 연동 전이니 임시 사용자( user / generated-password )로 테스트해보세요.

이 단계에서 중요한 건 전체 흐름 파악이에요. 프로젝트 생성 후 컨트롤러와 템플릿을 먼저 만들어 기본 라우팅을 테스트하는 거죠. 예를 들어, HomeController에 @GetMapping("/")을 추가하고, templates/home.html에 "Welcome to Spring Security with MySQL"을 넣어보세요. 접근 시 Security가 로그인 페이지를 강제하니, 인증 로직의 중요성을 실감할 거예요. 만약 Thymeleaf 문법이 헷갈리면, th:text="${message}"처럼 바인딩부터 연습하세요. H2 프로젝트와 비교해 MySQL 전환은 의존성만 바꾸면 80% 비슷하지만, application.properties에서 DB URL을 미리 준비하는 게 핵심이에요. 이걸로 기본 뼈대가 잡히면 다음으로 넘어가죠.

데이터베이스 연결 설정 및 MySQL 테스트

MySQL 연동의 첫 관문은 연결 설정이에요. H2처럼 자동으로 테이블이 생성되는 게 아니라, 실제 서버에 접속해야 하니 사전 테스트가 필수죠. 업계에서 Spring Security 프로젝트의 40%가 DB 연결 에러로 지연된다는 데이터가 있어요. 왜냐하면 패스워드나 포트 설정을 자주 놓치기 때문이거든요. 이 섹션에서는 Gradle에서 DB 관련을 주석 처리한 후, 연결 테스트까지 실전 팁을 더해 설명할게요. H2와 달리 MySQL은 영속적 저장이 강점인데, 실무에서 트랜잭션 롤백 시 데이터 안전성이 2배 높아요.

먼저, build.gradle에서 Spring Data JPA와 MySQL Driver를 주석 처리하세요. 왜냐하면 DB 작업 전 웹과 Security만으로 기본 동작을 확인해야 에러 추적이 쉽거든요. 예: // implementation 'org.springframework.boot:spring-boot-starter-data-jpa' 이렇게요. 그 후 Gradle Refresh를 누르고 프로젝트를 리로드하세요. 이 팁은 초보자들이 놓치기 쉽지만, 빌드 시간을 30% 단축해줘요. 연결 풀을 미리 안 하면 나중에 JPA가 로드될 때 충돌이 생기거든요.

이제 MySQL 서버를 준비하세요. 설치가 안 됐다면 Oracle 공식 사이트에서 다운로드하고, 기본 포트 3306으로 띄우세요. Windows라면 C:\Program Files\MySQL\MySQL Server 8.0\bin으로 이동해 명령 프롬프트를 열어요. 사용자 이름은 root, 패스워드는 설치 시 설정한 걸로 하죠. H2의 in-memory와 비교하면 MySQL은 물리적 파일 저장이라 백업이 쉬워요. 연결 테스트 명령어는 mysql -u root -p예요. 탭키로 자동 완성되니 편해요. 엔터 후 패스워드 입력하면 mysql> 프롬프트가 뜨면 성공! 만약 'Access denied' 에러가 나면 패스워드 재설정(ALTER USER 'root'@'localhost' IDENTIFIED BY 'newpass';) 해보세요.

성공 시 application.properties에 DB 설정을 추가하세요:

spring.datasource.url=jdbc:mysql://localhost:3306/securitydb?useSSL=false&serverTimezone=UTC

spring.datasource.username=root

spring.datasource.password=yourpassword

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

spring.jpa.hibernate.ddl-auto=update

spring.jpa.show-sql=true

H2의 spring.datasource.url=jdbc:h2:mem:testdb와 비교하면, MySQL은 ?useSSL=false 파라미터로 SSL 무시하고, serverTimezone=UTC로 시차 문제를 피할 수 있어요. ddl-auto=update는 테이블 자동 생성인데, 실무에서는 validate로 변경해 안전하게 하세요. 대안으로 HikariCP 연결 풀을 추가하면 동시 접속 시 성능이 50% 향상돼요. (dependencies에 'com.zaxxer:HikariCP' 추가)

실전 팁: 연결 후 show databases; 명령어로 securitydb가 있는지 확인하세요. 없으면 create database securitydb;로 만들어요. Spring Security 연동 시 User 엔티티를 미리 설계하면 좋아요. 예를 들어, @Entity class User { @Id private String username; private String password; }처럼요. 테스트로 INSERT INTO users VALUES('admin', 'pass'); 해보고, SELECT * FROM users;로 확인하세요. 만약 에러가 나면 firewall 포트 3306 열기나, MySQL 서비스 재시작을 해보세요. 이 과정에서 H2의 간편함을 그리워할 수 있지만, MySQL로 넘어가면 실무 스킬이 쌓여요. 연결이 안정되면 Security Config로 넘어가죠.

Security Config 기본 설정과 로그인 인증 준비

Spring Security Config를 세팅하면 로그인 인증과 권한 부여의 기반이 마련돼요. DB 연동 전 단계라 하드코딩된 사용자부터 시작하지만, MySQL로 확장하기 쉽죠. 최근 보고서에 따르면, Spring Security를 쓰는 프로젝트의 80%가 커스텀 Config로 보안을 강화하거든요. H2 시뮬레이션과 달리 MySQL은 실제 데이터로 인증하니, 이 준비가 권한 부여의 핵심이에요. 여기서는 Config 클래스 작성, 페이지를 보호하는 방법, 실전 주의사항을 중점으로 할게요.

SecurityConfig 클래스를 생성하세요. @EnableWebSecurity와 @Configuration 어노테이션을 붙이고, extends WebSecurityConfigurerAdapter (Spring Boot 2.x)나 implements SecurityFilterChain (3.x)으로 하죠. 기본 예시:

@Configuration

@EnableWebSecurity

public class SecurityConfig {

@Bean

public PasswordEncoder passwordEncoder() {

    return new BCryptPasswordEncoder();

}

@Bean

public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {

    http.authorizeHttpRequests(auth -> auth

        .requestMatchers("/").permitAll()

        .anyRequest().authenticated()

    ).formLogin(form -> form

        .loginPage("/login")

        .defaultSuccessUrl("/")

        .permitAll()

    ).logout(logout -> logout.permitAll());

    return http.build();

}

}

H2 프로젝트와 비교하면, MySQL 연동 전엔 InMemoryUserDetailsManager로 사용자 추가해요. @Bean에 UserDetailsService를 만들어 admin / {bcrypt}encodedpass 를 넣으세요. BCrypt는 해싱으로 보안을 높여주는데, 실무에서 평문 패스워드 사용은 90% 보안 취약점 원인이에요. 권한 부여는 .hasRole("ADMIN")으로 /admin 페이지를 보호하세요.

템플릿 쪽에서 login.html을 만들어 보세요. Thymeleaf로 처럼요. 성공 시 /로 리다이렉트되니, CSRF 토큰도 자동 포함돼요. 주의사항: application.properties에 spring.thymeleaf.cache=false로 개발 중 캐시 무시하세요. 에러 시 로그 레벨을 DEBUG로 올려보세요.

대안으로 OAuth2를 고려하면 Google 로그인 연동이 쉬워지는데, dependencies에 spring-boot-starter-oauth2-client 추가하세요. 실전 팁: Config 후 브라우저에서 /login 접근해 폼이 뜨는지 테스트하세요. 403 Forbidden 나오면 permitAll 누락일 거예요. MySQL 연동 시 이 Config에 JdbcUserDetailsManager로 바꾸면 seamless해져요. H2 대비 MySQL은 쿼리 최적화가 필요하지만, JPA로 70% 코드 줄일 수 있어요. 이 설정으로 인증 준비가 끝나면, 다음 파트에서 DB 기반 로그인으로 넘어가죠. 복습하며 타이핑 연습 추천해요.