Ten dokument opisuje, jak za pomocą Credential Manager uzyskać z urządzenia użytkownika adres e-mail zweryfikowany kryptograficznie. Dzięki temu użytkownicy aplikacji nie muszą weryfikować swojego adresu e-mail za pomocą haseł jednorazowych ani magicznych linków.
W tym dokumencie znajdziesz informacje na te tematy:
- Zgodność z Androidem
- Interfejs użytkownika
- Obsługiwane konta
- Wpływ na dostarczanie e-maili
- Porównanie z funkcją Zaloguj się przez Google
W tym przewodniku zakładamy, że znasz te pojęcia:
Umiejętności związane z Androidem
Wyświetl na GitHubiePobieranie zweryfikowanego adresu e-mail
android skills add verified-emailZgodność z Androidem
Ta funkcja jest obsługiwana na telefonach, tabletach i urządzeniach składanych z Androidem 9 (poziom interfejsu API 28) lub nowszym. Minimalna wymagana wersja Usług Google Play (GMS) to 25.49.x.
Interfejs użytkownika
W poniższych sekcjach opisujemy wrażenia użytkownika podczas procesu weryfikacji, potrzebę uwzględnienia zastępczych metod weryfikacji oraz zalecane wrażenia użytkownika w różnych przypadkach użycia.
Proces weryfikacji
Udostępnianie zweryfikowanego adresu e-mail wygląda tak:
- Użytkownik skupia się na polu do wprowadzania danych lub klika przycisk, który wywołuje interfejs Credential Manager API. W zależności od projektu ekranu możesz też wywołać interfejs API podczas wczytywania ekranu aplikacji.
- Pojawi się plansza dolna z informacjami, które zostaną udostępnione aplikacji. Jeśli na urządzeniu nie ma żadnych informacji, użytkownik zobaczy ogólny komunikat o błędzie.
- Gdy użytkownik kliknie Zgadzam się i kontynuuję, wyświetl komunikat o powodzeniu lub niepowodzeniu.
- Uwaga: jeśli otrzymany e-mail weryfikacyjny nie jest zgodny z oczekiwanym, poinformuj użytkownika o niezgodności i poproś go o ponowną próbę z innymi danymi logowania lub podaj alternatywną metodę weryfikacji, np. za pomocą haseł jednorazowych.
- (Opcjonalnie, zalecane) Jeśli użytkownik rejestruje się w Twojej usłudze, poproś go o utworzenie klucza dostępu, aby ułatwić mu późniejsze logowanie.
- Uwaga: proces potwierdzania adresu e-mail nie powoduje automatycznego utworzenia klucza dostępu. Zdecydowanie zalecamy jednak uwzględnienie kroków tworzenia klucza dostępu. Klucze dostępu ułatwiają użytkownikom logowanie się i zwiększają jego bezpieczeństwo, eliminując konieczność podawania nazwy użytkownika i hasła.
Uwzględnij przepływy podstawowe i zastępcze
Aby zapewnić użytkownikom wygodę, na ekranach wymagających potwierdzenia adresu e-mail umieść te opcje:
- Podstawowa opcja weryfikacji: pole adresu e-mail lub przycisk do uruchamiania procesu interfejsu Credential Manager API w celu szybkiej weryfikacji.
- Alternatywne opcje weryfikacji: link lub przycisk „Zweryfikuj w inny sposób” albo „Inne opcje” umożliwiający ręczne wpisanie adresu e-mail w przypadku niepowodzenia, np. gdy na urządzeniu nie ma informacji lub gdy pobrany adres e-mail nie jest zgodny z oczekiwanym. Użytkownicy powinni mieć możliwość spróbowania weryfikacji za pomocą innych danych logowania lub przez ręczne podanie hasła jednorazowego.
Przypadki użycia
W sekcjach poniżej opisujemy zalecane przypadki użycia oraz sugerowane sposoby potwierdzania adresu e-mail.
Zarejestruj się
Użytkownicy mogą od razu utworzyć konto ze zweryfikowanym adresem e-mail bez osobnego kroku weryfikacji. Opcjonalnie możesz poprosić użytkownika o dodanie klucza dostępu. Jeśli zdecydują się dodać klucz dostępu, uruchom proces tworzenia klucza dostępu.
Odzyskiwanie konta
Aby użytkownicy nie musieli szukać kodów odzyskiwania w folderach ze spamem, pozwól im odzyskiwać konto za pomocą zweryfikowanego adresu e-mail bezpiecznie przechowywanego na urządzeniu. Zaproponuj też, aby utworzyli klucz dostępu do wykorzystania w przyszłości.
Ponowne uwierzytelnianie w przypadku działań związanych z poufnymi danymi
Chroń działania użytkowników związane z poufnymi danymi, takie jak zmiana ustawień czy aktualizacja danych profilu, wymagając szybkiego ponownego uwierzytelnienia.
Obsługiwane konta
Potwierdzanie adresu e-mail za pomocą Credential Manager obsługuje tylko potwierdzanie kont Google dla użytkowników indywidualnych. Konta Workspace i konta nadzorowane nie są obsługiwane.
Konto Google dla użytkowników indywidualnych można utworzyć za pomocą adresu e-mail od dowolnego dostawcy, niekoniecznie @gmail.com. Google weryfikuje jednak te konta w inny sposób:
- W przypadku kont @gmail.com: Google jest wiarygodnym źródłem, a adres e-mail jest zweryfikowany.
- W przypadku kont innych niż @gmail.com: Google nie jest długoterminowym autorytatywnym źródłem tych adresów e-mail. Google weryfikuje adres e-mail podczas tworzenia konta, ale z czasem właściciel tego adresu może się zmienić. Dlatego w przypadku adresów innych niż @gmail.com warto rozważyć dodatkowy krok weryfikacji, np. wysłanie hasła jednorazowego, aby upewnić się, że użytkownik nadal ma dostęp do konta e-mail.
Więcej informacji o tym, co oznacza weryfikacja, znajdziesz w artykule Cyfrowe dokumenty tożsamości.
Uwaga: oprócz informacji o adresie e-mail użytkownika możesz poprosić o inne niezweryfikowane pola, takie jak imię, nazwisko, imię i nazwisko oraz zdjęcie profilowe na koncie Google. Google weryfikuje jednak tylko adres e-mail.
Informacje o weryfikacji numeru telefonu znajdziesz w artykule Weryfikowanie numerów telefonów za pomocą cyfrowych dokumentów tożsamości. Informacje o rozwiązaniu Firebase znajdziesz w artykule Weryfikacja numeru telefonu w Firebase.
Aktualność i ważność
System wydaje możliwe do zweryfikowania dane uwierzytelniające na podstawie bieżącego adresu e-mail użytkownika z aktywnych kont Google na urządzeniu. Te dane logowania są wydawane urządzeniu z wyprzedzeniem, zwykle gdy urządzenie jest bezczynne. Chociaż te dane logowania mogą pozostać ważne przez kilka dni, system przeprowadza kontrolę w momencie udostępniania danych logowania, aby upewnić się, że konto nadal istnieje, jest na urządzeniu, a adres e-mail jest prawidłowy. W ten sposób priorytetowo traktuje natychmiastowy stan konta, a nie okno ważności danych logowania.
Aby zapewnić autentyczność, w momencie udostępniania generowany jest podpis powiązania klucza (kb), który zawiera liczbę jednorazową.
Jeśli urządzenie jest offline lub konto zostało usunięte, proces się nie powiedzie, zamiast dostarczyć wygasły certyfikat VC lub certyfikat VC dla nieaktywnego konta Google.
Dostarczanie e-maili
Chociaż proces ten potwierdza autentyczność konta, nie gwarantuje, że e-mail trafi do skrzynki odbiorczej (może na przykład zostać przekierowany do spamu). Hasło jednorazowe pozostaje ostateczną metodą potwierdzania dostarczalności e-maili.
Porównanie z funkcją Zaloguj się przez Google
Chociaż zarówno cyfrowe dane uwierzytelniające, jak i rozwiązania Zaloguj się przez Google zapewniają zweryfikowany adres e-mail, wzorce przeglądania i przypadki użycia są różne:
- Przypadki użycia: proces weryfikacji adresu e-mail za pomocą Menedżera danych logowania nie jest używany wyłącznie w przypadku rejestracji lub logowania, ale może być używany w każdym przypadku, gdy wymagane jest pobranie zweryfikowanego adresu e-mail. Może to obejmować również odzyskiwanie konta.
- Rejestracja: w przeciwieństwie do funkcji Zaloguj się przez Google proces Credential Managera nie wymaga rejestracji w Google.
Obsługa platform: proces Credential Managera to rozwiązanie przeznaczone tylko na Androida.
Zakresy: w przeciwieństwie do funkcji Zaloguj się przez Google, która może używać protokołu OAuth 2.0 do żądania dostępu do danych użytkownika (np. Kalendarza lub Dysku za pomocą zakresów), interfejs Digital Credentials API służy wyłącznie do pobierania zweryfikowanych atrybutów tożsamości. Nie można go używać do żądania dodatkowych zakresów autoryzacji.
Dalsze kroki
Aby wdrożyć tę funkcję w aplikacji, zapoznaj się z przewodnikiem po implementacji.