[싹틔움] 11/07 개발일지 회원가입시 이메일 인증 받기 1 : 이메일 인증코드 전송

💡 목표

회원가입시에 이메일 인증을 추가로 받아 중복방지 및 보안성 강화를 목적으로 두었다.

 

build.gradle

// Google Email
implementation 'org.springframework.boot:spring-boot-starter-mail'

 

의존성 주입을 해준다.

---

EmailConfig

@Slf4j
@Configuration
@RequiredArgsConstructor
public class EmailConfig {

    private final JavaMailSender javaMailSender;

    private final String SUBJECT = "[싹틔움] 인증메일 입니다.";

    public boolean sendCertificationMain(String email, String certificationNumber) {

        try {
            MimeMessage message = javaMailSender.createMimeMessage();
            MimeMessageHelper messageHelper = new MimeMessageHelper(message, true);

            String htmlContent = getCertificationMessage(certificationNumber);

            messageHelper.setTo(email);
            messageHelper.setSubject(SUBJECT);
            messageHelper.setText(htmlContent, true);

            javaMailSender.send(message);

            log.info("이메일 발신 성공 : {}", email);

        } catch (Exception e) {
            log.error("이메일 발신 실패 : {}", email, e);
            return false;
        }
        return true;
    }

        private String getCertificationMessage (String certificationNumber) {
            String certificationMessage = "";
            certificationMessage += "<div style='text-align: center;'><img src=\"https://img1.daumcdn.net/thumb/R1280x0/?scode=mtistory2&fname=https%3A%2F%2Fblog.kakaocdn.net%2Fdn%2FVbXC4%2FbtsKePF4r6K%2FHdV3AU33uDf8khBSMLMLU0%2Fimg.png\"></div>";
            certificationMessage += "<h1 style='text-align: center;'>[싹틔움] 인증메일</h1>";
            certificationMessage += "<h3 style='text-align: center;'>인증코드: <string style='font-size:32px; letter-spacing: 8px;'>"
                    + certificationNumber + "</strong></h3>";
            return certificationMessage;
        }
    }

 

이메일을 전송하는 메서드이다.

getCertificationMessage 메서드를 통해서 원하는 형태로 메일을 만들고, SUBJECT 제목과 함께 메일을 전송한다.

---

EmailCertificationController

@RestController
@RequiredArgsConstructor
public class EmailCertificationController {

    private final EmailCertificationService emailCertificationService;

    @PostMapping("/v2/auth/email-certification")
    public ResponseEntity<CommonResponse<String>> emailCertification(
            @RequestBody @Valid
            EmailCertificationRequestDto requestDto
    ) {
        return ResponseEntity.ok(CommonResponse.success(emailCertificationService.emailCertification(requestDto)));
    }
}

---

EmailCertificationRequestDto

@Getter
@NoArgsConstructor
public class EmailCertificationRequestDto {

    @Email
    @NotBlank
    private String email;
}

 

이메일을 Dto 에 담아서 인증번호를 날려야하기 때문에 email 하나만 담았다.

---

EmailCertificationService

@Service
@RequiredArgsConstructor
public class EmailCertificationService {

    private final EmailConfig emailConfig;

    private final UserService userService;

    public String emailCertification(EmailCertificationRequestDto requestDto) {
        // 입력한 이메일로 중복 유무 확인
        String email = requestDto.getEmail();
        boolean isExisted = userService.existsByEmail(email);
        if(isExisted) throw new DuplicateEmailException();

        // 4자리 인증번호 생성
        String certificationNumber = getCertificationNumber();

        // 이메일 발신 성공 여부 확인
        boolean isSuccessed = emailConfig.sendCertificationMain(email, certificationNumber);

        // 실패시 예외처리
        if (!isSuccessed) throw new BusinessLogicException();


        return "이메일이 정상적으로 전송되었습니다.";
    }

    // 4자리 인증번호 생성 메서드
    public static String getCertificationNumber() {
        String certificationNumber = "";
        for (int count = 0; count < 4; count++) {
            certificationNumber += (int) (Math.random() * 10);
        }

        return certificationNumber;
    }
}

 

기존 이메일과 중복인지 확인하고, 중복검사에서 통과한다면 4자리 인증번호를 랜덤으로 생성해서 메일을 전송시켰다.

---

💡 트러블 슈팅

 

TLS 에러가 발생했다.

"Could not convert socket to TLS"  오류는 클라이언트와 서버 간 SSL/TLS 핸드셰이크 실패로 인해 발생한다.

주로 잘못된 인증서 설정이나 네트워크 연결 문제가 원인이다.

 

properties:
  mail:
    smtp:
      auth: true
      starttls:
        enable: true
        required: true
      ssl:
        trust: smtp.gmail.com

 

starttls : required : true
ssl: truest 를 추가하면서 해결이 되었다.

 

 

• starttls.required=true:
  • 이 설정은 SMTP 서버와의 통신에 TLS가 반드시 필요함을 지정한다.
  • 이를 통해 클라이언트가 서버와 반드시 암호화된 통신을 하도록 강제해, TLS 핸드셰이크 실패를 방지할 수 있다.
• ssl.trust=smtp.gmail.com:
  • 이 설정은 Gmail의 SMTP 서버 인증서를 신뢰하도록 지정한다.
  • Gmail 서버와의 연결에서 인증서 신뢰 문제가 발생할 수 있는데, 이를 통해 클라이언트가 Gmail의 인증서를 신뢰하게 되어 TLS 설정이 성공적으로 이루어진다.

---

 

 

다음 글

https://hanstory33.tistory.com/259