Дополнения Google Classroom должны использовать систему единого входа Google (SSO) для идентификации и аутентификации пользователей.
Дополнительную информацию о едином входе см. в руководстве по OpenID Connect от Google Identity . Мы также рекомендуем обратиться к официальной документации Google по регистрации и входу пользователей для автоматического входа и рекомендациям по брендингу для входа .
Инструкции по реализации системы единого входа Google в надстройках Класса см. на странице удобного входа. Руководство по простому входу также относится к плану тестирования , который можно использовать, чтобы убедиться, что ваша надстройка соответствует рекомендациям по входу в систему.
Вход в систему
Чтобы уменьшить трудности входа в систему для пользователей, Google Classroom предоставляет два параметра запроса при открытии iframe: login_hint и hd . hd — это домен пользователя, который предоставляется, когда пользователь впервые открывает ваше дополнение. login_hint — это уникальный идентификатор Google пользователя, который предоставляется после того, как пользователь впервые вошел в вашу надстройку. Этот параметр предоставляет контекст пользователя, вошедшего в Google Classroom. См. нашу страницу руководства по параметрам входа для более подробного обсуждения этих параметров запроса.
Когда отобразится диалоговое окно входа, используйте параметр запроса hd , чтобы отфильтровать недействительные домены, упрощая выбор учетной записи. Вы должны отобразить диалоговое окно входа в Google, если параметр запроса login_hint текущего пользователя Google Classroom не соответствует ни одному вошедшему в систему пользователю надстройки. Кнопка должна соответствовать рекомендациям Google по брендингу . Если пользователь уже вошел в систему, ему не должно быть предложено войти в систему еще раз.
Рисунок 1. Процесс входа в систему, когда пользователь впервые запускает надстройку.
При индивидуальной установке надстройка добавляется в собственную учетную запись пользователя. Пользователям предлагается дать согласие на области доступа надстройки, когда надстройка устанавливается отдельно.
При установке администратора надстройка добавляется к любой или всем учетным записям в домене и может выполняться только администратором домена. При необходимости администратор может дать согласие на все области доступа от имени всех пользователей в домене; пользователям не предлагается дать согласие на какие-либо области доступа, если администратор решит это сделать.
Дополнительную информацию см. в разделе Параметры установки .