Google Classroom-Add-ons müssen die Einmalanmeldung (SSO) von Google verwenden, um Nutzer zu identifizieren und zu authentifizieren.
Weitere Informationen zur Einmalanmeldung finden Sie im OpenID Connect-Leitfaden für Google Identity. Wir empfehlen Ihnen außerdem, die offizielle Dokumentation von Google zur Registrierung und Anmeldung von Nutzern zu lesen, insbesondere die Informationen zur automatischen Anmeldung und die Richtlinien für das Branding bei der Anmeldung.
Auf der Seite Einfache Anmeldung finden Sie eine Anleitung zur Implementierung von Google-SSO in Classroom-Add-ons. Im Leitfaden zur reibungslosen Anmeldung wird auch auf den Testplan verwiesen, mit dem Sie prüfen können, ob Ihr Add-on die Best Practices für die Anmeldung erfüllt.
Anmeldevorgang
Um die Anmeldung für Nutzer zu vereinfachen, stellt Google Classroom den Abfrageparameter login_hint bereit, wenn ein Iframe geöffnet wird. login_hint ist die eindeutige Google-ID eines Nutzers und wird nach der erstmaligen Anmeldung des Nutzers in Ihrem Add-on bereitgestellt. Dieser Parameter liefert Kontext zum Nutzer, der in Google Classroom angemeldet ist. Eine ausführlichere Erläuterung dieser Abfrageparameter finden Sie in unserem Leitfaden zu Anmeldeparametern.
Du musst ein Google Log-in-Dialogfeld anzeigen, wenn der login_hint-Abfrageparameter 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 individuellen Installationen wird das Add-on dem Konto des Nutzers hinzugefügt. Nutzer werden bei der einzelnen Installation des Add-ons aufgefordert, den Zugriffsbereichen des Add-ons zuzustimmen.
Bei Administratorinstallationen wird das Add-on allen oder einigen Konten in der Domain hinzugefügt. Sie können nur von einem Domainadministrator durchgeführt werden. Der Administrator kann optional im Namen aller Nutzer in der Domain allen Zugriffsbereichen zustimmen. In diesem Fall werden die Nutzer nicht aufgefordert, einer Einwilligung zuzustimmen.
Weitere Informationen finden Sie unter Installationseinstellungen.