Una volta implementato OAuth 2.0, puoi configurare facoltativamente App Flip basato su OAuth, che consente agli utenti Android di collegare più rapidamente i propri account nel tuo sistema di autenticazione ai propri Account Google. Le sezioni seguenti descrivono come progettare e implementare App Flip per l'integrazione di Cloud-to-cloud.
Istruzioni sul design
Questa sezione descrive i requisiti di progettazione e i consigli per la schermata per il consenso per il collegamento dell'account AppFlip. Dopo che Google chiama la tua app, quest'ultima mostra all'utente la schermata per il consenso.
Requisiti
- Devi avere una dichiarazione di autorizzazione di Google come "Una volta eseguito il collegamento, Google avrà l'autorizzazione per controllare i tuoi dispositivi".
- Devi comunicare che l'account dell'utente è stato collegato a Google, non a un prodotto Google specifico, come Google Home o l'Assistente Google.
- Devi indicare un invito all'azione chiaro nella schermata di consenso e utilizzare la dicitura "Accetta e collega" per l'azione di collegamento. Questo perché gli utenti devono capire quali dati sono tenuti a condividere con Google per collegare i loro account.
- Devi fornire agli utenti un modo per tornare indietro o annullare il collegamento, se scelgono di non effettuare il collegamento. Usa la dicitura "Annulla" per l'azione di annullamento.
- Devi implementare questo flusso di lavoro: dopo aver fatto clic su "Accetta e collega", devi mostrare il collegamento riuscito e reindirizzare automaticamente l'utente all'app Google Home. Ora l'utente dovrebbe vedere il dispositivo collegato nell'app Google Home con la tua azione. Dopo aver fatto clic su "Annulla", dovresti reindirizzare l'utente all'app Google Home.
Suggerimenti
Ti consigliamo di procedere nel seguente modo:
Visualizza le Norme sulla privacy di Google. Includi un link alle Norme sulla privacy di Google nella schermata per il consenso.
Dati da condividere. Utilizza un linguaggio chiaro e conciso per comunicare all'utente quali dati richiede Google e perché.
Possibilità di scollegamento. Offri agli utenti un meccanismo di scollegamento, ad esempio un URL che rimanda alle impostazioni dell'account sulla tua piattaforma. In alternativa, puoi includere un link all'Account Google in cui gli utenti possono gestire il proprio account collegato.
Possibilità di cambiare account utente. Suggerisci agli utenti un metodo per cambiare account. Ciò è particolarmente utile se gli utenti tendono ad avere più account.
- Se un utente deve chiudere la schermata di consenso per cambiare account, invia un errore recuperabile a Google in modo che l'utente possa accedere all'account desiderato con il collegamento OAuth e il flusso implicit.
Includi il tuo logo. Mostra il logo della tua azienda nella schermata per il consenso. Segui le tue linee guida per lo stile per posizionare il logo. Se vuoi mostrare anche il logo di Google, consulta la sezione Loghi e marchi.
Configurazione per App Flip basato su OAuth
Le sezioni seguenti descrivono i prerequisiti per App Flip basato su OAuth e come configurare il progetto App Flip nella console per sviluppatori Google Home.
Crea un'integrazione da cloud a cloud e configura un server OAuth 2.0
Prima di poter configurare App Flip, devi:
- Configura un server OAuth 2.0. Per ulteriori informazioni sulla configurazione di un server OAuth, consulta l'articolo Implementare un server OAuth 2.0.
- Crea un'integrazione cloud-to-cloud. Per creare un'integrazione, segui le istruzioni in Creare un'integrazione cloud-to-cloud.
Configurare App Flip in Developer Console
La sezione seguente descrive come configurare App Flip nella Developer Console.
- Compila tutti i campi in Informazioni sul client OAuth. Se App Flip non è supportato, viene utilizzato OAuth normale come fallback.
- Nella sezione Usa la tua app per il collegamento degli account(facoltativo), seleziona Attiva per iOS.
- Compila il campo Link universale. Per ulteriori informazioni sui link universali, vedi Consentire ad app e siti web di collegarsi ai tuoi contenuti.
- Se vuoi configurare facoltativamente il client, aggiungi gli ambiti e fai clic su Aggiungi ambito in Configura il client (facoltativo).
- Fai clic su Salva.
Ora puoi passare alla sezione successiva per implementare App Flip nella tua app per iOS o Android.
Implementare App Flip nelle app native
Per implementare App Flip, devi modificare il codice di autorizzazione utente nella tua app per accettare un link diretto da Google.
Testare App Flip sul tuo dispositivo
Ora che hai creato un'integrazione da cloud a cloud e configurato App Flip nella console e nella tua app, puoi testare App Flip sul tuo dispositivo mobile. Puoi utilizzare l'app Google Home per testare il cambio app.
Per testare App Flip dall'app Google Home, segui questi passaggi:
- Vai alla Developer Console e seleziona il tuo progetto.
- Vai a Da cloud a cloud > Test.
- Attiva il flusso di collegamento degli account dall'app Home:
- Apri il Google Home app (GHA).
- Fai clic sul pulsante +.
- Fai clic su Configura dispositivo.
- Fai clic su Hai già configurato qualcosa?
- Seleziona l'integrazione da cloud a cloud dall'elenco dei fornitori. Nell'elenco, il nome sarà preceduto da "[test]". Quando selezioni l'integrazione [test] dall'elenco, dovrebbe aprirsi la tua app.
- Verifica che l'app sia stata avviata e inizia a testare il flusso di autorizzazione.