[springboot] Spring Security 6.x로 안전한 회원가입 구현하기 (security 연결, 패스워드 인코딩)

<개발환경>
💻 Apple M1 Pro (macos14.5 on arm64)
🛠️ IDE: IntelliJ
🏁 Language: JAVA17
🔗 Framework: Springboot 3.3.0
⚙️ Project: Gradle
🗄️ Database: MySQL 8.3.0 Homebrew
🖇️ Persistence Framework: MyBatis
🔐 Spring Security 6.3.0

 

Spring Security 6.x 버전에서 달라진 점!

Spring Boot 3.3.0의 spring-boot-starter-security는 Spring Security 6.3.0을 지원합니다.

 

springboot3.x 버전에선 spring security6.x 을 기반으로 상당 부분에 변화가 생겼습니다. 

Spring Security 6 이상의 버전에서는 deprecated되었던 WebSecurityConfigurerAdapter클래스가 제거되었으며, 대신 SecurityFilterChain을 사용하여 HttpSecurity 보안 구성을 처리합니다.

또한 기존의 AccessDecisionManager를 대체하는 AuthorizationManager 인터페이스가 도입되었습니다.

 

프로젝트 설정

의존성 추가

• build.gradle

// Spring Boot Security
implementation 'org.springframework.boot:spring-boot-starter-security'

 

코드 구현

SecurityConfig - Spring Security 설정

• SecurityConfig.java 

@Configuration // Spring 설정 클래스임
@EnableWebSecurity // Spring Security를 활성화
public class SecurityConfig {
    @Autowired
    private CustomUserDetailsService userDetailsService;

    // HTTP 보안 설정을 구성하는 메서드
    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
                .authorizeHttpRequests(authorizeRequests -> // HTTP 요청에 대한 보안 규칙을 정의
                        authorizeRequests
                                .requestMatchers("/user/**").permitAll() // /user/** 경로에 대한 접근을 허용
                                .anyRequest().authenticated() // 그 외의 모든 요청은 인증을 요구
                )
                .csrf(csrf -> csrf.disable());
        return http.build(); // HTTP 보안 설정을 빌드하여 반환
    }

    // 비밀번호 인코더를 정의
    @Bean
    public PasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder(); // BCryptPasswordEncoder를 반환. 이는 비밀번호를 암호화하는 데 사용됨
    }
}

 

회원가입 api 구현 (Controller, Request, Dto, Service, Mapper)

• UserController.java

public class UserController {

    private final UserService userService;
  
    private final String EP_ADD_USER = "/signup";

    @PostMapping(EP_ADD_USER)
    public UserDto.SignUp addUser(@RequestBody UserRequest.SignUpRequest body) {
        return userService.signUp(body);
    }
}

• UserRequest.java

public class UserRequest {
    @Data
    public static class SignUpRequest {
        private String username;
        private String password;
        private String email;
    }
}

• UserDto.java

@NoArgsConstructor
@Data
public class UserDto {
    @Data
    public static class UserBase {
        private String id;
        private String username;
        @JsonIgnore
        private String password;
        private String email;
        private boolean enabled;
        private String role;
        private String createdAt;
        private String updatedAt;
    }


    @Data
    public static class SignUp extends UserBase{
        @Builder
        public SignUp(String id,
                      String username,
                      String password,
                      String email,
                      boolean enabled,
                      String role,
                      String createdAt,
                      String updatedAt) {
            setId(id);
            setUsername(username);
            setPassword(password);
            setEmail(email);
            setEnabled(enabled);
            setRole(role);
            setCreatedAt(createdAt);
            setUpdatedAt(updatedAt);
        }
    }

    @Data
    @Builder
    public static class UserSearchByEmailCondition {
        private String email;
    }

}

• UserMapper.java

@Mapper
public interface UserMapper {
    int signUp(UserDto.SignUp param);
}

• UserService.java

@Service
@Slf4j
@AllArgsConstructor
public class UserService {

    private final UserMapper userMapper;

    @Autowired
    private PasswordEncoder passwordEncoder;

    @Transactional
    public UserDto.SignUp signUp(UserRequest.SignUpRequest param) {
        // 비밀번호를 BCrypt 형식으로 인코딩
        String encodedPassword = passwordEncoder.encode(param.getPassword());

        UserDto.SignUp dto = UserDto.SignUp.builder()
                .username(param.getUsername())
                .password(encodedPassword)
                .email(param.getEmail())
                .build();

        userMapper.signUp(dto);

        return dto;
    }
}

• UserMapper.xml

    <insert id="signUp"
            parameterType="com.tistory.project_api.dto.UserDto$SignUp">
        <selectKey keyProperty="id" resultType="string" order="BEFORE">
            SELECT CONCAT('U', DATE_FORMAT(NOW(), '%y%m%d'),
                   LPAD(CAST(COALESCE(MAX(CAST(SUBSTRING(id, 8) AS UNSIGNED)), 0) + 1 AS CHAR), 6, '0')) AS id
            FROM user
            WHERE SUBSTRING(id, 2, 6) = DATE_FORMAT(NOW(), '%y%m%d');
        </selectKey>

        INSERT INTO USER (id, username, password, email, enabled, role, created_at, updated_at)
        VALUES (#{id}, #{username}, #{password}, #{email}, true, 'user', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
    </insert>

 

GitHub - a-taeyeon/springboot-tistory-example