Poiché l'esperienza di accesso è la prima interazione che un utente potrebbe avere con il tuo componente aggiuntivo, è importante che possa completare il flusso nel modo più semplice possibile. Leggi le sezioni seguenti per acquisire familiarità con le varie API di accesso, il parametro di query correlato all'accesso, come gestire i blocchi popup e un piano di test che puoi utilizzare durante lo sviluppo per assicurarti di seguire le best practice.
Dettagli di implementazione SSO
OAuth 2.0 di Google è compatibile con molti stack OAuth 2.0. Ti consigliamo vivamente di implementare l'autorizzazione lato server, in quanto è l'opzione di sicurezza più elevata e supporta l'utilizzo dei parametri di query iframe.
Consulta le indicazioni tecniche fornite nel sito web di Google Identity quando implementi l'accesso con Google. Assicurati di seguire le linee guida per il branding dell'accesso di Google. I file Sketch, SVG ed EPS sono disponibili per il download.
Test di accesso
Utilizza il piano di test dei componenti aggiuntivi per verificare che il tuo componente aggiuntivo soddisfi gli standard richiesti e sia in grado di gestire i casi limite noti prima di inviarlo per la revisione. Questi test rispecchiano da vicino la lista di controllo dei requisiti del componente aggiuntivo Classroom e forniscono istruzioni passo passo su come verificare se il componente aggiuntivo soddisfa questi requisiti. Si tratta degli stessi test rispetto ai quali la tua applicazione viene testata durante la pubblicazione.
Parametri di query di accesso
Google Classroom fornisce il parametro di query login_hint per facilitare
l'accesso ripetuto. Per ulteriori informazioni, consulta la sezione sui parametri correlati all'accesso della pagina
dei parametri di query iframe. Il codice campione è disponibile nella
procedura dettagliata per la gestione delle visite ripetute delle nostre procedure dettagliate per gli sviluppatori.
Gestire i blocchi popup
L'accesso al componente aggiuntivo è facilitato dalla finestra di dialogo di accesso. Questa finestra mostra la schermata di selezione dell'account e consente all'utente di concedere le autorizzazioni OAuth. Il blocco popup di un utente finale potrebbe impedirgli di completare la procedura di accesso.
Figura 1. Esempio di una schermata di selezione dell'account.
Per risolvere il problema, fornisci all'utente finale un pulsante su cui fare clic per bypassare il blocco dei popup. Questa interazione consente di visualizzare la finestra di dialogo di accesso in modo che l'utente finale possa continuare con il flusso di accesso. Assicurati che il pulsante che fornisci rispetti le linee guida per il branding dell'accesso.
Segui la procedura dettagliata di accesso nelle nostre procedure dettagliate per gli sviluppatori per implementare un pulsante di accesso con il brand Google su cui è possibile fare clic per attivare la finestra di dialogo di accesso.
Accessi simultanei
Un browser con più account connessi contemporaneamente potrebbe interrompere il flusso utente del componente aggiuntivo. Gli utenti finali possono disconnettersi da tutti gli Account Google nel browser corrente o aprire Classroom in una finestra di navigazione in incognito di Chrome prima di accedere con l'account corretto e riprovare l'operazione.
Se nell'add-on è stato eseguito l'accesso di un utente errato a causa del problema di accesso multiplo,
le chiamate all'API Classroom add-ons potrebbero non riuscire e restituire un errore
InvalidAddOnToken. Se ricevi un errore di questo tipo, devi chiedere
all'utente di uscire da tutti gli altri account nel browser o di aprire
Classroom in una finestra di navigazione in incognito di Chrome.