Google Classroom-Add-ons müssen die Einmalanmeldung (SSO) von Google verwenden, um Nutzer zu identifizieren und zu authentifizieren.
Weitere Informationen zur SSO finden Sie im OpenID Connect Guide von Google Identity. Weitere Informationen finden Sie in der offiziellen Dokumentation von Google zur automatischen Anmeldung und zur Nutzeranmeldung sowie in den Branding-Richtlinien für die Anmeldung.
Auf der Seite für eine reibungslose Anmeldeseite finden Sie eine Anleitung zur Implementierung der Google SSO in Classroom-Add-ons. Der Leitfaden zur reibungslosen Anmeldung bezieht sich auch auf den Testplan, mit dem Sie prüfen können, ob Ihr Add-on den Best Practices für die Anmeldung entspricht.
Anmeldevorgang
Um die Anmeldung für Nutzer zu vereinfachen, bietet Google Classroom beim Öffnen eines iFrames zwei Abfrageparameter: login_hint und hd. hd ist die Domain des Nutzers und wird bereitgestellt, wenn der Nutzer das Add-on zum ersten Mal öffnet. login_hint ist die eindeutige Google-ID des Nutzers und wird bereitgestellt, nachdem sich der Nutzer zum ersten Mal bei Ihrem Add-on angemeldet hat. Dieser Parameter liefert Kontext zu dem Nutzer, der in Google Classroom angemeldet ist. Weitere Informationen zu diesen Abfrageparametern finden Sie auf der Seite mit dem Leitfaden zu Anmeldeparametern.
Verwenden Sie in einem Anmeldedialogfeld den Abfrageparameter hd, um ungültige Domains herauszufiltern, was die Kontoauswahl vereinfacht. Sie müssen ein Google Log-in-Dialogfeld anzeigen, wenn der Abfrageparameter login_hint des aktuellen Google Classroom-Nutzers mit keinem angemeldeten Nutzer des Add-ons übereinstimmt. Die Schaltfläche muss den Branding-Richtlinien von Google entsprechen. Wenn der Nutzer bereits angemeldet ist, sollte er nicht noch einmal zur Anmeldung aufgefordert werden.
Abbildung 1: Anmeldevorgang, wenn ein Nutzer Ihr Add-on zum ersten Mal startet.
Bei einzelnen Installationen wird das Add-on dem eigenen Konto des Nutzers hinzugefügt. Nutzer werden aufgefordert, den Zugriffsbereichen des Add-ons zuzustimmen, wenn das Add-on einzeln installiert wird.
Bei Administratorinstallationen wird das Add-on zu einem oder allen Konten in der Domain hinzugefügt. Sie können nur von einem Domainadministrator ausgeführt werden. Der Administrator kann optional im Namen aller Nutzer in der Domain allen Zugriffsbereichen zustimmen. Nutzer werden nicht aufgefordert, Zugriffsbereiche zuzulassen, wenn der Administrator dies möchte.
Weitere Informationen finden Sie unter Installationseinstellungen.