Da die Anmeldung die erste Interaktion eines Nutzers mit Ihrem Add-on ist, ist es wichtig, dass er den Vorgang so reibungslos wie möglich abschließen kann. In den folgenden Abschnitten finden Sie Informationen zu den verschiedenen Anmelde-APIs, dem meldebezogenen Abfrageparameter, dem Umgang mit Pop-up-Blockern und einem Testplan, den Sie während der Entwicklung verwenden können, um die Best Practices einzuhalten.
Details zur SSO-Implementierung
OAuth 2.0 von Google ist mit vielen OAuth 2.0-Stacks kompatibel. Wir empfehlen dringend, die serverseitige Autorisierung zu implementieren, da sie die höchste Sicherheitsoption ist und die Verwendung von iFrame-Abfrageparametern unterstützt.
Sieh dir bei der Implementierung von Google Log-in die technische Anleitung auf der Google Identity-Website an. Folge den Branding-Richtlinien für Google Log-in. Sketch-, SVG- und EPS-Dateien werden zum Download bereitgestellt.
Anmeldetests
Bevor Sie das Add-on zur Überprüfung einreichen, können Sie mit dem Testplan für Add-ons prüfen, ob es die erforderlichen Standards erfüllt und bekannte Grenzfälle bewältigen kann. Diese Tests spiegeln die Checkliste für die Anforderungen des Classroom-Add-ons wider und enthalten eine detaillierte Anleitung, wie Sie prüfen können, ob Ihr Add-on diese Anforderungen erfüllt. Dies sind dieselben Tests, gegen die Ihre Anwendung während der Veröffentlichung getestet wird.
Abfrageparameter für die Anmeldung
Google Classroom bietet den Abfrageparameter login_hint, um die wiederholte Anmeldung zu erleichtern. Weitere Informationen finden Sie auf der Seite mit den iFrame-Abfrageparametern im Abschnitt Anmeldeparameter. Beispielcode finden Sie in der Schritt-für-Schritt-Anleitung zum Verwalten wiederholter Besuche unserer Schritt-für-Schritt-Anleitungen für Entwickler.
Pop-up-Blocker verwalten
Die Anmeldung im Add-on wird über das Anmeldedialogfenster erleichtert. Dieses Fenster zeigt den Bildschirm für die Kontoauswahl an und ermöglicht dem Nutzer, OAuth-Berechtigungen zu erteilen. Der Pop-up-Blocker eines Endnutzers könnte verhindern, dass er den Anmeldevorgang abschließt.
Abbildung 1: Beispiel für einen Bildschirm für die Kontoauswahl
Um dieses Problem zu beheben, geben Sie dem Endnutzer eine Schaltfläche zum Klicken, um den Pop-up-Blocker zu umgehen. Durch diese Interaktion kann das Anmeldedialogfeld angezeigt werden, sodass der Endnutzer mit dem Anmeldevorgang fortfahren kann. Achte darauf, dass die angegebene Schaltfläche den Branding-Richtlinien für die Anmeldung entspricht.
Folgen Sie der Schritt-für-Schritt-Anleitung zur Anmeldung in unseren Entwickler-Anleitungen, um eine Anmeldeschaltfläche mit Google-Logo zu implementieren, mit der das Anmeldedialogfeld aufgerufen werden kann.
Mehrfachanmeldung
Ein Browser, in dem mehrere Konten gleichzeitig angemeldet sind, kann den Ablauf des Add-on-Nutzers stören. Endnutzer können sich entweder im aktuellen Browser von allen Google-Konten abmelden oder Classroom in einem Inkognitofenster von Chrome öffnen, bevor sie sich mit dem richtigen Konto anmelden und den Vorgang wiederholen.
Wenn aufgrund des Problems bei der Mehrfachanmeldung ein falscher Nutzer im Add-on angemeldet ist, schlagen Ihre Aufrufe der Classroom Add-ons API möglicherweise fehl und der Fehler InvalidAddOnToken wird angezeigt. Wenn Sie eine solche Fehlermeldung erhalten, sollten Sie den Nutzer anweisen, sich entweder von allen anderen Konten im Browser abzumelden oder Classroom in einem Inkognitofenster von Chrome zu öffnen.