Collegamento dell'account

Ogni integrazione di Cloud-to-cloud deve includere un meccanismo per autenticare gli utenti.

L'autenticazione ti consente di collegare gli Account Google dei tuoi utenti agli account utente del tuo sistema di autenticazione. In questo modo puoi identificare i tuoi utenti quando il tuo Fulfillment riceve un'intenzione per la smart home. La smart home di Google supporta OAuth solo con un flusso di codice di autorizzazione.

Una volta implementato OAuth 2.0, puoi configurare facoltativamente il App Flip basato su OAuth, che consente agli utenti di collegare più rapidamente i propri account nel tuo sistema di autenticazione ai loro Account Google.

OAuth

Per smart home, devi utilizzare OAuth con un flusso di codice di autorizzazione, che richiede due endpoint: gli endpoint di autorizzazione e di scambio di token.

Una volta autenticato un utente, il token di accesso OAuth 2.0 di terze parti dell'utente viene inviato nell'intestazione di autorizzazione quando gli intent smart home vengono inviati al tuo servizio di evasione degli ordini. Tutti gli utenti devono eseguire il collegamento dell'account, perché le informazioni del dispositivo vengono inviate a Google Assistant con l'intent action.devices.SYNC, che richiede il collegamento dell'account.

L'integrazione di Cloud-to-cloud dovrebbe supportare più utenti Google che si connettono allo stesso account utente (ad esempio, quando gli utenti danno accesso ad altri utenti del proprio nucleo familiare). Se il tuo servizio non supporta più connessioni utente, dovrebbe fornire errori al momento del collegamento dell'account.

Per istruzioni su come configurare un server OAuth 2.0 per l'integrazione, consulta Implementare il server OAuth 2.0.

App Flip basato su OAuth

Il collegamento app Flip basato su OAuth consente agli utenti di collegare in modo facile e veloce i propri account nel sistema di autenticazione ai loro Account Google. Se la tua app è installata sul telefono dell'utente quando avvia la procedura di collegamento dell'account, questa viene impostata senza interruzioni per ottenere l'autorizzazione dell'utente.

Questo approccio fornisce un processo di collegamento più rapido e semplice, poiché l'utente non deve reinserire il nome utente e la password per eseguire l'autenticazione. Al contrario, App Flip utilizza le credenziali dell'account dell'utente sulla tua app. Dopo aver collegato il suo Account Google all'app, può utilizzare tutte le integrazioni che hai sviluppato.

Puoi configurare App Flip per le app iOS e Android.

Questa figura mostra i passaggi per consentire a un utente di collegare il proprio Account Google al sistema di autenticazione. Il primo screenshot mostra come un utente può selezionare l'app se il suo Account Google è collegato all'app. Il secondo screenshot mostra la conferma del collegamento dell'Account Google all'app. Il terzo screenshot mostra un account utente collegato nell'app Google.
Figura 1. Il collegamento dell'account sul telefono di un utente con App Flip.

Requisiti

Per implementare App Flip, devi soddisfare i seguenti requisiti:

  • Devi avere un'app per Android o iOS.
  • Devi possedere, gestire e mantenere un server OAuth 2.0 che supporti il flusso del codice di autorizzazione OAuth 2.0.

Per ulteriori informazioni sul flusso del codice di autorizzazione per il collegamento OAuth, consulta Implementare il server OAuth 2.0.

Per istruzioni su come configurare App Flip per l'integrazione, consulta App Flip basato su OAuth.