Collegamento dell'account

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

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

Una volta implementato OAuth 2.0, puoi configurare facoltativamente 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.

Quando hai autenticato un utente, il token di accesso OAuth 2.0 di terze parti dell'utente viene inviato nell'intestazione di autorizzazione quando gli intent vengono inviati al tuo fulfillment.smart home Tutti gli utenti devono eseguire il collegamento dell'account, perché i dati del dispositivo vengono inviati 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 concedono l'accesso ad altri utenti del proprio nucleo familiare). Se il tuo servizio non supporta 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 la pagina Implementare il server OAuth 2.0.

App Flip basato su OAuth

OAuth-based App Flip Linking (App Flip) allows your users to easily and quickly link their accounts in your authentication system to their Google accounts. If your app is installed on your user’s phone when they initiate the account linking process, they are seamlessly flipped to your app to obtain user authorization.

This approach provides a faster and easier linking process since the user does not have to re-enter their username and password to authenticate; instead, App Flip leverages the credentials from the user's account on your app. Once a user has linked their Google account with your app, they can take advantage of any integrations that you have developed.

You can set up App Flip for both iOS and Android apps.

This figure shows the steps for a user to link their Google account to your authentication system. The first screenshot shows how a user can select your app if their Google account is linked to your app. The second screenshot shows the confirmation for linking their Google account with your app. The third screenshot shows a successfully linked user account in the Google app.
Figure 1. Account linking on a user's phone with App Flip.

Requirements

To implement App Flip, you must fulfill the following requirements:

  • You must have an Android or iOS app.
  • You must own, manage and maintain an OAuth 2.0 server which supports the OAuth 2.0 authorization code flow.

Per maggiori 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.

Indietro
Fulfillment