Logowanie jest pierwszą interakcją użytkownika z Twoim dodatkiem, dlatego ważne jest, aby mógł on przejść przez ten proces tak płynnie, jak to możliwe. W sekcjach poniżej znajdziesz informacje o różnych interfejsach API logowania, parametrach zapytań związanych z logowaniem, sposobach radzenia sobie z blokerami wyskakujących okienek oraz plan testów, którego możesz używać podczas tworzenia aplikacji, aby mieć pewność, że stosujesz sprawdzone metody.
Szczegóły implementacji logowania jednokrotnego
Protokół OAuth 2.0 firmy Google jest zgodny z wieloma pakietami OAuth 2.0. Zdecydowanie zalecamy implementację autoryzacji po stronie serwera, ponieważ jest to opcja zapewniająca najwyższy poziom zabezpieczeń i obsługująca parametry zapytania iframe.
Podczas wdrażania logowania w Google zapoznaj się ze wskazówkami technicznymi dostępnymi na stronie tożsamości Google. Pamiętaj, aby przestrzegać wytycznych dotyczących marki logowania Google. Do pobrania są dostępne pliki Sketch, SVG i EPS.
Testy logowania
Zanim prześlesz dodatek do sprawdzenia, użyj planu testowego, aby sprawdzić, czy spełnia on wymagane standardy i czy jest w stanie obsłużyć znane przypadki szczególne. Te testy są bardzo podobne do listy wymagań dotyczących dodatków do Google Classroom. Zawierają szczegółowe instrukcje sprawdzania, czy Twój dodatek spełnia te wymagania. Są to te same testy, które są przeprowadzane podczas publikowania aplikacji.
Parametry zapytania logowania
Google Classroom udostępnia parametr zapytania login_hint, aby ułatwić wielokrotne logowanie. Więcej informacji znajdziesz w sekcji dotyczącej parametrów związanych z logowaniem się na stronie z parametrami zapytania iframe. Przykładowy kod znajdziesz w przewodniku po obsłudze powtarzających się wizytacji w naszych przewodnikach dla deweloperów.
Zarządzanie blokowaniem wyskakujących okienek
Logowanie do dodatku jest ułatwione dzięki oknu logowania. To okno wyświetla ekran wyboru konta i pozwala użytkownikowi przyznać uprawnienia OAuth. Blokada wyskakujących okienek może uniemożliwić użytkownikowi dokończenie procesu logowania.
Rysunek 1. Przykład ekranu selektora konta.
Aby rozwiązać ten problem, udostępnij użytkownikowi przycisk, który umożliwi mu pominięcie blokady wyskakujących okienek. Ta interakcja umożliwia wyświetlenie okna logowania, aby użytkownik mógł kontynuować proces logowania. Upewnij się, że podany przez Ciebie przycisk jest zgodny ze wskazówkami dotyczącymi marki.
Aby wdrożyć przycisk logowania z logo Google, który po kliknięciu uruchamia okno logowania, postępuj zgodnie z przewodnikiem logowania w przewodnikach dla deweloperów.
Wielokrotne logowanie
Przeglądarka z wieloma kontami logowanymi jednocześnie może zakłócić proces korzystania z dodatku. Użytkownicy mogą wylogować się ze wszystkich kont Google w bieżącej przeglądarce lub otworzyć Classroom w oknie incognito w Chrome, zanim zalogują się na właściwe konto i ponownie spróbują wykonać operację.
Jeśli z powodu problemu z wieloma logowaniami do dodatku zalogowany jest niewłaściwy użytkownik, wywołania interfejsu API dodatków Classroom mogą zakończyć się wyświetleniem błędu InvalidAddOnToken. Jeśli pojawi się taki komunikat o błędzie, poproś użytkownika, aby wylogował się ze wszystkich innych kont w przeglądarce lub otworzył Classroom w oknie incognito w Chrome.