Skip to content

API uwierzytelniania dwuskładnikowego

Dodaj dodatkową warstwę bezpieczeństwa.

Drugi składnik chroniący konta

Chroń konta użytkowników, wymagając kodu weryfikacyjnego po uwierzytelnieniu hasłem.

Czym jest uwierzytelnianie dwuskładnikowe?

Uwierzytelnianie dwuskładnikowe wymaga drugiego, niezależnego dowodu obok hasła: czegoś, co się wie, plus czegoś, co się ma. Cały sens tkwi w niezależności. Wyciek bazy haseł jest wart znacznie mniej, gdy sam z siebie nie otwiera żadnego konta.

Drugi składnik pomaga tylko o tyle, o ile jest naprawdę odrębny. Kod wysłany e-mailem na adres chroniony tym samym hasłem nie jest drugim składnikiem, a dowód powiązany z fizycznym urządzeniem jest.

2FA przez SMS i jego ograniczenia

SMS to najpowszechniej stosowany drugi składnik i najsłabszy z tych, które wciąż są w częstym użyciu. Kody można przekierować przez SIM swap, wyłudzić na przekonującej stronie, która po prostu prosi o ich odczytanie, a także opóźnić lub zgubić w routingu operatora. Każda wysyłka kosztuje też pieniądze, co czyni ścieżkę logowania miejscem, w którym atakujący mogą wydawać budżet firmy.

Nic z tego nie czyni 2FA przez SMS bezwartościowym: jest nieporównanie lepsze niż brak drugiego składnika. Oznacza to jednak, że przy dzisiejszym wyborze niewiele przemawia za tym, by robić z niego rozwiązanie domyślne.

2FA przez WhatsApp

Wysyłanie wyzwania przez WhatsApp usuwa operatora ze ścieżki: dostarczanie odbywa się przez internet, wiadomość jest szyfrowana end-to-end i nie ma opłaty za każdy SMS. Trafia też do aplikacji, którą użytkownik na większości rynków ma już otwartą.

Samo to rozwiązuje jednak dostarczanie i koszt, a nie leżącą u podstaw słabość. Kod nadal jest kodem, a użytkownika, który potrafi go odczytać, można namówić do podania go atakującemu.

Reverse OTP jako drugi składnik

Reverse OTP zmienia to, czym jest drugi składnik. Zamiast wysyłać sekret na urządzenie i prosić użytkownika o jego przekazanie, prosi urządzenie o wysłanie wiadomości. Użytkownik dotyka linku i naciska wyślij, a serwer dopasowuje przychodzącą wiadomość do oczekującej sesji logowania.

Usuwa to podatny na phishing element w całości. Nie ma kodu na ekranie, który użytkownik mógłby odczytać na głos, nie ma niczego w tranzycie do przechwycenia i niczego, co SIM swap mógłby przekierować: dowód pochodzi z konta WhatsApp powiązanego z aparatem, a nie z numeru, który operator może przypisać komuś innemu.

Wdrożenie 2FA z użyciem API

Wywołania API to te same dwa, które służą przy rejestracji. Gdy logowanie wymaga drugiego składnika, należy otworzyć sesję przez POST /start-verification z identyfikatorem powiązanym z tą próbą logowania i przedstawić zwrócony deep link. Sesję należy utrzymywać po stronie serwera i dokończyć logowanie dopiero wtedy, gdy GET /check-verification-status zwróci verified.

Dwie zasady zapewniają poprawność. Sesję weryfikacyjną należy wiązać z próbą logowania, a nie z użytkownikiem, aby ukończona sesja nigdy nie mogła autoryzować innej. Oraz porównywać numer zwrócony przez API z numerem zapisanym na koncie: zweryfikowany numer, który nie jest numerem tego użytkownika, oznacza nieudany drugi składnik, a nie udany.

Rozwiązanie awaryjne i odzyskiwanie

Tam, gdzie WhatsApp jest niedostępny, warto zaoferować SMS jako rozwiązanie awaryjne w tej samej sesji, aby użytkownik z rynku o niskiej adopcji nie został zablokowany. Poza tym trzeba zaplanować sytuację, w której samego telefonu już nie ma: drugi składnik bez ścieżki odzyskiwania to awaria czekająca na swój moment, a użytkownicy, którzy tracą dostęp, zwykle tracą razem z nim konto.

Zwykłą odpowiedzią są kody odzyskiwania wydawane przy rejestracji składnika. Cokolwiek zostanie wybrane, trzeba to ustalić przed startem: odzyskiwanie projektowane w trakcie incydentu jest zawsze gorsze.

Kiedy 2FA oparte na telefonie jest właściwym wyborem

W produktach konsumenckich drugie składniki oparte na telefonie mają decydującą przewagę: użytkownicy już mają urządzenie i nie muszą niczego rejestrować. Dlatego ich adopcja jest znacznie wyższa niż w przypadku aplikacji uwierzytelniających czy kluczy sprzętowych.

W przypadku kont chroniących poważną wartość, czyli dostępu administracyjnego, kontroli nad finansami i infrastruktury, silniejszym wyborem pozostaje sprzętowy klucz bezpieczeństwa, a oba rozwiązania dobrze się łączą. Weryfikację telefonu warto stosować tam, gdzie liczy się szerokość zasięgu, a klucze tam, gdzie liczy się głębia zabezpieczeń.

Najczęstsze pytania

Czym jest API 2FA?
API 2FA to interfejs służący do dodania drugiego składnika uwierzytelniania do przepływu logowania. Wywołuje się je, gdy logowanie wymaga weryfikacji, pokazuje użytkownikowi to, co zwraca, i wpuszcza go dopiero wtedy, gdy zgłosi spełnienie składnika.
Czy 2FA przez WhatsApp jest bezpieczniejsze niż 2FA przez SMS?
Usuwa operatora ze ścieżki dostarczania, więc nie jest narażone na SIM swap ani przechwycenie przez SS7 i jest szyfrowane end-to-end. Przepływ Reverse OTP idzie dalej, bo w ogóle nie wysyła kodu, co usuwa także ryzyko phishingu.
Czy Reverse OTP można wyłudzić phishingiem?
Nie ma kodu, który użytkownik mógłby ujawnić, co eliminuje typowy atak polegający na namówieniu kogoś do odczytania hasła jednorazowego. Żaden drugi składnik nie jest całkowicie odporny na phishing, ale zwykły skrypt socjotechniczny nie ma tu o co prosić.
Co się stanie, jeśli użytkownik zgubi telefon?
Straci dostęp do tego składnika, dokładnie jak w przypadku SMS-a lub aplikacji uwierzytelniającej. Należy wydawać kody odzyskiwania przy rejestracji składnika albo utrzymywać drugi zweryfikowany składnik i zaprojektować tę ścieżkę przed startem, a nie w trakcie incydentu.
Czy potrzebna jest osobna integracja dla 2FA i weryfikacji przy rejestracji?
Nie. Oba przypadki używają tych samych dwóch endpointów. Różni się moment ich wywołania i sposób wykorzystania wyniku: przy rejestracji zapisuje się zweryfikowany numer, a przy logowaniu porównuje go z numerem już zapisanym na koncie.

Related

Idealne dla

Bankowości

Zabezpiecz wrażliwe transakcje finansowe i dostęp do konta.

Platform SaaS

Chroń konta klientów i dane biznesowe.

Paneli administracyjnych

Dodaj drugi składnik dla użytkowników z uprawnieniami.

Aplikacji korporacyjnych

Spełnij polityki bezpieczeństwa bez złożonych tokenów sprzętowych.

Build your uwierzytelnianie dwuskładnikowe (2fa) flow today

Start integrating in minutes with clear documentation, SDKs, and global message delivery.