백엔드
해외파트너센터 개발 오픈기 — 2. 이메일 인증 공통 서비스 개발 이야기
두줄요약
해외 파트너센터에서 국내 휴대폰 인증 한계를 해결하기 위해 이메일 인증 공통 서비스를 도입했습니다. 별도 도메인과 인증 흐름을 분리해 계정 관리 절차를 연결했습니다.
문제 상황
- 국내용 휴대폰 본인인증 솔루션이 해외 휴대폰 번호를 지원하지 않아 해외 파트너센터 인증 방식 재설계 필요
- SSR 환경에서 국가 정보를 즉시 알기 어려워, 접속 국가 기준 분기 대신 도메인과 로그인 진입점을 분리
- 계정 관리가 국가별로 분리되어 로그인 시점부터 해외/국내 파트너 구분이 필요
해결 방법
- 해외 파트너용 별도 도메인과 로그인 랜딩 페이지 구성
- 이메일 인증을 기본 인증 방식으로 채택하고, 여러 도메인에서 재사용 가능한 이메일 인증 공통 서비스 적용
- emailType 고정값, token, callback URL을 이용해 인증 요청, 검증, 계정 관리 흐름 연결
구조와 흐름
- 비밀번호 찾기 예시에서 이름·이메일 입력 후 인증 메일 발송
- 메일 링크의 email, emailType, token 파라미터를 인증 웹페이지에서 추출해 서버 검증
- 인증 성공 시 체크 페이지로 이동하고, 콜백 URL을 통해 비밀번호 재설정 또는 계정 관리 절차로 연결
적용해볼 점
- 국가·도메인·인증 수단이 얽힌 서비스에서 진입점과 인증 흐름을 명확히 분리하는 설계
- 공통 인증 서비스와 공통 에러 처리로 여러 서비스 확장성 확보