Poiché l'esperienza di accesso è la prima interazione che un utente potrebbe avere con il componente aggiuntivo, è importante che l'utente completi il flusso nel modo più semplice possibile. Leggi le sezioni riportate di seguito per acquisire familiarità con le varie API di accesso, il parametro di query relativo all'accesso, la gestione dei blocchi popup e un piano di test da utilizzare durante lo sviluppo per assicurarti di seguire le best practice.
Dettagli implementazione SSO
OAuth 2.0 di Google è compatibile con molti stack OAuth 2.0. Consigliamo vivamente di implementare l'autorizzazione lato server, in quanto si tratta dell'opzione di sicurezza più elevata e supporta l'utilizzo dei parametri di query iframe.
Durante l'implementazione di Accedi con Google, consulta le indicazioni tecniche fornite nel sito web di Google Identity. Assicurati di seguire le linee guida per il branding di Accedi con Google. Puoi scaricare file di schizzo, SVG ed EPS.
Test di accesso
Utilizza il piano di test dei componenti aggiuntivi per verificare che soddisfi gli standard richiesti e sia in grado di gestire casi limite noti prima di inviarlo per la revisione. Questi test rispecchiano fedelmente l'elenco di controllo dei requisiti del componente aggiuntivo di Classroom e forniscono istruzioni passo passo su come verificare se il tuo componente aggiuntivo soddisfa tali requisiti. Si tratta degli stessi test rispetto ai quali viene testata la tua applicazione 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 dei parametri relativi all'accesso nella pagina dei parametri di query dell'iframe. Il codice di esempio è disponibile nella procedura dettagliata per le visite ripetute all'handle delle nostre procedure dettagliate per gli sviluppatori.
Gestisci i blocchi popup
L'accesso al componente aggiuntivo è consentito dalla finestra di dialogo di accesso. Questa finestra mostra la schermata del selettore degli account e consente all'utente di concedere le autorizzazioni OAuth. Il blocco popup di un utente finale potrebbe impedirgli di completare il flusso di accesso.
Figura 1. Un esempio di schermata di selezione degli account.
Per risolvere il problema, fornisci all'utente finale un pulsante su cui fare clic per ignorare il blocco popup. Questa interazione consente di visualizzare la finestra di dialogo di accesso in modo che l'utente finale possa continuare con la procedura di accesso. Assicurati che il pulsante fornito rispetti le linee guida per il branding per l'accesso.
Segui la procedura dettagliata di accesso nelle nostre procedure dettagliate per gli sviluppatori per implementare un pulsante di accesso con brand Google su cui fare clic per attivare la finestra di dialogo di accesso.
Accessi simultanei
Un browser a cui è stato eseguito l'accesso con più account contemporaneamente potrebbe interrompere il flusso del componente aggiuntivo utente. Gli utenti finali possono uscire da tutti gli Account Google nel loro 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 un utente errato ha eseguito l'accesso al componente aggiuntivo a causa del problema di accesso multiplo,
le chiamate all'API dei componenti aggiuntivi di Classroom potrebbero non riuscire e verrà generato 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.