Wypełnianie formularzy haseł jednorazowych w elementach iframe z innych domen za pomocą interfejsu WebOTP API

Interfejs WebOTP API może teraz odbierać hasła jednorazowe z elementów iframe.

Hasła jednorazowe wysyłane SMS-em są powszechnie używane do weryfikacji numerów telefonów, na przykład jako drugi etap uwierzytelniania lub do weryfikacji płatności w internecie. Jednak przełączanie się między przeglądarką a aplikacją do SMS-ów w celu skopiowania i wklejenia lub ręcznego wpisania hasła jednorazowego może prowadzić do błędów i utrudniać korzystanie z aplikacji.

Interfejs WebOTP API umożliwia witrynom automatyczne pobieranie hasła jednorazowego z SMS-a i wpisywanie go w formularzu za pomocą jednego kliknięcia, bez konieczności przełączania aplikacji. SMS jest specjalnie sformatowany i powiązany ze źródłem, co zmniejsza ryzyko kradzieży hasła jednorazowego przez witryny phishingowe.

Jednym z przypadków użycia, który nie jest jeszcze obsługiwany w WebOTP, było kierowanie na źródło w elemencie iframe. Zazwyczaj służy do potwierdzania płatności, zwłaszcza w przypadku 3D Secure. Dzięki wspólnemu formatowi obsługującemu elementy iframe z różnych domen interfejs WebOTP API od wersji Chrome 91 dostarcza hasła jednorazowe powiązane z zagnieżdżonymi domenami.

Jak działa interfejs WebOTP API

Sam interfejs WebOTP API jest dość prosty:

…
  const otp = await navigator.credentials.get({
    otp: { transport:['sms'] }
  });
…

SMS musi być sformatowany za pomocą kodów jednorazowych powiązanych z miejscem pochodzenia.

Your OTP is: 123456.

@web-otp.example.com #12345

Zwróć uwagę, że w ostatnim wierszu znajduje się źródło, które ma zostać powiązane, poprzedzone znakiem @, a po nim hasło jednorazowe poprzedzone znakiem #.

Gdy SMS dotrze, pojawi się pasek informacyjny z prośbą o zweryfikowanie numeru telefonu. Gdy użytkownik kliknie przycisk Verify, przeglądarka automatycznie przekaże hasło jednorazowe do witryny i rozwiąże navigator.credentials.get(). Witryna może wtedy wyodrębnić hasło jednorazowe i zakończyć proces weryfikacji.

Podstawowe informacje o korzystaniu z WebOTP znajdziesz w artykule Weryfikowanie numerów telefonów w internecie za pomocą interfejsu WebOTP API.

Przypadki użycia elementów iframe współdzielenia

Wpisywanie hasła jednorazowego w formularzu w elemencie iframe z innej domeny jest powszechne w scenariuszach płatności. Niektórzy wydawcy kart kredytowych wymagają dodatkowego kroku weryfikacji, aby sprawdzić autentyczność płatnika. Nazywa się to 3D Secure, a formularz jest zwykle wyświetlany w elemencie iframe na tej samej stronie, tak jakby był częścią procesu płatności.

Na przykład:

  • Użytkownik odwiedza stronę shop.example, aby kupić buty za pomocą karty kredytowej.
  • Po wpisaniu numeru karty kredytowej zintegrowany dostawca usług płatniczych wyświetla w elemencie iframe formularz z witryny bank.example, w którym użytkownik jest proszony o potwierdzenie numeru telefonu w celu szybkiej płatności.
  • bank.example wysyła do użytkownika SMS-a z hasłem jednorazowym, które użytkownik może wpisać, aby potwierdzić swoją tożsamość.

Jak używać interfejsu WebOTP API z międzyźródłowego elementu iframe

Aby używać interfejsu WebOTP API w elemencie iframe z różnych domen, musisz wykonać 2 czynności:

  • W wiadomości SMS dodaj adnotacje dotyczące zarówno źródła ramki nadrzędnej, jak i źródła elementu iframe.
  • Skonfiguruj zasady dotyczące uprawnień, aby umożliwić elementowi iframe ze współdzieleniem otrzymywanie haseł jednorazowych bezpośrednio od użytkownika.
Interfejs WebOTP API w elemencie iframe w akcji.

Możesz samodzielnie wypróbować wersję demonstracyjną na stronie https://web-otp-iframe-demo.stackblitz.io.

Dodawanie adnotacji o powiązanych źródłach do SMS-a

Gdy interfejs WebOTP API jest wywoływany z elementu iframe, SMS musi zawierać źródło ramki nadrzędnej poprzedzone znakiem @, po którym następuje hasło jednorazowe poprzedzone znakiem #, a następnie źródło elementu iframe poprzedzone znakiem @.

@shop.example #123456 @bank.exmple

Konfigurowanie zasad dotyczących uprawnień

Aby używać WebOTP w elemencie iframe współdzielenia, element osadzający musi przyznać dostęp do tego interfejsu API za pomocą zasad dotyczących uprawnień otp-credentials, aby uniknąć niezamierzonego działania. Ogólnie rzecz biorąc, możesz to zrobić na 2 sposoby:

  • za pomocą nagłówka HTTP:
Permissions-Policy: otp-credentials=(self "https://bank.example")
  • za pomocą atrybutu iframe allow:
<iframe src="https://bank.example/…" allow="otp-credentials"></iframe>

Zobacz więcej przykładów określania zasad dotyczących uprawnień.

Zastrzeżenia

Poziomy zagnieżdżenia

Obecnie Chrome obsługuje tylko wywołania interfejsu WebOTP API z elementów iframe z innych domen, które mają nie więcej niż 1 unikalne źródło w łańcuchu elementów nadrzędnych. W tych sytuacjach:

  • a.com -> b.com
  • > b.com -> b.com
  • a.com -> a.com -> b.com
  • <code>a.com</code> -> <code>b.com</code> -> <code>c.com</code>

używanie WebOTP w b.com jest obsługiwane, ale w c.com – nie.

Pamiętaj, że ten scenariusz również nie jest obsługiwany ze względu na brak popytu i złożoność UX.

  • a.com -> b.com -> a.com (wywołuje interfejs WebOTP API)

Interoperacyjność

Chociaż silniki przeglądarek inne niż Chromium nie implementują interfejsu WebOTP API, Safari udostępnia ten sam format SMS-ów z obsługą input[autocomplete="one-time-code"]. W Safari, gdy tylko nadejdzie SMS zawierający jednorazowy kod powiązany z pochodzeniem w odpowiednim formacie i z dopasowanym pochodzeniem, klawiatura sugeruje wpisanie hasła jednorazowego w polu do wprowadzania danych.

Od kwietnia 2021 r. Safari obsługuje elementy iframe z unikalnym formatem SMS-ów, który korzysta z %. Jednak w wyniku dyskusji nad specyfikacją zdecydowano się na @, więc mamy nadzieję, że implementacja obsługiwanego formatu SMS-ów będzie się zbiegać.

Prześlij opinię

Twoja opinia jest dla nas bardzo ważna, ponieważ pomaga nam ulepszać interfejs WebOTP API. Wypróbuj go i daj nam znać, co o nim myślisz.

Zasoby