Обработка повторных входов в систему

Это третье пошаговое руководство из серии руководств по использованию дополнений для класса.

В этом пошаговом руководстве вы обрабатываете повторные посещения нашего дополнения, автоматически получая ранее предоставленные учетные данные пользователя. Затем вы перенаправляете пользователей на страницы, с которых они могут немедленно отправлять запросы к API. Это обязательное поведение для дополнений Classroom.

В ходе этого пошагового руководства вы выполните следующие действия:

  • Внедрить постоянное хранилище для учетных данных пользователей.
  • Получите и оцените параметр запроса дополнения login_hint . Это уникальный идентификационный номер Google пользователя, вошедшего в систему.

После завершения этого процесса вы сможете полностью авторизовать пользователей в своем веб-приложении и отправлять запросы к API Google.

Разберитесь в параметрах запроса iframe.

Classroom загружает URI настройки вложений вашего дополнения при открытии. Classroom добавляет к URI несколько параметров GET запроса, содержащих полезную контекстную информацию. Например, если ваш URI поиска вложений — https://example.com/addon , Classroom создаст iframe с исходным URL-адресом, установленным на https://example.com/addon?courseId=XXX&itemId=YYY&itemType=courseWork&addOnToken=ZZZ , где XXX , YYY и ZZZ — строковые идентификаторы. Подробное описание этого сценария см. в руководстве по iframe .

Для URL-адреса обнаружения существует пять возможных параметров запроса:

  • courseId : Идентификатор текущего курса в аудитории.
  • itemId : Идентификатор элемента потока, который пользователь редактирует или создает.
  • itemType : Тип элемента потока, который пользователь создает или редактирует: courseWork , courseWorkMaterial или announcement .
  • addOnToken : Токен, используемый для авторизации определенных действий надстройки Classroom.
  • login_hint : Идентификатор Google текущего пользователя.

В этом пошаговом руководстве рассматривается параметр login_hint . Пользователи перенаправляются в зависимости от того, указан ли этот параметр запроса: либо на страницу авторизации, если он отсутствует, либо на страницу поиска дополнений, если он присутствует.

Получите доступ к параметрам запроса.

Параметры запроса передаются в ваше веб-приложение в строке URI. Сохраните эти значения в вашей сессии; они используются в процессе авторизации, а также для хранения и извлечения информации о пользователе. Эти параметры запроса передаются только при первом открытии дополнения.

Python

Перейдите к определениям ваших маршрутов Flask ( routes.py если вы следуете нашему примеру). В верхней части целевого маршрута вашего дополнения ( /classroom-addon в нашем примере) получите и сохраните параметр запроса login_hint :

# If the login_hint query parameter is available, we'll store it in the session.
if flask.request.args.get("login_hint"):
    flask.session["login_hint"] = flask.request.args.get("login_hint")

Убедитесь, что login_hint (если он присутствует) сохранен в сессии. Это подходящее место для хранения этих значений; они являются временными, и вы получаете новые значения при открытии дополнения.

# It's possible that we might return to this route later, in which case the
# parameters will not be passed in. Instead, use the values cached in the
# session.
login_hint = flask.session.get("login_hint")

# If there's still no login_hint query parameter, this must be their first
# time signing in, so send the user to the sign in page.
if login_hint is None:
    return start_auth_flow()

Java

Перейдите на целевой маршрут дополнения в вашем классе контроллера ( /addon-discovery в AuthController.java в приведенном примере). В начале этого маршрута получите и сохраните параметр запроса login_hint .

/** Retrieve the login_hint query parameter from the request URL if present. */
String login_hint = request.getParameter("login_hint");

Убедитесь, что login_hint (если он присутствует) сохранен в сессии. Это подходящее место для хранения этих значений; они являются временными, и вы получаете новые значения при открытии дополнения.

/** If login_hint wasn't sent, use the values in the session. */
if (login_hint == null) {
    login_hint = (String) session.getAttribute("login_hint");
}

/** If the there is still no login_hint, route the user to the authorization
 *  page. */
if (login_hint == null) {
    return startAuthFlow(model);
}

/** If the login_hint query parameter is provided, add it to the session. */
else if (login_hint != null) {
    session.setAttribute("login_hint", login_hint);
}

Добавьте параметры запроса в процесс авторизации.

Параметр login_hint также следует передавать на серверы аутентификации Google. Это упрощает процесс аутентификации; если ваше приложение знает, какой пользователь пытается пройти аутентификацию, сервер использует подсказку для упрощения процесса входа в систему, предварительно заполняя поле электронной почты в форме входа.

Python

Перейдите к маршруту авторизации в файле вашего Flask-сервера ( /authorize в приведенном примере). Добавьте аргумент login_hint к вызову flow.authorization_url .

authorization_url, state = flow.authorization_url(
    # Enable offline access so that you can refresh an access token without
    # re-prompting the user for permission. Recommended for web server apps.
    access_type="offline",
    # Enable incremental authorization. Recommended as a best practice.
    include_granted_scopes="true",
    # The user will automatically be selected if we have the login_hint.
    login_hint=flask.session.get("login_hint"),

Java

Перейдите к методу authorize() в классе AuthService.java . Добавьте параметр login_hint к этому методу, а также добавьте login_hint и аргумент в конструктор URL-адресов авторизации.

String authUrl = flow
    .newAuthorizationUrl()
    .setState(state)
    .set("login_hint", login_hint)
    .setRedirectUri(REDIRECT_URI)
    .build();

Добавить постоянное хранилище для учетных данных пользователя.

Если при загрузке дополнения вы получаете параметр запроса login_hint , это означает, что пользователь уже завершил процесс авторизации в нашем приложении. Вам следует получить его предыдущие учетные данные, вместо того чтобы заставлять его входить в систему заново.

Напомним, что после завершения процесса авторизации вы получили токен обновления . Сохраните этот токен; он будет использован повторно для получения токена доступа , который является кратковременным и необходим для использования API Google. Ранее вы сохранили эти учетные данные в сессии, но вам необходимо сохранить их для обработки повторных посещений.

Определите схему пользователей и настройте базу данных.

Настройте схему базы данных для User .

Python

Определите схему пользователя.

User обладает следующими атрибутами:

  • id : Идентификатор пользователя в Google. Он должен совпадать со значениями, указанными в параметре запроса login_hint .
  • display_name : Имя и фамилия пользователя, например, "Alex Smith".
  • email : Адрес электронной почты пользователя.
  • portrait_url : URL-адрес фотографии профиля пользователя.
  • refresh_token : Ранее полученный токен обновления.

В этом примере используется хранилище данных SQLite, которое изначально поддерживается Python. Для упрощения управления базой данных используется модуль flask_sqlalchemy .

Настройте базу данных

Сначала укажите местоположение файла для нашей базы данных. Перейдите к файлу конфигурации сервера (в нашем примере это config.py ) и добавьте следующее.

import os

# Point to a database file in the project root.
DATABASE_FILE_NAME = os.path.join(
    os.path.abspath(os.path.dirname(__file__)), 'data.sqlite')

class Config(object):
    SQLALCHEMY_DATABASE_URI = f"sqlite:///{DATABASE_FILE_NAME}"
    SQLALCHEMY_TRACK_MODIFICATIONS = False

Это указывает Flask на файл data.sqlite расположенный в той же директории, что и ваш файл main.py

Далее перейдите в каталог вашего модуля и создайте новый файл models.py . Это будет webapp/models.py если вы следуете нашему примеру. Добавьте в новый файл следующий код для определения таблицы User , заменив webapp на имя вашего модуля, если оно отличается.

from webapp import db

# Database model to represent a user.
class User(db.Model):
    # The user's identifying information:
    id = db.Column(db.String(120), primary_key=True)
    display_name = db.Column(db.String(80))
    email = db.Column(db.String(120), unique=True)
    portrait_url = db.Column(db.Text())

    # The user's refresh token, which will be used to obtain an access token.
    # Note that refresh tokens will become invalid if:
    # - The refresh token has not been used for six months.
    # - The user revokes your app's access permissions.
    # - The user changes passwords.
    # - The user belongs to a Google Cloud organization
    #   that has session control policies in effect.
    refresh_token = db.Column(db.Text())

Наконец, в файле __init__.py вашего модуля добавьте следующее, чтобы импортировать новые модели и создать базу данных.

from webapp import models
from os import path
from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy(app)

# Initialize the database file if not created.
if not path.exists(config.DATABASE_FILE_NAME):
    db.create_all()

Java

Определите схему пользователя.

User обладает следующими атрибутами:

  • id : Идентификатор пользователя в Google. Он должен совпадать со значением, указанным в параметре запроса login_hint .
  • email : Адрес электронной почты пользователя.

Создайте файл schema.sql в каталоге resources модуля. Spring прочитает этот файл и сгенерирует соответствующую схему для базы данных. Определите таблицу с именем таблицы, users и столбцами, представляющими атрибуты User : id и email .

CREATE TABLE IF NOT EXISTS users (
    id VARCHAR(255) PRIMARY KEY, -- user's unique Google ID
    email VARCHAR(255), -- user's email address
);

Создайте Java-класс для определения модели User для базы данных. В приведенном примере это User.java .

Добавьте аннотацию @Entity , чтобы указать, что это POJO, который можно сохранить в базу данных. Добавьте аннотацию @Table с соответствующим именем таблицы, которое вы настроили в schema.sql .

Обратите внимание, что в примере кода присутствуют конструкторы и сеттеры для двух атрибутов. Конструктор и сеттеры используются в AuthController.java для создания или обновления пользователя в базе данных. Вы также можете добавить геттеры и метод toString по своему усмотрению, но в данном пошаговом руководстве эти методы не используются и опущены в примере кода на этой странице для краткости.

/** An entity class that provides a model to store user information. */
@Entity
@Table(name = "users")
public class User {
    /** The user's unique Google ID. The @Id annotation specifies that this
     *   is the primary key. */
    @Id
    @Column
    private String id;

    /** The user's email address. */
    @Column
    private String email;

    /** Required User class no args constructor. */
    public User() {
    }

    /** The User class constructor that creates a User object with the
    *   specified parameters.
    *   @param id the user's unique Google ID
    *   @param email the user's email address
    */
    public User(String id, String email) {
        this.id = id;
        this.email = email;
    }

    public void setId(String id) { this.id = id; }

    public void setEmail(String email) { this.email = email; }
}

Создайте интерфейс с именем UserRepository.java для обработки операций CRUD с базой данных. Этот интерфейс расширяет интерфейс CrudRepository .

/** Provides CRUD operations for the User class by extending the
 *   CrudRepository interface. */
@Repository
public interface UserRepository extends CrudRepository<User, String> {
}

Класс контроллера обеспечивает взаимодействие между клиентом и репозиторием. Поэтому обновите конструктор класса контроллера, чтобы внедрить класс UserRepository .

/** Declare UserRepository to be used in the Controller class constructor. */
private final UserRepository userRepository;

/**
*   ...
*   @param userRepository the class that interacts with User objects stored in
*   persistent storage.
*/
public AuthController(AuthService authService, UserRepository userRepository) {
    this.authService = authService;
    this.userRepository = userRepository;
}

Настройте базу данных

Для хранения информации, связанной с пользователями, используйте базу данных H2, которая изначально поддерживается Spring Boot. Эта база данных также используется в последующих пошаговых инструкциях для хранения другой информации, связанной с учебным процессом. Для настройки базы данных H2 необходимо добавить следующую конфигурацию в application.properties .

# Enable configuration for persistent storage using an H2 database
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.url=jdbc:h2:file:./h2/userdb
spring.datasource.username=<USERNAME>
spring.datasource.password=<PASSWORD>
spring.jpa.hibernate.ddl-auto=update
spring.jpa.open-in-view=false

В конфигурации spring.datasource.url создается каталог h2 , содержащий файл userdb . Добавьте путь к базе данных H2 в файл .gitignore . Перед запуском приложения необходимо обновить параметры spring.datasource.username и spring.datasource.password , указав в качестве имени пользователя и пароля базу данных по вашему выбору. Чтобы обновить имя пользователя и пароль для базы данных после запуска приложения, удалите созданный каталог h2 , обновите конфигурацию и запустите приложение снова.

Установка параметра spring.jpa.hibernate.ddl-auto в значение update гарантирует сохранение данных, хранящихся в базе данных, при перезапуске приложения. Чтобы очищать базу данных каждый раз при перезапуске приложения, установите этот параметр в значение create .

Установите параметр spring.jpa.open-in-view в false . Этот параметр включен по умолчанию и, как известно, может приводить к проблемам с производительностью, которые трудно диагностировать в производственной среде.

Как уже описывалось ранее, вы должны иметь возможность получить учетные данные повторного пользователя. Это обеспечивается встроенной поддержкой хранилища учетных данных, предоставляемой GoogleAuthorizationCodeFlow .

В классе AuthService.java укажите путь к файлу, где хранится класс учетных данных. В этом примере файл создается в каталоге /credentialStore . Добавьте путь к хранилищу учетных данных в файл .gitignore . Этот каталог создается после того, как пользователь начнет процесс авторизации.

private static final File dataDirectory = new File("credentialStore");

Далее создайте в файле AuthService.java метод, который создает и возвращает объект FileDataStoreFactory . Это хранилище данных, в котором хранятся учетные данные.

/** Creates and returns FileDataStoreFactory object to store credentials.
 *   @return FileDataStoreFactory dataStore used to save and obtain users ids
 *   mapped to Credentials.
 *   @throws IOException if creating the dataStore is unsuccessful.
 */
public FileDataStoreFactory getCredentialDataStore() throws IOException {
    FileDataStoreFactory dataStore = new FileDataStoreFactory(dataDirectory);
    return dataStore;
}

Обновите метод getFlow() в AuthService.java , добавив setDataStoreFactory в метод GoogleAuthorizationCodeFlow Builder() и вызвав getCredentialDataStore() для установки хранилища данных.

GoogleAuthorizationCodeFlow authorizationCodeFlow =
    new GoogleAuthorizationCodeFlow.Builder(
        HTTP_TRANSPORT,
        JSON_FACTORY,
        getClientSecrets(),
        getScopes())
    .setAccessType("offline")
    .setDataStoreFactory(getCredentialDataStore())
    .build();

Далее обновите метод getAndSaveCredentials(String authorizationCode) . Ранее этот метод получал учетные данные, не сохраняя их нигде. Обновите метод, чтобы он сохранял учетные данные в хранилище данных, индексированном по идентификатору пользователя.

Идентификатор пользователя можно получить из объекта TokenResponse , используя id_token , но его необходимо предварительно проверить. В противном случае клиентские приложения могут выдавать себя за других пользователей, отправляя измененные идентификаторы пользователей на сервер. Рекомендуется использовать клиентские библиотеки Google API для проверки id_token . Дополнительную информацию см. на странице [Google Identity о проверке токена Google ID].

// Obtaining the id_token will help determine which user signed in to the application.
String idTokenString = tokenResponse.get("id_token").toString();

// Validate the id_token using the GoogleIdTokenVerifier object.
GoogleIdTokenVerifier googleIdTokenVerifier = new GoogleIdTokenVerifier.Builder(
        HTTP_TRANSPORT,
        JSON_FACTORY)
    .setAudience(Collections.singletonList(
        googleClientSecrets.getWeb().getClientId()))
    .build();

GoogleIdToken idToken = googleIdTokenVerifier.verify(idTokenString);

if (idToken == null) {
    throw new Exception("Invalid ID token.");
}

После проверки id_token получите userId для сохранения вместе с полученными учетными данными.

// Obtain the user id from the id_token.
Payload payload = idToken.getPayload();
String userId = payload.getSubject();

Обновите вызов метода flow.createAndStoreCredential , добавив в него userId .

// Save the user id and credentials to the configured FileDataStoreFactory.
Credential credential = flow.createAndStoreCredential(tokenResponse, userId);

Добавьте в класс AuthService.java метод, который возвращает учетные данные для конкретного пользователя, если они существуют в хранилище данных.

/** Find credentials in the datastore based on a specific user id.
*   @param userId key to find in the file datastore.
*   @return Credential object to be returned if a matching key is found in the datastore. Null if
*   the key doesn't exist.
*   @throws Exception if building flow object or checking for userId key is unsuccessful. */
public Credential loadFromCredentialDataStore(String userId) throws Exception {
    try {
        GoogleAuthorizationCodeFlow flow = getFlow();
        Credential credential = flow.loadCredential(userId);
        return credential;
    } catch (Exception e) {
        e.printStackTrace();
        throw e;
    }
}

Получить учетные данные

Определите метод для получения Users . В параметре запроса login_hint вам предоставляется id , который вы можете использовать для получения конкретной записи пользователя.

Python

def get_credentials_from_storage(id):
    """
    Retrieves credentials from the storage and returns them as a dictionary.
    """
    return User.query.get(id)

Java

В классе AuthController.java определите метод для получения пользователя из базы данных на основе его идентификатора.

/** Retrieves stored credentials based on the user id.
*   @param id the id of the current user
*   @return User the database entry corresponding to the current user or null
*   if the user doesn't exist in the database.
*/
public User getUser(String id) {
    if (id != null) {
        Optional<User> user = userRepository.findById(id);
        if (user.isPresent()) {
            return user.get();
        }
    }
    return null;
}

Учетные данные магазина

При хранении учетных данных возможны два сценария. Если id пользователя уже есть в базе данных, обновите существующую запись, добавив новые значения. В противном случае создайте новую запись User и добавьте ее в базу данных.

Python

Сначала определите вспомогательный метод, реализующий поведение сохранения или обновления данных.

def save_user_credentials(credentials=None, user_info=None):
    """
    Updates or adds a User to the database. A new user is added only if both
    credentials and user_info are provided.

    Args:
        credentials: An optional Credentials object.
        user_info: An optional dict containing user info returned by the
            OAuth 2.0 API.
    """

    existing_user = get_credentials_from_storage(
        flask.session.get("login_hint"))

    if existing_user:
        if user_info:
            existing_user.id = user_info.get("id")
            existing_user.display_name = user_info.get("name")
            existing_user.email = user_info.get("email")
            existing_user.portrait_url = user_info.get("picture")

        if credentials and credentials.refresh_token is not None:
            existing_user.refresh_token = credentials.refresh_token

    elif credentials and user_info:
        new_user = User(id=user_info.get("id"),
                        display_name=user_info.get("name"),
                        email=user_info.get("email"),
                        portrait_url=user_info.get("picture"),
                        refresh_token=credentials.refresh_token)

        db.session.add(new_user)

    db.session.commit()

Сохранение учетных данных в базу данных возможно в двух случаях: когда пользователь возвращается в приложение по завершении процесса авторизации и при выполнении вызова API. Именно здесь мы ранее устанавливали ключ credentials сессии.

Вызывайте save_user_credentials в конце маршрута callback . Сохраняйте объект user_info вместо того, чтобы просто извлекать имя пользователя.

# The flow is complete! We'll use the credentials to fetch the user's info.
user_info_service = googleapiclient.discovery.build(
    serviceName="oauth2", version="v2", credentials=credentials)

user_info = user_info_service.userinfo().get().execute()

flask.session["username"] = user_info.get("name")

save_user_credentials(credentials, user_info)

Также следует обновлять учетные данные после вызовов API. В этом случае обновленные учетные данные можно передать в качестве аргументов методу save_user_credentials .

# Save credentials in case access token was refreshed.
flask.session["credentials"] = credentials_to_dict(credentials)
save_user_credentials(credentials)

Java

Сначала определите метод, который сохраняет или обновляет объект User в базе данных H2.

/** Adds or updates a user in the database.
*   @param credential the credentials object to save or update in the database.
*   @param userinfo the userinfo object to save or update in the database.
*   @param session the current session.
*/
public void saveUser(Credential credential, Userinfo userinfo, HttpSession session) {
    User storedUser = null;
    if (session != null && session.getAttribute("login_hint") != null) {
        storedUser = getUser(session.getAttribute("login_hint").toString());
    }

    if (storedUser != null) {
        if (userinfo != null) {
            storedUser.setId(userinfo.getId());
            storedUser.setEmail(userinfo.getEmail());
        }
        userRepository.save(storedUser);
    } else if (credential != null && userinfo != null) {
        User newUser = new User(
            userinfo.getId(),
            userinfo.getEmail(),
        );
        userRepository.save(newUser);
    }
}

Сохранение учетных данных в базу данных возможно в двух случаях: когда пользователь возвращается в приложение по завершении процесса авторизации и при выполнении вызова API. Именно здесь мы ранее устанавливали ключ credentials сессии.

Вызовите saveUser в конце маршрута /callback . Вам следует сохранить объект user_info , а не просто извлекать адрес электронной почты пользователя.

/** This is the end of the auth flow. We should save user info to the database. */
Userinfo userinfo = authService.getUserInfo(credentials);
saveUser(credentials, userinfo, session);

Также следует обновлять учетные данные после вызовов API. В этом случае обновленные учетные данные можно передать в качестве аргументов методу saveUser .

/** Save credentials in case access token was refreshed. */
saveUser(credentials, null, session);

Устаревшие учетные данные

Обратите внимание, что существует несколько причин, по которым токены обновления могут стать недействительными. К ним относятся:

  • Токен обновления не использовался в течение шести месяцев.
  • Пользователь отзывает права доступа к вашему приложению.
  • Пользователь меняет пароль.
  • Пользователь принадлежит к организации Google Cloud, в которой действуют политики управления сессиями.

Чтобы получить новые токены, повторно отправьте пользователя на этап авторизации, если его учетные данные окажутся недействительными.

Автоматическая маршрутизация пользователя

Измените маршрут перехода на страницу дополнения, чтобы он определял, авторизовал ли пользователь наше приложение ранее. Если да, перенаправьте его на главную страницу дополнения. В противном случае предложите ему войти в систему.

Python

Убедитесь, что файл базы данных создан при запуске приложения. Вставьте следующий код в инициализатор модуля (например, webapp/__init__.py в нашем примере) или в основной метод, запускающий сервер.

# Initialize the database file if not created.
if not os.path.exists(DATABASE_FILE_NAME):
    db.create_all()

Затем ваш метод должен обработать параметр запроса login_hint как обсуждалось выше . После этого загрузите учетные данные из хранилища , если это повторный посетитель . Вы поймете, что это повторный посетитель, если получили login_hint . Получите все сохраненные учетные данные для этого пользователя и загрузите их в сессию.

stored_credentials = get_credentials_from_storage(login_hint)

# If we have stored credentials, store them in the session.
if stored_credentials:
    # Load the client secrets file contents.
    client_secrets_dict = json.load(
        open(CLIENT_SECRETS_FILE)).get("web")

    # Update the credentials in the session.
    if not flask.session.get("credentials"):
        flask.session["credentials"] = {}

    flask.session["credentials"] = {
        "token": stored_credentials.access_token,
        "refresh_token": stored_credentials.refresh_token,
        "token_uri": client_secrets_dict["token_uri"],
        "client_id": client_secrets_dict["client_id"],
        "client_secret": client_secrets_dict["client_secret"],
        "scopes": SCOPES
    }

    # Set the username in the session.
    flask.session["username"] = stored_credentials.display_name

Наконец, если у нас нет учетных данных пользователя, перенаправьте его на страницу входа. Если же данные есть, перенаправьте его на главную страницу дополнения.

if "credentials" not in flask.session or \
    flask.session["credentials"]["refresh_token"] is None:
    return flask.render_template("authorization.html")

return flask.render_template(
    "addon-discovery.html",
    message="You've reached the addon discovery page.")

Java

Перейдите по целевой странице вашего дополнения ( /addon-discovery в приведенном примере). Как обсуждалось выше , именно здесь вы обрабатывали параметр запроса login_hint .

Сначала проверьте, существуют ли учетные данные в сессии. Если нет, направьте пользователя через процесс аутентификации, вызвав метод startAuthFlow .

/** Check if the credentials exist in the session. The session could have
 *   been cleared when the user clicked the Sign-Out button, and the expected
 *   behavior after sign-out would be to display the sign-in page when the
 *   iframe is opened again. */
if (session.getAttribute("credentials") == null) {
    return startAuthFlow(model);
}

Затем загрузите пользователя из базы данных H2 , если это повторный посетитель . Это повторный посетитель, если вы получили параметр запроса login_hint . Если пользователь существует в базе данных H2, загрузите учетные данные из ранее настроенного хранилища учетных данных и установите их в сессии. Если учетные данные не были получены из хранилища учетных данных, направьте пользователя через процесс аутентификации, вызвав startAuthFlow .

/** At this point, we know that credentials exist in the session, but we
 *   should update the session credentials with the credentials in persistent
 *   storage in case they were refreshed. If the credentials in persistent
 *   storage are null, we should navigate the user to the authorization flow
 *   to obtain persisted credentials. */

User storedUser = getUser(login_hint);

if (storedUser != null) {
    Credential credential = authService.loadFromCredentialDataStore(login_hint);
    if (credential != null) {
        session.setAttribute("credentials", credential);
    } else {
        return startAuthFlow(model);
    }
}

Наконец, перенаправьте пользователя на целевую страницу дополнения.

/** Finally, if there are credentials in the session and in persistent
 *   storage, direct the user to the addon-discovery page. */
return "addon-discovery";

Протестируйте дополнение

Войдите в Google Classroom как один из ваших тестовых пользователей- учителей . Перейдите на вкладку «Задания» и создайте новое задание . Нажмите кнопку «Дополнения» под текстовым полем, затем выберите дополнение. Откроется iframe, и дополнение загрузит URI настройки вложений , который вы указали на странице конфигурации приложения SDK Google Workspace Marketplace.

Поздравляем! Вы готовы перейти к следующему шагу: созданию вложений и определению роли пользователя .