SMS OTP 양식 권장사항

SMS OTP 양식을 최적화하고 사용자 환경을 개선하는 방법을 알아보세요.

Eiji Kitamura

사용자에게 SMS를 통해 전송된 일회용 비밀번호 (OTP)를 제공하도록 요청하는 것은 사용자의 전화번호를 확인하는 일반적인 방법입니다. SMS OTP의 사용 사례는 다음과 같습니다.

  • 2단계 인증. 사용자 이름과 비밀번호 외에도 SMS OTP는 SMS OTP를 받은 사람이 계정을 소유하고 있다는 강력한 신호로 사용할 수 있습니다.
  • 전화번호 인증. 일부 서비스에서는 전화번호를 사용자의 기본 식별자로 사용합니다. 이러한 서비스에서 사용자는 전화번호와 SMS를 통해 수신된 OTP를 입력하여 신원을 증명할 수 있습니다. 때때로 PIN과 결합하여 2단계 인증을 구성합니다.
  • 계정 복구. 사용자가 계정에 액세스할 수 없게 되면 복구할 방법이 있어야 합니다. 등록된 이메일 주소로 이메일을 보내거나 전화번호로 SMS OTP를 전송하는 것은 일반적인 계정 복구 방법입니다.
  • 결제 확인 결제 시스템에서 일부 은행 또는 신용카드 발급기관은 보안상의 이유로 결제자에게 추가 인증을 요청합니다. SMS OTP는 이러한 용도로 흔히 사용됩니다.

이 게시물에서는 위의 사용 사례에 맞게 SMS OTP 양식을 빌드하는 권장사항을 설명합니다.

체크리스트

SMS OTP로 최상의 사용자 환경을 제공하려면 다음 단계를 따르세요.

  • <input> 요소는 다음과 함께 사용합니다.
    • type="text"
    • inputmode="numeric"
    • autocomplete="one-time-code"
  • @BOUND_DOMAIN #OTP_CODE을 OTP SMS 메시지의 마지막 줄로 사용합니다.
  • WebOTP API를 사용합니다.

<input> 요소 사용

<input> 요소가 있는 양식을 사용하는 것이 모든 브라우저에서 작동하므로 따라야 하는 가장 중요한 권장사항입니다. 이 게시물의 다른 추천이 일부 브라우저에서 작동하지 않더라도 사용자는 여전히 수동으로 OTP를 입력하고 제출할 수 있습니다.

<form action="/verify-otp" method="POST">
  <input type="text"
         inputmode="numeric"
         autocomplete="one-time-code"
         pattern="\d{6}"
         required>
</form>

다음은 입력란이 브라우저 기능을 최대한 활용하도록 하기 위한 몇 가지 아이디어입니다.

type="text"

OTP는 일반적으로 5~6자리 숫자이므로 입력란에 type="number"를 사용하면 모바일 키보드가 숫자만으로 변경되기 때문에 직관적으로 보일 수 있습니다. 브라우저에서는 입력란이 여러 숫자의 시퀀스가 아닌 셀 수 있는 숫자로 예상되어 예기치 않은 동작이 발생할 수 있으므로 이 방법은 권장되지 않습니다. type="number"를 사용하면 입력란 옆에 위쪽 및 아래쪽 버튼이 표시됩니다. 이러한 버튼을 누르면 숫자가 증가하거나 감소하며 앞의 0이 삭제될 수 있습니다.

대신 type="text"를 사용하세요. 이렇게 해도 모바일 키보드가 숫자로만 전환되는 것은 아니지만 inputmode="numeric" 사용에 관한 다음 도움말에서 이 작업을 실행하므로 괜찮습니다.

inputmode="numeric"

inputmode="numeric"를 사용하여 모바일 키보드를 숫자만으로 변경합니다.

일부 웹사이트에서는 OTP 입력란에 type="tel"를 사용합니다. 포커스가 있을 때 모바일 키보드를 숫자 (* 및 # 포함)로만 전환하기 때문입니다. 이 해킹 방법은 과거에 inputmode="numeric"가 널리 지원되지 않을 때 사용되었습니다. Firefox에서 inputmode="numeric"를 지원하기 시작했으므로 의미상으로 잘못된 type="tel" 핵을 사용할 필요가 없습니다.

autocomplete="one-time-code"

autocomplete 속성을 통해 개발자는 자동 완성 지원을 제공하기 위해 브라우저가 보유해야 하는 권한을 지정하고, 필드에 예상되는 정보 유형을 브라우저에 알립니다.

autocomplete="one-time-code"를 사용하면 양식이 열려 있는 동안 사용자가 SMS 메시지를 받을 때마다 운영체제가 SMS의 OTP를 휴리스틱 방식으로 파싱하고 키보드는 사용자에게 입력할 OTP를 제안합니다. iOS, iPadOS, macOS의 Safari 12 이상에서만 작동하지만, 이러한 플랫폼에서 SMS OTP 환경을 쉽게 개선할 수 있으므로 이 기능을 사용하는 것이 좋습니다.

`자동 완성="one-time-code"` 가 실행 중입니다.

autocomplete="one-time-code"는 사용자 환경을 개선하지만 SMS 메시지가 출처 바인딩 메시지 형식을 준수하는지 확인하여 할 수 있는 다른 작업이 있습니다.

SMS 텍스트 서식 지정

SMS를 통해 전송되는 출처 바운드 일회성 코드 사양에 맞춰 OTP를 입력하는 사용자 환경을 개선합니다.

형식 규칙은 간단합니다. 수신자 도메인 앞에 @를, OTP를 #로 설정하여 SMS 메시지를 완료합니다.

예를 들면 다음과 같습니다.

Your OTP is 123456

@web-otp.glitch.me #123456

OTP 메시지에 표준 형식을 사용하면 메시지에서 코드를 더 쉽고 안정적으로 추출할 수 있습니다. OTP 코드를 웹사이트와 연결하면 사용자를 속여 악성 사이트에 코드를 제공하기가 더 어려워집니다.

이 형식을 사용하면 다음과 같은 몇 가지 이점이 있습니다.

  • OTP가 도메인에 결합됩니다. 사용자가 SMS 메시지에 지정된 도메인이 아닌 다른 도메인에 있는 경우 OTP 추천이 표시되지 않습니다. 이렇게 하면 피싱 공격과 잠재적인 계정 도용의 위험이 줄어듭니다.
  • 이제 브라우저는 신비롭고 불안정한 휴리스틱에 의존하지 않고 안정적으로 OTP를 추출할 수 있습니다.

웹사이트에서 autocomplete="one-time-code"를 사용하는 경우 iOS 14 이상이 설치된 Safari에서는 위의 규칙에 따라 OTP를 추천합니다.

이 SMS 메시지 형식은 Safari 이외의 브라우저에도 유용합니다. Android의 Chrome, Opera, Vivaldi도 WebOTP API를 사용하여 출처 바운드 일회성 코드 규칙을 지원하지만 autocomplete="one-time-code"를 통해서는 지원하지 않습니다.

WebOTP API 사용

WebOTP API는 SMS 메시지로 수신된 OTP에 대한 액세스를 제공합니다. transport에 sms가 포함된 otp 유형 (OTPCredential)으로 navigator.credentials.get()를 호출하면 웹사이트에서 출처 바인딩 일회성 코드를 준수하는 SMS가 전송되고 사용자에게 액세스 권한을 부여할 때까지 기다립니다. OTP가 자바스크립트로 전달되면 웹사이트에서 이를 양식으로 사용하거나 서버에 직접 POST할 수 있습니다.

navigator.credentials.get({
  otp: {transport:['sms']}
})
.then(otp => input.value = otp.code);
WebOTP API의 작동 방식

WebOTP API로 웹에서 전화번호 확인에서 WebOTP API를 사용하는 방법을 자세히 알아보거나 다음 스니펫을 복사하여 붙여넣으세요. <form> 요소에 action 및 method 속성이 올바르게 설정되어 있는지 확인하세요.

// Feature detection
if ('OTPCredential' in window) {
  window.addEventListener('DOMContentLoaded', e => {
    const input = document.querySelector('input[autocomplete="one-time-code"]');
    if (!input) return;
    // Cancel the WebOTP API if the form is submitted manually.
    const ac = new AbortController();
    const form = input.closest('form');
    if (form) {
      form.addEventListener('submit', e => {
        // Cancel the WebOTP API.
        ac.abort();
      });
    }
    // Invoke the WebOTP API
    navigator.credentials.get({
      otp: { transport:['sms'] },
      signal: ac.signal
    }).then(otp => {
      input.value = otp.code;
      // Automatically submit the form when an OTP is obtained.
      if (form) form.submit();
    }).catch(err => {
      console.log(err);
    });
  });
}

사진: 제이슨 룽, Unsplash