Les modules complémentaires Google Classroom doivent utiliser l'authentification unique (SSO) Google pour identifier et authentifier les utilisateurs.
Pour en savoir plus sur l'authentification unique, consultez le Guide OpenID Connect de Google Identity. Nous vous recommandons également de consulter la documentation officielle de Google sur l'inscription et la connexion des utilisateurs pour découvrir la connexion automatique et les consignes relatives à la marque pour la connexion.
Consultez la page de connexion fluide pour obtenir des conseils sur l'implémentation de l'authentification unique Google dans les modules complémentaires Classroom. Ce guide de connexion fait également référence au plan de test qui vous permet de vous assurer que votre module complémentaire respecte les bonnes pratiques de connexion.
Processus de connexion
Pour faciliter la connexion des utilisateurs, Google Classroom fournit deux paramètres de requête lors de l'ouverture d'un iFrame: login_hint et hd. hd correspond au domaine de l'utilisateur. Il est fourni lorsque l'utilisateur ouvre votre module complémentaire pour la première fois. login_hint est l'ID Google unique de l'utilisateur. Il est fourni après que l'utilisateur s'est connecté à votre module complémentaire pour la première fois. Ce paramètre fournit du contexte sur l'utilisateur connecté à Google Classroom. Consultez notre guide des paramètres de connexion pour en savoir plus sur ces paramètres de requête.
Lorsqu'une boîte de dialogue de connexion s'affiche, utilisez le paramètre de requête hd pour filtrer les domaines non valides afin de simplifier les choix des comptes. Vous devez afficher une boîte de dialogue de connexion Google si le paramètre de requête login_hint de l'utilisateur actuel de Google Classroom ne correspond à aucun utilisateur connecté du module complémentaire. Le bouton doit respecter les consignes relatives à la marque de Google. Si l'utilisateur est déjà connecté, il ne doit pas être invité à se reconnecter.
Figure 1. Flux de connexion lorsqu'un utilisateur lance votre module complémentaire pour la première fois.
Pour les installations individuelles, le module complémentaire est ajouté au compte de l'utilisateur. Les utilisateurs sont invités à autoriser les niveaux d'accès du module complémentaire lorsque celui-ci est installé individuellement.
Les installations administrateur ajoutent le module complémentaire à un ou plusieurs comptes du domaine et ne peuvent être effectuées que par un administrateur de domaine. L'administrateur peut éventuellement autoriser tous les niveaux d'accès pour le compte de tous les utilisateurs du domaine. Les utilisateurs ne sont pas invités à autoriser les niveaux d'accès s'ils le font.
Pour en savoir plus, consultez la section Paramètres d'installation.