Collegamento dell'account

Ogni integrazione Cloud-to-cloud deve includere un meccanismo per l'autenticazione degli utenti.

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

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

OAuth

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

Dopo aver autenticato un utente, il token di accesso OAuth 2.0 di terze parti dell'utente viene inviato nell'intestazione di autorizzazione quando gli intent per la smart home vengono inviati al fulfillment.smart home Tutti gli utenti devono eseguire il collegamento dell'account, perché le informazioni sul dispositivo vengono inviate all' Google Assistant con l'intent action.devices.SYNC, che richiede il collegamento dell'account.

È previsto che l'integrazione Cloud-to-cloud supporti più utenti Google che si connettono allo stesso account utente (ad esempio, quando gli utenti concedono l'accesso ad altri utenti della loro famiglia). Se il tuo servizio non è in grado di supportare più connessioni utente, deve 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 (App Flip) basato su OAuth consente agli utenti di collegare facilmente e rapidamente i propri account nel tuo sistema di autenticazione ai loro Account Google. Se la tua app è installata sullo smartphone dell'utente quando avvia la procedura di collegamento dell'account, viene indirizzato alla tua app per ottenere l'autorizzazione dell'utente.

Questo approccio offre una procedura di collegamento più rapida e semplice, poiché l'utente non deve inserire di nuovo il nome utente e la password per l'autenticazione. Al contrario, App Flip sfrutta le credenziali dell'account dell'utente nella tua app. Una volta che un utente ha collegato il proprio Account Google alla tua app, può usufruire di tutte le integrazioni che hai sviluppato.

Puoi configurare App Flip sia per le app per iOS sia per le app per Android.

Questa figura mostra i passaggi che un utente deve seguire per collegare il proprio Account Google al tuo sistema di autenticazione. Il primo screenshot mostra in che modo un utente
 può selezionare la tua app se il proprio Account Google è collegato alla tua app.
 Il secondo screenshot mostra la conferma del collegamento del proprio
 Account Google all'app. Il terzo screenshot mostra un
 account utente collegato correttamente nell'app Google.
Figura 1. Collegamento dell'account sullo smartphone di un utente con App Flip.

Requisiti

Per implementare la funzionalità di rotazione dell'app, 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 App Flip.