Dodatki do Google Classroom muszą korzystać z logowania jednokrotnego Google do identyfikowania i uwierzytelniania użytkowników.
Więcej informacji o logowaniu jednokrotnym znajdziesz w przewodniku Google Identity Connect. Zalecamy również zapoznanie się z oficjalnymi dokumentacją Google na temat rejestracji i logowania użytkowników, aby zapoznać się z informacjami o logowaniu automatycznym i wskazówkami dotyczącymi marki przy logowaniu.
Na stronie logowania jednokrotnego znajdziesz wskazówki dotyczące wdrażania funkcji logowania jednokrotnego Google w dodatkach do Classroom. Przewodnik po łatwem logowaniu odnosi się również do planu testów, dzięki któremu możesz sprawdzić, czy dodatek jest zgodny ze sprawdzonymi metodami logowania.
Proces logowania
Aby ułatwić użytkownikom logowanie się, Google Classroom udostępnia 2 parametry zapytania po otwarciu elementu iframe: login_hint i hd. hd to domena użytkownika, która jest podawana, gdy użytkownik po raz pierwszy otwiera dodatek. login_hint to unikalny identyfikator Google użytkownika, który jest podawany po pierwszym zalogowaniu się użytkownika w Twoim dodatku. Ten parametr dostarcza informacji o użytkowniku
zalogowanym w Google Classroom. Bardziej szczegółowe informacje o tych parametrach zapytania znajdziesz na stronie z przewodnikiem po parametrach logowania.
Gdy wyświetli się okno logowania, użyj parametru zapytania hd, aby odfiltrowywać nieprawidłowe domeny i ułatwiać wybór konta. Jeśli parametr zapytania login_hint bieżącego użytkownika Google Classroom nie pasuje do żadnego zalogowanego użytkownika dodatku, musisz wyświetlić okno logowania przez Google. Przycisk musi być zgodny ze wskazówkami Google dotyczącymi marki. Jeśli użytkownik jest już zalogowany, nie powinien otrzymywać prośby o ponowne zalogowanie się.
Rysunek 1. Logowanie się, gdy użytkownik po raz pierwszy
uruchomi Twój dodatek.
Poszczególne instalacje powodują dodanie dodatku do własnego konta użytkownika. Gdy dodatek zostanie zainstalowany osobno, użytkownicy są proszeni o zgodę na korzystanie z zakresów dostępu.
Instalacje administratora powodują dodanie dodatku do wybranych lub wszystkich kont w domenie. Może je przeprowadzić tylko administrator domeny. Administrator może opcjonalnie wyrazić zgodę na wszystkie zakresy dostępu w imieniu wszystkich użytkowników w domenie. Jeśli tak się stanie, użytkownicy nie będą proszeni o zgodę na żaden z zakresów dostępu.
Więcej informacji znajdziesz w sekcji Ustawienia instalacji.