I componenti aggiuntivi di Google Classroom devono utilizzare il servizio Single Sign-On (SSO) di Google per identificare e autenticare gli utenti.
Per ulteriori informazioni sull'accesso SSO, consulta la guida a OpenID Connect di Google Identity. Ti consigliamo inoltre di fare riferimento alla documentazione ufficiale di Google relativa alla registrazione e all'accesso degli utenti per l'accesso automatico e le linee guida per il branding.
Per indicazioni sull'implementazione dell'accesso SSO di Google nei componenti aggiuntivi di Classroom, consulta la pagina di accesso senza problemi. La guida all'accesso senza problemi fa riferimento anche al piano di test che può essere utilizzato per garantire che il componente aggiuntivo rispetti le best practice di accesso.
Flusso di accesso
Per semplificare l'accesso per gli utenti, Google Classroom fornisce due
parametri di query all'apertura di un iframe: login_hint e hd. hd è il dominio
dell'utente e viene fornito quando l'utente apre per la prima volta il componente aggiuntivo. login_hint è
l'ID Google univoco dell'utente e viene fornito dopo che l'utente ha eseguito l'accesso
per la prima volta al componente aggiuntivo. Questo parametro fornisce il contesto relativo
all'utente che ha effettuato l'accesso a Google Classroom. Per una discussione più dettagliata su questi parametri di query, consulta la pagina della guida ai parametri di accesso.
Quando viene visualizzata una finestra di dialogo di accesso, utilizza il parametro di query hd per filtrare i domini non validi, semplificando le scelte degli account. Devi visualizzare una finestra di dialogo Accedi con Google se il parametro di ricerca login_hint dell'utente corrente di Google Classroom non corrisponde ad alcun utente del componente aggiuntivo che ha eseguito l'accesso. Il pulsante deve rispettare le linee guida per il branding di Google. Se l'utente ha già effettuato l'accesso, non gli verrà chiesto di eseguire nuovamente l'accesso.
Figura 1. Flusso di accesso quando un utente
avvia inizialmente il componente aggiuntivo.
Le installazioni singole aggiungono il componente aggiuntivo all'account dell'utente. Agli utenti viene chiesto di acconsentire agli ambiti di accesso del componente aggiuntivo quando il componente aggiuntivo viene installato singolarmente.
Le installazioni amministrative consentono di aggiungere il componente aggiuntivo a uno o a tutti gli account del dominio e possono essere eseguite solo da un amministratore di dominio. Facoltativamente, l'amministratore può concedere il consenso a tutti gli ambiti di accesso per conto di tutti gli utenti nel dominio; agli utenti non viene richiesto di fornire il consenso per alcun ambito di accesso, se l'amministratore sceglie di farlo.
Per ulteriori informazioni, vedi Impostazioni di installazione.