Replit 앱에서 Twilio Verify로 사용자 전화번호 인증하기 (Node.js)

Twilio Verify를 활용해 Replit 환경에서 사용자 전화번호를 인증하는 방법을 Node.js/Express로 구현한다. SMS OTP 발송·검증을 Twilio가 처리하고, Replit의 Secrets 관리자로 인증 정보를 안전하게 보관하며, 전화번호 인증 게이트가 적용된 투표 앱을 단계별로 구축한다.

핵심 포인트

Twilio Verify가 SMS OTP 발송과 검증을 담당해 앱 로직에만 집중할 수 있다
Replit Secrets 관리자로 API 키를 환경변수로 안전하게 주입한다
전화번호는 E.164 형식 필수, 10분 내 5회 초과 요청 시 rate limit 발동
channel 파라미터 변경만으로 WhatsApp, 이메일, 음성 채널로 손쉽게 확장 가능하다

상세 정리

예제 앱: 전화번호 인증 후 강아지 이름 투표 앱으로 1번호 1투표 게이트를 구현한다
설정: GitHub에서 Node.js/Express 레포를 Replit으로 임포트 → Secrets 관리자에 4개 환경변수 등록
필수 환경변수: TWILIO_ACCOUNT_SID, TWILIO_API_KEY, TWILIO_API_SECRET, TWILIO_VERIFY_SERVICE_SID
OTP 발송 코드: client.verify.v2.services(SID).verifications.create({to: phoneNumber, channel: 'sms'})
OTP 검증 코드: verificationChecks.create({to, code}) → status === 'approved' 판별
전화번호 형식: E.164(+국가코드+번호) 필수, 잘못된 형식이면 인증 발송 실패
Rate limit: 동일 번호로 10분 내 5회 초과 발송 시 차단, 개발 중 주의 필요
확장: channel 파라미터를 sms에서 whatsapp / email / voice로 교체해 채널 전환 가능