사이드 프로젝트에 SMS 인증을 붙이려다 좌절한 적 있으신가요?

토이 프로젝트나 스타트업 MVP를 개발하면서 유저 본인인증을 위해 SMS API를 찾아본 경험이 있으실 겁니다. 하지만 국내 대형 API 서비스들을 이용하려면 사업자등록증, 통신서비스 이용증명원 등 복잡한 서류 제출이 필수입니다. 게다가 발신번호 사전등록까지 거쳐야 하죠.

"나는 그저 사이드 프로젝트에 인증번호 기능 하나 붙이고 싶을 뿐인데..."

이런 분들을 위해, 오늘은 서류 제출 없이 단 5분 만에 Nuxt 3 Nitro 서버 라우트에서 SMS 인증을 구현하는 방법을 소개합니다.

---

Nuxt 3 Nitro와 EasyAuth로 SMS 인증 구현하기

Nuxt 3는 내장 서버 엔진인 Nitro를 통해 API 라우트를 매우 쉽게 구축할 수 있습니다. 여기에 서류 없이 즉시 사용할 수 있는 EasyAuth(이지어스) API를 결합하면 프론트엔드와 백엔드를 오가는 완벽한 인증 로직을 순식간에 완성할 수 있습니다.

1. 환경 변수 설정

먼저 프로젝트 최상단의 .env 파일에 EasyAuth API 키를 추가합니다.

EASYAUTH_API_KEY=your_api_key_here

nuxt.config.ts 파일에서 런타임 환경변수를 설정해줍니다.

export default defineNuxtConfig({
  runtimeConfig: {
    easyAuthApiKey: process.env.EASYAUTH_API_KEY
  }
})

2. 인증번호 발송 API (/api/send)

Nuxt의 server/api 디렉토리에 서버 라우트를 생성합니다. server/api/auth/send.post.ts 파일을 만들고 아래 코드를 작성합니다.

export default defineEventHandler(async (event) => {
  const body = await readBody(event);
  const config = useRuntimeConfig();

  if (!body.phoneNumber) {
    throw createError({ statusCode: 400, statusMessage: '전화번호가 필요합니다.' });
  }

  try {
    const response = await $fetch('https://api.easyauth.kr/send', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${config.easyAuthApiKey}`,
        'Content-Type': 'application/json'
      },
      body: { to: body.phoneNumber }
    });

    return { success: true, message: '인증번호가 발송되었습니다.' };
  } catch (error) {
    throw createError({ statusCode: 500, statusMessage: '발송에 실패했습니다.' });
  }
});

3. 인증번호 검증 API (/api/verify)

이제 사용자가 입력한 코드를 검증하는 엔드포인트를 만듭니다. server/api/auth/verify.post.ts 파일을 생성합니다.

export default defineEventHandler(async (event) => {
  const body = await readBody(event);
  const config = useRuntimeConfig();

  if (!body.phoneNumber || !body.code) {
    throw createError({ statusCode: 400, statusMessage: '전화번호와 인증번호를 모두 입력해주세요.' });
  }

  try {
    const response = await $fetch('https://api.easyauth.kr/verify', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${config.easyAuthApiKey}`,
        'Content-Type': 'application/json'
      },
      body: { 
        to: body.phoneNumber,
        code: body.code
      }
    });

    return { success: true, message: '인증이 완료되었습니다.' };
  } catch (error) {
    throw createError({ statusCode: 400, statusMessage: '유효하지 않은 인증번호입니다.' });
  }
});

---

실무 적용 팁 (Best Practices)

1. Rate Limiting (요청 제한): 악의적인 사용자가 무단으로 문자를 대량 발송하는 것을 막기 위해 IP 기반 Rate Limit을 설정하는 것을 권장합니다. Nuxt 환경에서는 nuxt-security 모듈을 활용할 수 있습니다.
2. 국제 번호 처리: 글로벌 서비스라면 +82와 같은 국가 코드를 프론트엔드에서 파싱해 넘겨주는 것이 좋습니다.

---

결론: 복잡한 서류 없이 바로 시작하세요

개발자가 MVP나 토이 프로젝트를 만들 때 가장 중요한 것은 속도입니다. 복잡한 가입 절차와 서류 심사로 시간을 낭비하지 마세요.

초간단 SMS 인증 API **[EasyAuth(이지어스)]**를 사용하면 다음과 같은 혜택을 누릴 수 있습니다:

• 서류 100% 면제: 사업자등록증, 이용증명원 필요 없음
• 자동 발신번호: 번호 사전등록 없이 바로 발송
• 초저가 혜택: 기존(30~50원) 대비 절반 수준인 건당 15~25원
• 무료 체험 제공: 가입 즉시 10건 무료 발송 테스트 가능

단 2개의 엔드포인트(send, verify)로 가장 빠르게 SMS 인증을 구축해보세요!