📌 OTP 인증 기능 구현 및 처리 흐름 정리

📝 개요

회사별 인증 방식에 따라 OTP(One-Time Password) 인증 기능을 구현하고 개선하는 작업을 진행했다. 본 기능은 사내 하이브리드 앱 로그인 시 사용자 인증을 보완하기 위한 보안 수단으로 도입되었으며, 각 회사의 정책에 따라 SMS, FCM(Google Push) 방식으로 전송이 가능해야 했다. OTP 발급부터 인증 검증, 디바이스 등록까지의 전 과정을 설정 기반으로 유연하게 처리하도록 구성했다.

⚙️ 전체 구성 흐름

✅ 1. OTP 요청 흐름

1. 사용자가 로그인 요청 (이메일 + 전화번호 입력)
2. 사용자 정보 확인 → 해당 회사의 OTP 사용 여부 및 방식 확인
3. OTP 생성 → 설정된 방식으로 OTP 전송 (SMS / FCM)
4. 전송 성공 시 DB에 OTP 저장

✅ 2. OTP 인증 처리 흐름

1. 사용자 입력 OTP 수신
2. DB에 저장된 OTP와 비교
3. 일치 시 OTP 삭제, 인증 성공 처리
4. JWT 토큰 발급 및 디바이스 등록

✅ 3. OTP 요청 API 처리 (requestOtp())

• 사용자의 전화번호로 OTP 생성 및 전송 요청
• 회사별 설정에 따라 방식 분기 처리 (SMS / GOOGLE_PUSH 등)

int otp = OtpProvider.generateOTP(mobile_number, otpDuration, now.toString());
mdotp.setMobileNo(mobile_number);
mdotp.setOtp(String.valueOf(otp));