[OneStack]팀 프로젝트 개발 과정 - JavaMailSender 비밀번호 재설정

본 프로젝트 개발자 과정 학원의 파이널 프로젝트 기획, 개발, 배포 과정을 담고 있습니다. 

 

OneStack

 

---

JavaMailSender란?

JavaMailSender는 Spring Framework에서 제공하는

이메일 발송 기능을 쉽게 구현할 수 있도록 지원하는 인터페이스입니다.
SMTP 설정을 활용하여 메일 서버에 연결하고 HTML 템플릿을 적용할 수 있으며, 비동기 메일 발송도 가능합니다.

JavaMailSender의 주요 기능

• SMTP 서버를 이용한 메일 발송
• HTML 템플릿 지원 (Thymeleaf 등 활용 가능)
• 첨부 파일 전송 기능 제공
• 비동기 메일 발송 가능

---

비밀번호 재설정 기능 구현

비밀번호 재설정 기능은 사용자가 비밀번호를 잊었을 때 이메일을 통해 재설정할 수 있도록 도와주는 기능입니다.
아래와 같은 단계로 구현됩니다.

1. 의존성 추가

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

2. SMTP 설정 (application.properties)

spring.mail.host=smtp.gmail.com 
spring.mail.port=587 spring.mail.username=${GMAIL_USERNAME} 
spring.mail.password=${GMAIL_PASSWORD} 
spring.mail.properties.mail.smtp.auth=true 
spring.mail.properties.mail.smtp.starttls.enable=true

🔹 환경 변수로 관리하여 보안성을 높이는 것이 중요합니다.
🔹 Gmail의 경우 '앱 비밀번호'를 발급받아 사용해야 합니다.

3. 비밀번호 재설정 토큰 엔티티

@Getter @Setter
@NoArgsConstructor
@AllArgsConstructor
public class PasswordResetToken {
    private String token;
    private String memberId;
    private LocalDateTime expiryDate;
    private boolean used;
}

🔹 UUID를 사용하여 고유한 토큰을 생성하고,
🔹 24시간 동안만 유효하도록 만료 시간을 설정합니다.

4. MemberService에서의 비밀번호 재설정 로직

@Service
@Slf4j
@RequiredArgsConstructor
public class MemberService {
    private final JavaMailSender mailSender;
    private final PasswordEncoder passwordEncoder;

    public void sendPasswordResetEmail(String memberId, String email) {
        try {
            // 토큰 생성
            String token = UUID.randomUUID().toString();
            LocalDateTime expiryDate = LocalDateTime.now().plusHours(24);

            // 토큰 저장
            PasswordResetToken resetToken = new PasswordResetToken(token, memberId, expiryDate, false);
            memberMapper.savePasswordResetToken(resetToken);

            // 비밀번호 재설정 링크 생성
            String resetLink = "https://www.onestack.store/resetPassword?token=" + token;
            
            // 이메일 내용 구성
            SimpleMailMessage message = new SimpleMailMessage();
            message.setTo(email);
            message.setSubject("OneStack 비밀번호 재설정");
            message.setText("안녕하세요!\n" +
                    "비밀번호 재설정을 위한 링크를 보내드립니다.\n\n" +
                    resetLink + "\n\n" +
                    "이 링크는 24시간 동안 유효합니다.");

            // 메일 발송
            mailSender.send(message);
            log.info("비밀번호 재설정 메일 발송 완료: {}", email);
            
        } catch (Exception e) {
            log.error("비밀번호 재설정 메일 발송 실패: {}", e.getMessage());
            throw new RuntimeException("비밀번호 재설정 메일 발송에 실패했습니다.");
        }
    }

    public void resetPassword(String token, String newPassword) {
        PasswordResetToken resetToken = memberMapper.findByToken(token);

        if (resetToken == null || resetToken.isUsed() || resetToken.getExpiryDate().isBefore(LocalDateTime.now())) {
            throw new RuntimeException("유효하지 않거나 만료된 토큰입니다.");
        }

        try {
            // 비밀번호 암호화 후 업데이트
            String encodedPassword = passwordEncoder.encode(newPassword);
            memberMapper.updatePassword(resetToken.getMemberId(), encodedPassword);

            // 토큰 사용 완료 처리
            memberMapper.deletePasswordResetToken(token);
            
            log.info("비밀번호 재설정 완료: {}", resetToken.getMemberId());
            
        } catch (Exception e) {
            log.error("비밀번호 재설정 실패: {}", e.getMessage());
            throw new RuntimeException("비밀번호 재설정에 실패했습니다.");
        }
    }
}

🔹 토큰을 생성하여 데이터베이스에 저장하고,
🔹 이메일을 통해 사용자가 링크를 클릭하면 비밀번호를 재설정할 수 있도록 처리합니다.

5. 컨트롤러에서의 처리

@Controller
@Slf4j
public class MemberController {
    
    @PostMapping("/findPass")
    @ResponseBody
    public Map<String, Object> findPass(@RequestParam String memberId, @RequestParam String email) {
        Map<String, Object> response = new HashMap<>();
        
        try {
            memberService.sendPasswordResetEmail(memberId, email);
            response.put("success", true);
            response.put("message", "비밀번호 재설정 링크가 이메일로 전송되었습니다.");
        } catch (Exception e) {
            response.put("success", false);
            response.put("message", e.getMessage());
        }
        
        return response;
    }

    @PostMapping("/resetPassword")
    @ResponseBody
    public Map<String, Object> resetPassword(@RequestParam String token, @RequestParam String newPassword) {
        Map<String, Object> response = new HashMap<>();
        
        try {
            memberService.resetPassword(token, newPassword);
            response.put("success", true);
            response.put("message", "비밀번호가 성공적으로 변경되었습니다.");
        } catch (Exception e) {
            response.put("success", false);
            response.put("message", e.getMessage());
        }
        
        return response;
    }
}

🔹 요청이 들어오면 적절한 서비스 메서드를 호출하여 처리합니다.
🔹 에러 발생 시 사용자에게 명확한 메시지를 반환합니다.

---

구현의 특징과 장점

✅ 보안 강화

• UUID를 활용한 고유 토큰 생성
• 24시간 제한된 토큰 유효기간
• 비밀번호 암호화 저장
• 사용된 토큰 즉시 삭제

✅ 사용자 경험 개선

• 직관적인 이메일 안내 메시지
• 클릭 한 번으로 비밀번호 재설정 페이지 접근
• 실시간 피드백 제공

✅ 확장성 고려

• HTML 템플릿 적용 가능
• 비동기 메일 발송 가능
• 다양한 메일 서비스 적용 가능

---

개선 가능 포인트

🔹 HTML 템플릿 적용

• Thymeleaf 등을 활용하여 보다 시각적으로 개선된 메일 템플릿 적용
• 브랜드 로고 및 스타일 추가

🔹 비동기 처리 적용

• @Async 어노테이션을 활용하여 비동기 방식으로 메일 발송
• 사용자 대기 시간을 단축하고 성능 개선

🔹 보안 강화

• IP 기반 요청 제한
• 비밀번호 변경 시 추가 인증 단계 도입
• 비정상적인 요청 탐지 및 차단

---

마무리

JavaMailSender를 활용한 비밀번호 재설정 기능은 보안성과 사용자 경험을 동시에 고려해야 하는 중요한 기능입니다.
위 구현 방식을 참고하여 여러분의 프로젝트에 맞게 적용해 보세요!

궁금한 점이 있거나, 더 좋은 방법이 있다면 댓글로 공유해주세요! 🚀