簡訊動態密碼表單最佳做法

常見的做法是傳送簡訊,要求使用者提供動態密碼 (OTP) 來確認身分。簡訊動態密碼的用途包括:

  • 雙重驗證:除了使用者名稱和密碼外,簡訊動態密碼也可做為強烈信號,證明帳戶擁有者就是收到簡訊動態密碼的人。
  • 電話號碼驗證。部分服務會使用電話號碼做為使用者的主要 ID。使用者可以在這類服務中輸入電話號碼和透過簡訊收到的一次性密碼,藉此證明身分。有時會與 PIN 碼結合,構成雙重驗證。
  • 帳戶救援。當使用者無法存取帳戶時,需要有方法可以復原帳戶。常見的帳戶救援方法包括傳送電子郵件至註冊的電子郵件地址,或傳送簡訊動態密碼至電話號碼。
  • 付款確認:在付款系統中,部分銀行或信用卡發卡機構會基於安全考量,要求付款人進行額外驗證。簡訊動態密碼通常用於這個目的。

請繼續閱讀,瞭解如何根據這些用途,建構簡訊動態密碼表單的最佳做法。

檢查清單

如要透過簡訊動態密碼提供最佳使用者體驗,請按照下列步驟操作:

  • 搭配使用 <input> 元素和:
    • type="text"
    • inputmode="numeric"
    • autocomplete="one-time-code"
  • 在動態密碼簡訊的最後一行使用 @BOUND_DOMAIN #OTP_CODE。
  • 使用 WebOTP API。

使用 <input> 元素

使用含有 <input> 元素的表單是最重要的最佳做法,因為這種表單適用於所有瀏覽器。即使本文的其他建議在某些瀏覽器中無法運作,使用者仍可手動輸入並提交動態密碼。

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

以下提供幾項建議,確保輸入欄位能充分發揮瀏覽器功能。

type="text"

由於動態密碼通常是五或六位數,因此在輸入欄位中使用 type="number" 似乎很直覺,因為這會將行動鍵盤變更為僅限數字。我們不建議這麼做,因為瀏覽器預期輸入欄位是可計數的數字,而不是多個數字的序列,這可能會導致非預期的行為。使用 type="number" 會在輸入欄位旁顯示向上和向下按鈕;按下這些按鈕會增加或減少數字,並可能移除前置零。

請改用 type="text"。這不會將行動鍵盤變成僅限數字,但這沒關係,因為下一個使用 inputmode="numeric" 的提示會執行該工作。

inputmode="numeric"

使用 inputmode="numeric" 將行動鍵盤變更為僅限數字。

部分網站會使用 type="tel" 做為動態密碼輸入欄位,因為在聚焦時,這也會將行動鍵盤切換為僅限數字 (包括 * 和 #)。過去 inputmode="numeric" 尚未廣泛支援時,曾使用過這種破解方式。由於 Firefox 已開始支援 inputmode="numeric",因此不需要使用語意不正確的 type="tel" 駭客。

autocomplete="one-time-code"

autocomplete 屬性可讓開發人員指定瀏覽器提供自動完成協助的權限,並告知瀏覽器欄位中預期的資訊類型。

有了 autocomplete="one-time-code",只要使用者在表單開啟時收到簡訊,作業系統就會以經驗法則剖析簡訊中的動態密碼,鍵盤也會建議使用者輸入動態密碼。這項功能僅適用於 iOS、iPadOS 和 macOS 上的 Safari 12 以上版本,但我們強烈建議您使用,因為這是在這些平台上改善簡訊 OTP 體驗的更佳方式。

autocomplete="one-time-code" 實際應用。

autocomplete="one-time-code" 可改善使用者體驗,但您還可以確保簡訊符合來源繫結訊息格式,進一步提升體驗。

選用屬性

選用屬性包括:

  • pattern 指定輸入的一次性密碼必須符合的格式。請使用規則運算式指定比對模式。例如,\d{6} 會將動態密碼限制為六位數字串。如要進一步瞭解 pattern,請參閱「使用 JavaScript 進行更複雜的即時驗證」。
  • required 表示使用者必須填寫該欄位。

如需更多建議,請參閱登入表單最佳做法。

設定簡訊文字格式

請遵循透過簡訊傳送來源繫結動態密碼規格,改善輸入動態密碼的使用者體驗。

格式規則的核心如下:簡訊結尾應為接收者網域 (前面加上 @),以及動態密碼 (前面加上 #)。

例如:

Your OTP is 123456

@web-otp.example.com #123456

OTP 訊息採用標準格式,因此更容易擷取,也更可靠。 將動態密碼與網站建立關聯,可降低使用者受騙而將密碼提供給惡意網站的機率。

精確的格式規則

精確規則如下:

  • 訊息開頭為人類可讀文字 (選用),其中包含四到十個英數字元的字串,且至少有一個數字,最後一行則為網址和動態密碼。
  • 叫用 API 的網站網址,其網域部分前面必須加上 @。
  • 網址必須包含 #,後面接著動態密碼。字元數不得超過 140 個。

使用這種格式有幾個好處:

  • 動態密碼會繫結至網域。如果使用者位於簡訊指定網域以外的網域,系統就不會顯示動態密碼建議。這也能降低網路釣魚攻擊和帳戶被人盜用的風險。
  • 瀏覽器現在可以可靠地擷取動態密碼,而不必依賴神秘且不穩定的經驗法則。

如果網站使用 autocomplete="one-time-code",搭載 iOS 14 以上版本的 Safari 會根據這些規則建議動態密碼。

這種簡訊格式也適用於 Safari 以外的瀏覽器。Android 上的 Chrome、Opera 和 Vivaldi 也支援 WebOTP API 的來源繫結一次性代碼規則,但不是透過 autocomplete="one-time-code"。

使用 WebOTP API

WebOTP API 可讓您存取簡訊中收到的動態密碼。透過呼叫 navigator.credentials.get(),並使用 otp 類型 (OTPCredential),其中 transport 包含 sms,網站會等待符合來源繫結一次性代碼的簡訊傳送,並由使用者授予存取權。動態密碼傳遞至 JavaScript 後,網站就能在表單中使用,或直接 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);
    });
  });
}