Migracja do FedCM

Ten przewodnik pomaga zrozumieć zmiany w Twojej aplikacji internetowej wprowadzone przez Federated Credentials Management API (FedCM).

Po włączeniu FedCM przeglądarka wyświetla prompty i nie plików cookie.

Omówienie

FedCM umożliwia więcej prywatnych procesów logowania bez konieczności używania plików cookie innych firm. Przeglądarka kontroluje ustawienia użytkownika, wyświetla prompty i pytania i kontaktuje się z dostawcą tożsamości, takim jak Google, tylko po tym, jak użytkownik wyraził zgodę użytkownik wyraził zgodę.

W przypadku większości witryn migracja odbywa się płynnie przez zgodność wsteczną aktualizacji biblioteki JavaScript Google Identity Services.

Aktualności na temat funkcji automatycznego logowania

Federated Credential Management (FedCM) w wersji beta dla usług tożsamości Google została uruchomiona w sierpniu 2023 r. Wielu programistów przetestowało ten interfejs cennych opinii.

Jedna odpowiedź od deweloperów dotycząca logowania automatycznego w FedCM wymagania użycia gestów. Aby zapewnić większą prywatność, użytkownicy Chrome wymagają od użytkowników potwierdzać, że w każdej witrynie chcą się logować za pomocą konta Google wystąpienie Chrome, nawet jeśli użytkownik zatwierdził witrynę przed rozpoczęciem procesu FedCM. i jej wdrożeniach. Jednorazowe potwierdzenie odbywa się jednym kliknięciem strony Prompt jednym dotknięciem, aby zademonstrować zamiar zalogowania się użytkownika. Ta zmiana może spowodować początkowe problemy we współczynnikach konwersji związanych z automatycznym logowaniem w niektórych witrynach.

W ostatnim czasie w wersji M121 wprowadziliśmy w Chrome zmianę w automatycznym logowaniu się w FedCM. UX. Ponowne potwierdzenie jest wymagane tylko wtedy, gdy są używane pliki cookie innych firm ograniczony. Oznacza to, że:

  1. W przypadku powracających użytkowników logowanie automatyczne w FedCM nie wymaga ponownego potwierdzania. Jeśli użytkownik ponownie potwierdzi tę czynność w interfejsie FedCM, zostanie ono uwzględnione w ramach funkcji wymagania dotyczące gestów w okresie po 3PCD.

  2. Automatyczne logowanie do FedCM sprawdzi stan ponownego potwierdzenia, gdy pliki cookie innych firm są w tej chwili ręcznie ograniczane przez użytkowników lub domyślnie Chrome.

W związku z tą zmianą zalecamy wszystkim deweloperom korzystającym z automatycznego logowania się przejście do FedCM. jak najszybciej, aby zmniejszyć zakłócenia we współczynnikach konwersji związanych z logowaniem automatycznym.

W przypadku procesu logowania automatycznego GIS JavaScript nie będzie wywoływać FedCM na starszym urządzeniu Chrome (przed wersją M121), nawet jeśli Twoja witryna zezwala na korzystanie z FedCM.

Różnice w ścieżkach użytkowników

Funkcje obsługiwane jednym dotknięciem korzystające z FedCM i bez FedCM są podobne tylko w przypadku niewielkie różnice.

Nowy użytkownik z jedną sesją

Dzięki usłudze FedCM jedno dotknięcie powoduje wyświetlenie nazwy domeny zamiast nazwy aplikacji.

Korzystanie z FedCM Bez FedCM
Nowy użytkownik korzystający z jednej sesji w FedCM Nowy użytkownik z jedną sesją bez FedCM

Powracający użytkownik korzystający z jednej sesji (z wyłączonym logowaniem automatycznym)

Dzięki usłudze FedCM jedno dotknięcie powoduje wyświetlenie nazwy domeny zamiast nazwy aplikacji.

Korzystanie z FedCM Bez FedCM
Ścieżka powracającego użytkownika z jedną sesją przy użyciu FedCM (z wyłączonym logowaniem automatycznym) Ścieżka powracającego użytkownika z jedną sesją bez FedCM (z wyłączonym logowaniem automatycznym)

Powracający użytkownik z jedną sesją (z włączonym automatycznym logowaniem)

Korzystając z FedCM, użytkownicy mogą w ciągu pięciu dni kliknąć X, aby anulować automatyczne logowanie. zamiast klikać przycisk Anuluj.

Korzystanie z FedCM Bez FedCM
Ścieżka powracającego użytkownika z jedną sesją przy użyciu FedCM (z włączonym logowaniem automatycznym) Ścieżka powracającego użytkownika z jedną sesją bez FedCM (z włączonym logowaniem automatycznym)

Wiele sesji

Dzięki usłudze FedCM jedno dotknięcie powoduje wyświetlenie nazwy domeny zamiast nazwy aplikacji.

Korzystanie z FedCM Bez FedCM
Użytkownik z wieloma sesjami korzystający z FedCM Użytkownik z wieloma sesjami bez FedCM

Zanim zaczniesz

Sprawdź, czy ustawienia i wersja Twojej przeglądarki obsługują interfejs FedCM API. zalecamy zaktualizowanie go do najnowszej wersji.

  • Interfejs FedCM API jest dostępny w Chrome 117 i nowszych wersjach.

  • ustawienie Logowanie przez usługę zewnętrzną jest włączone w Chrome.

  • Jeśli masz przeglądarkę Chrome w wersji 119 lub starszej, otwórz chrome://flags i włączyć eksperymentalną funkcję FedCmWithoutThirdPartyCookies. Ten krok nie jest wymagany w przeglądarce Chrome 120 lub nowszej.

Przenoszenie aplikacji internetowej

Wykonaj te czynności, aby włączyć FedCM, ocenić potencjalny wpływ migracji i w razie potrzeby:

1. Dodaj flagę wartości logicznej, aby włączyć FedCM podczas inicjowania za pomocą:

2. Usuń w kodzie użycie metod isDisplayMoment(), isDisplayed(), isNotDisplayed() i getNotDisplayedReason().

Aby poprawić prywatność użytkownika, wywołanie zwrotne google.accounts.id.prompt nie nie zwraca już żadnego powiadomienia o momencie wyświetlania w PromptMomentNotication. Usuń kod zależny od parametru i wyświetlać metody związane z momentami. To: isDisplayMoment(), isDisplayed(), isNotDisplayed() i getNotDisplayedReason().

3. Usuń użycie metody getSkippedReason() w kodzie.

Podczas gdy moment pominięcia (isSkippedMoment()) jest nadal wywoływany z Wywołanie zwrotne google.accounts.id.prompt w PromptMomentNotication obiektu, nie zostanie podany szczegółowy powód. Usuń kod, który zależy od metodzie getSkippedReason() z Twojego kodu.

Zwróć uwagę, że odrzucone powiadomienie o momencie, isDismissedMoment() i powiązana szczegółowa metoda wyjaśniania (getDismissedReason()) pozostaje bez zmian gdy usługa FedCM jest włączona.

4. Usuń atrybuty stylu position z kategorii data-prompt_parent_id i intermediate_iframes.

Przeglądarka kontroluje rozmiar i pozycję promptów oraz pozycji niestandardowych w przypadku jednego dotknięcia na komputerze nie są obsługiwane.

5. W razie potrzeby zmień układ strony.

Przeglądarka kontroluje rozmiar i pozycję promptów użytkownika. W zależności od układem poszczególnych stron, niektóre treści mogą być pozycje obsługiwane za pomocą jednego dotknięcia na komputerze nie są w żaden sposób obsługiwane, atrybut stylu, data-prompt_parent_id, intermediate_iframes, niestandardowe elementy iframe i inne kreatywne sposoby.

Zmień układ strony, aby zwiększyć wygodę użytkowników, gdy ważne informacje są ważne jest zasłonięty. Nie buduj komfortu korzystania z aplikacji na podstawie prompta jednym dotknięciem, nawet jeśli uważasz, znajduje się w pozycji domyślnej. Interfejs FedCM API działa w ramach zapośredniczenia przeglądarki, różni dostawcy przeglądarek mogą umieścić pytanie na pozycji w inny sposób.

6. Dodaj atrybut allow="identity-credentials-get" do ramki nadrzędnej, jeśli Twoja aplikacja internetowa wywołuje interfejs One Tap API z elementów iframe z innych domen.

Element iframe jest uznawany za element z innej domeny, jeśli jego Parametr origin jest różny od parametru pochodzenia nadrzędnego. Na przykład:

  • Różne domeny: https://example1.com i https://example2.com
  • Różne domeny najwyższego poziomu: https://example.uk i https://example.jp
  • Subdomeny: https://example.com i https://login.example.com

    Aby poprawić prywatność użytkownika, gdy interfejs One Tap API jest wywoływany z elementów iframe z innych domen, musisz dodać allow="identity-credentials-get" w każdej ramce nadrzędnej tagu iframe:

    <iframe src="https://your.cross-origin/onetap.page" allow="identity-credentials-get"></iframe>
    

    Jeśli aplikacja korzysta z elementu iframe zawierającego inny element iframe, musisz sprawdź, czy atrybut został dodany do każdego elementu iframe, w tym do wszystkich jego elementów podrzędnych.

    Przeanalizujmy ten scenariusz:

  • Górny dokument (https://www.example.uk) zawiera element iframe o nazwie „iframe A”, który zawiera stronę (https://logins.example.com).

  • Ta strona osadzona (https://logins.example.com) zawiera też element iframe o nazwie „iframe B”, który dodatkowo zawiera stronę (https://onetap.example2.com) który obsługuje jedno dotknięcie.

    Aby zapewnić prawidłowe wyświetlanie jednym dotknięciem, musisz dodać atrybut do tagów iframe A i iframe B.

    Przygotuj się na pytania dotyczące niewyświetlanego komunikatu jednym dotknięciem. W innych witrynach o różnych źródłach mogą znajdować się Twoje strony obsługujące jedno dotknięcie w elementach iframe. Możesz otrzymać większą liczbę zgłoszeń do zespołu pomocy i nie są one wyświetlane u użytkowników ani innych właścicieli witryn. Choć zmiany mogą wprowadzać tylko właściciele poszczególnych stron, więc możesz następujące kroki:

  • Zaktualizuj dokumentację dla deweloperów, by zawierała informacje o tym, jak skonfigurować element iframe . Link do tej strony możesz znaleźć w swojej dokumentacji.

  • W razie potrzeby zaktualizuj stronę z najczęstszymi pytaniami dla deweloperów.

  • Poinformuj zespół pomocy o nadchodzącej zmianie i przygotuj się na reakcję na zagadnienie z wyprzedzeniem.

  • Proaktywnie skontaktuj się z partnerami, klientami lub właścicielami witryny, których dotyczy problem, płynnego przejścia w FedCM.

7. Dodaj te dyrektywy do swojej polityki bezpieczeństwa treści (CSP).

Ten krok jest opcjonalny, ponieważ nie wszystkie witryny decydują się na definiowanie CSP.

  • Jeśli w witrynie nie używasz CSP, nie musisz wprowadzać żadnych zmian.

  • Jeśli Twój CSP działa w przypadku bieżącego kliknięcia jednym dotknięciem i nie używasz connect-src, frame-src, script-src, style-src lub default-src – brak zmian niezbędną.

  • W przeciwnym razie postępuj zgodnie z instrukcjami w tym przewodniku, aby skonfigurować CSP. Bez odpowiedniego CSP funkcja One Tap nie będzie się wyświetlać w tej witrynie.

8. Usuń obsługę przyspieszonych stron mobilnych (AMP) na potrzeby logowania.

Obsługa logowania użytkowników na stronach AMP to opcjonalna funkcja GIS w Twojej aplikacji internetowej które można wdrożyć. W takim przypadku

Usuń wszelkie odniesienia do:

  • amp-onetap-google elementu niestandardowego,

  • <script async custom-element="amp-onetap-google" src="https://cdn.ampproject.org/v0/amp-onetap-google-0.1.js"></script>
    

    Rozważ przekierowywanie żądań logowania ze strony AMP do funkcji logowania HTML w swojej witrynie przepływu danych. Zwróć uwagę, że powiązana Intermediate Iframe Support API to a wszystko to jest możliwe.

Testowanie i weryfikacja migracji

Po wprowadzeniu niezbędnych zmian w oparciu o poprzednie kroki możesz sprawdzić poprawność migracja powiodła się.

  1. Sprawdź, czy Twoja przeglądarka obsługuje FedCM i masz już profil Google. Sesja konta.

  2. Otwórz strony jednym dotknięciem w aplikacji.

  3. Sprawdź, czy wyświetla się prompt jednym dotknięciem i bezpiecznie nakłada się na treści.

  4. Potwierdź, że dane logowania są zwracane do punktu końcowego lub metody wywołania zwrotnego podczas logowania się w aplikacji jednym dotknięciem.

  5. Jeśli logowanie automatyczne jest włączone, sprawdź, czy anulowanie działa i czy jest to prawidłowe prawidłowe dane logowania są zwracane do punktu końcowego lub metody wywołania zwrotnego.

Okres oczekiwania jednym dotknięciem

Klikam jednym dotknięciem w prawym górnym rogu zamyka prompt i rozpoczyna okres oczekiwania, zapobiega tymczasowemu wyświetlaniu komunikatu jednym dotknięciem. Jeśli w Chrome chcesz, aby komunikat jednym dotknięciem wyświetlał się ponownie przed zakończeniem okresu oczekiwania, można zresetować stan oczekiwania, klikając ikonę blokady na pasku adresu i klikając przycisk Zresetuj uprawnienia.

Okres blokady automatycznego logowania się

Gdy testujesz logowanie automatyczne jednym dotknięciem w FedCM, masz 10 minut, bez przerwy między każdą próbą automatycznego zalogowania. W okresie ciszy nie można . Musisz zaczekać 10 minut lub użyć innego konta Google na potrzeby testowania w celu ponownego aktywowania logowania automatycznego.

Przydatne materiały

Privacy Sandbox Analysis Tool (PSAT) to rozszerzenie do Chrome DevNarzędzia , które pomogą Ci we wdrożeniu alternatywnych interfejsów API, takich jak FedCM. Działanie przeskanowanie witryny pod kątem elementów, których dotyczy problem, i wyświetli listę zalecanych zmian.