Przegląd

Łączenie aplikacji oparte na OAuth (App Flip) umożliwia użytkownikom łatwe i szybkie łączenie kont w Twoim systemie uwierzytelniania z ich kontami Google. Jeśli aplikacja jest zainstalowana na telefonie użytkownika, gdy ten rozpoczyna proces łączenia konta, użytkownik jest automatycznie przekierowywany do Twojej aplikacji w celu uzyskania autoryzacji.

Dzięki temu proces łączenia jest szybszy i prostszy, ponieważ użytkownik nie musi ponownie wpisywać nazwy użytkownika i hasła. Zamiast tego App Flip wykorzystuje dane logowania z konta użytkownika w Twojej aplikacji. Gdy użytkownik połączy swoje konto Google z Twoją aplikacją, będzie mógł korzystać z integracji, które zostały przez Ciebie opracowane.

Możesz skonfigurować przejście do aplikacji zarówno w przypadku aplikacji na iOS, jak i na Androida.

Ten rysunek pokazuje czynności, które użytkownik musi wykonać, aby połączyć swoje konto Google z Twoim systemem uwierzytelniania. Pierwszy zrzut ekranu pokazuje, jak użytkownik może wybrać Twoją aplikację, jeśli jego konto Google jest z nią połączone. Drugi zrzut ekranu pokazuje potwierdzenie połączenia konta Google z aplikacją. Trzeci zrzut ekranu pokazuje połączone konto użytkownika w aplikacji Google.
Rysunek 1. Łączenie kont na telefonie użytkownika za pomocą App Flip.

Wymagania

Aby zaimplementować App Flip, musisz spełniać te wymagania:

  • Musisz mieć aplikację na Androida lub iOS.
  • Musisz mieć serwer OAuth 2.0, którym zarządzasz i który obsługuje przepływ kodu autoryzacji OAuth 2.0.

Więcej informacji o przepływie kodu autoryzacji łączenia OAuth znajdziesz w artykule o implementowaniu serwera OAuth.

设计准则

本部分介绍了 App Flip 账号关联意见征求界面的设计要求和建议。Google 调用您的应用后，应用会向用户显示同意屏幕。

要求

  1. 您必须说明用户的账号将与 Google 相关联，而不是与特定 Google 产品（例如 Google Home 或 Google 助理）相关联。

建议

建议您执行以下操作：

  1. 显示 Google 的隐私权政策。在同意屏幕上添加指向 Google 隐私权政策的链接。

  2. 要分享的数据。使用简洁明了的语言告知用户 Google 需要哪些数据以及为何需要这些数据。

  3. 明确的号召性用语。在用户同意页面上提供明确的号召性用语，例如“同意并关联”。这是因为用户需要了解他们需要与 Google 分享哪些数据才能关联账号。

  4. 能够取消。为用户提供返回或取消链接的途径，如果用户选择不进行关联。

  5. 能够解除关联。提供一种供用户解除关联的机制，例如指向他们在您的平台上账号设置的网址。或者，您也可以添加指向 Google 账号的链接，以便用户管理其关联的账号。

  6. 能够更改用户账号。建议用户切换账号的方法。如果用户通常拥有多个账号，这种做法尤为有益。

    • 如果用户必须关闭意见征求界面才能切换账号，请向 Google 发送可恢复的错误，以便用户可以使用 OAuth 关联和隐式流程登录所需的账号。

  7. 添加您的徽标。在同意屏幕上显示您的公司徽标。 按照您的样式准则放置徽标。如果您还想显示 Google 的徽标，请参阅徽标和商标。

此图显示了同意页面的示例，其中突出显示了设计用户意见征求页面时应遵循的具体要求和建议。
图 2. 账号关联意见征求界面设计指南。

Konfigurowanie przewracania aplikacji opartej na protokole OAuth

W sekcjach poniżej opisano wymagania wstępne dotyczące przenoszenia aplikacji korzystającej z protokołu OAuth oraz informacje o konfigurowaniu projektu Przewracanie aplikacji w konsoli Actions.

Utwórz działanie i skonfiguruj serwer OAuth 2.0

Zanim skonfigurujesz odwrócenie aplikacji, musisz wykonać te czynności:

Konfigurowanie odwrócenia aplikacji w konsoli Actions

Z sekcji poniżej dowiesz się, jak skonfigurować przerzucenie aplikacji w konsoli Actions.

  1. W górnym panelu nawigacyjnym kliknij Programuj. Następnie w menu nawigacyjnym po lewej stronie kliknij Łączenie kont.
  2. Przesuń przełącznik obok opcji Łączenie kont.
  3. W sekcji Tworzenie konta wybierz Nie, chcę zezwolić na tworzenie konta tylko na mojej stronie.
  4. Kliknij Dalej.
  5. W sekcji Typ połączenia wybierz z menu Protokół OAuth i Kod autoryzacji.
  6. Kliknij Dalej.
  7. Wypełnij wszystkie pola w sekcji Informacje o kliencie OAuth. (Jeśli przerzucenie aplikacji nie jest obsługiwane, jako kreacji zastępczej używana jest standardowa protokół OAuth).
  8. Kliknij Dalej.
  9. W sekcji Użyj aplikacji do łączenia kont (opcjonalnie) zaznacz Włącz na iOS.
  10. Wypełnij pole Uniwersalny link. Więcej informacji o uniwersalnych linkach znajdziesz w artykule Zezwalanie aplikacjom i stronom internetowym na tworzenie linków do Twoich treści .
  11. Jeśli chcesz opcjonalnie skonfigurować klienta, dodaj zakresy i kliknij Dodaj zakres w sekcji Skonfiguruj klienta (opcjonalnie). Jeśli nie, kliknij Dalej.
  12. W sekcji Instrukcje testowania wpisz test (lub dowolny inny ciąg) jako zmienną. (Wypełnienie tego pola nazwą konta testowego jest konieczne tylko wtedy, gdy rzeczywiście przesyłasz akcję do opublikowania).
  13. Kliknij Zapisz.

Możesz teraz przejść do następnej sekcji, aby zaimplementować odwracanie aplikacji w aplikacji na iOS lub Androida.

Implementowanie funkcji odwracania aplikacji w aplikacjach natywnych

Aby zaimplementować odwrót, musisz zmodyfikować kod autoryzacji użytkownika w aplikacji tak, aby akceptował precyzyjny link od Google.

Przetestuj funkcję App Flip na swoim urządzeniu

Po utworzeniu działania i skonfigurowaniu przewracania aplikacji w konsoli i w aplikacji możesz przetestować tę funkcję na urządzeniu mobilnym. Możesz ją przetestować za pomocą aplikacji Asystent Google.

Aby przetestować przerzucenie aplikacji z poziomu aplikacji Asystent, wykonaj te czynności:

  1. Otwórz Konsolę Actions i wybierz projekt.
  2. W menu u góry kliknij Przetestuj.
  3. Uruchom proces łączenia kont w aplikacji Asystent:
    1. Otwórz aplikację Asystent Google.
    2. Kliknij Ustawienia.
    3. Na karcie Asystent kliknij Sterowanie domem.
    4. Kliknij Dodaj(+).
    5. Wybierz akcję z listy dostawców. Na liście będzie przed nim prefiks „[test]”. Gdy wybierzesz z listy akcję [testowe], powinna ona otworzyć Twoją aplikację.
    6. Sprawdź, czy Twoja aplikacja została wprowadzona na rynek, i rozpocznij testowanie przepływu autoryzacji.