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.examplewysył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.
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.