Łączenie kont

Każda integracja Cloud-to-cloud musi zawierać mechanizm uwierzytelniania użytkowników.

Uwierzytelnianie umożliwia połączenie kont Google użytkowników z kontami użytkowników w Twoim systemie uwierzytelniania. Dzięki temu możesz identyfikować użytkowników, gdy Twoja usługa realizująca otrzymuje intencję dotyczącą inteligentnego domu. Inteligentny dom Google obsługuje tylko protokół OAuth z przepływem kodu autoryzacji.

Gdy masz już wdrożony protokół OAuth 2.0, możesz opcjonalnie skonfigurować przełączanie aplikacji oparte na OAuth App Flip, które umożliwia użytkownikom szybsze łączenie kont w Twoim systemie uwierzytelniania z kontami Google.

OAuth

W przypadku smart home musisz używać protokołu OAuth z przepływem kodu autoryzacji, który wymaga posiadania 2 punktów końcowych: autoryzacji i wymiany tokenów.

Gdy uwierzytelnisz użytkownika, jego token dostępu OAuth 2.0 innej firmy jest wysyłany w nagłówku autoryzacji, gdy smart home intencje są wysyłane do Twojej usługi realizującej. Wszyscy użytkownicy muszą połączyć konta, ponieważ informacje o urządzeniu są wysyłane do Google Assistant z intencją action.devices.SYNC, która wymaga połączenia kont.

Oczekuje się, że integracja typu Cloud-to-cloud będzie obsługiwać wielu użytkowników Google łączących się z tym samym kontem użytkownika (np. gdy użytkownicy przyznają dostęp innym użytkownikom w swoim gospodarstwie domowym). Jeśli Twoja usługa nie obsługuje połączeń wielu użytkowników, powinna wyświetlać błędy podczas łączenia kont.

Instrukcje konfigurowania serwera OAuth 2.0 na potrzeby integracji znajdziesz w artykule Implementowanie serwera OAuth 2.0.

Przełączanie aplikacji oparte na OAuth

Łą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 Implementowanie serwera OAuth 2.0.

Instrukcje konfigurowania App Flip na potrzeby integracji znajdziesz w artykule Przełączanie aplikacji oparte na App Flip.