다크 모드
전화번호 인증
정보
전화번호 인증은 truloop의 유일한 로그인 수단으로, SMS 인증번호를 통해 본인 확인을 수행합니다. 소셜 로그인은 지원하지 않습니다.
기능 소개
- 사용자가 전화번호를 입력하면 SMS로 인증번호가 발송됩니다.
- 인증번호를 정확히 입력하면 본인 확인이 완료되고, 인증 토큰이 발급됩니다.
- 인증 토큰으로 로그인을 시도합니다. 기존 사용자는 홈 화면으로 이동하고, 가입된 계정이 없는 신규 사용자는 온보딩 화면으로 이동합니다.
- 로그인 상태가 자동으로 유지되어 매번 인증할 필요가 없습니다.
동작 규칙
- 전화번호 기반 인증 전용: truloop은 전화번호 + SMS 인증번호 방식만 사용합니다. Google, Apple 등 소셜 로그인은 지원하지 않습니다.
- 지원 국가 제한: SMS 인증은 특정 국가의 전화번호만 지원합니다. 지원되지 않는 국가의 전화번호로는 인증번호를 요청할 수 없습니다.
- 인증번호 유효 시간: SMS로 발송된 인증번호에는 유효 시간이 있습니다. 유효 시간이 지나면 인증번호가 만료되며, 새로운 인증번호를 요청해야 합니다.
- 인증 토큰 발급: 인증번호가 정상 확인되면 인증 토큰이 발급됩니다. 이 토큰은 로그인 또는 회원 가입에 사용되며, 별도의 유효 시간이 있습니다.
- 신규/기존 사용자 분기: 인증 토큰으로 로그인을 시도할 때, 해당 전화번호로 가입된 계정이 있으면 홈 화면으로, 없으면 온보딩 화면으로 이동합니다.
- 자동 로그인: 한 번 로그인하면 일정 기간 동안 자동으로 로그인 상태가 유지됩니다. 앱을 다시 열어도 재인증 없이 바로 사용할 수 있습니다.
- 탈퇴 계정 로그인 불가: 탈퇴한 계정의 전화번호로 로그인을 시도하면 로그인이 거부됩니다.
- 인증번호 재발송: 인증번호를 수신하지 못한 경우 재발송을 요청할 수 있습니다. 재발송 시 새로운 인증번호가 생성됩니다.
- 요청 횟수 제한: 동일 전화번호에 대한 인증번호 요청 횟수가 일정 시간 내에 제한됩니다. 제한을 초과하면 일정 시간이 지난 뒤 다시 시도해야 합니다.
- 잘못된 인증번호 입력: 인증번호를 잘못 입력하면 오류 안내가 표시됩니다. 올바른 인증번호를 다시 입력하거나 새로 요청할 수 있습니다.
사용자 흐름
기존 사용자 로그인
전화번호 입력 — 기존 사용자
사용자가 가입된 전화번호를 입력합니다.
인증번호 수신
입력한 전화번호로 SMS 인증번호가 발송됩니다.
인증번호 입력
수신한 인증번호를 유효 시간 내에 입력합니다. 정상 확인되면 인증 토큰이 발급됩니다.
로그인 및 홈 화면 이동
인증 토큰으로 로그인이 완료되고 홈 화면으로 이동합니다. 이후 자동 로그인이 유지됩니다.
신규 사용자 인증
전화번호 입력 — 신규 사용자
사용자가 전화번호를 입력합니다.
인증번호 수신 및 입력
SMS로 발송된 인증번호를 유효 시간 내에 입력합니다. 정상 확인되면 인증 토큰이 발급됩니다.
로그인 시도 후 온보딩 진입
인증 토큰으로 로그인을 시도합니다. 해당 전화번호로 가입된 계정이 없으므로 온보딩 화면으로 이동합니다.
인증번호 만료/오류
인증번호 입력 실패
유효 시간이 지났거나 잘못된 인증번호를 입력합니다.
오류 안내
인증번호가 만료되었거나 일치하지 않는다는 안내 메시지가 표시됩니다.
재발송 요청
인증번호 재발송을 요청하여 새로운 인증번호를 수신합니다.
관련 문서
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-03-09 | 최초 작성 |
| 2026-03-10 | 코드 기반 검증: 인증 토큰 2단계 흐름 반영 (인증번호 확인 → 토큰 발급 → 로그인), 지원 국가 제한·요청 횟수 제한 규칙 추가, 나이 제한 관련 문서 링크 제거 |