Как подключить Класс к системе информации об учащихся

Требования

Класс можно подключить к Infinite Campus, если:

• система Infinite Campus используется с лицензией Campus Learning;
• решение SaaS полностью размещается и управляется на стороне Infinite Campus.

Google не предоставляет поддержку, если в вашем школьном округе:

• для работы Infinite Campus применяется локально развернутое ПО;
• используются сторонние облачные решения, не управляемые Infinite Campus, например виртуальные машины AWS/GCP.

Куда можно обратиться с вопросами о первоначальной настройке на портале Infinite Campus:

• Поддержка Campus без авторизации
• Поддержка Campus для авторизованных пользователей

Шаг 1. Получите учетные данные OAuth

1. Войдите на страницу администратора Infinite Campus.
2. Найдите раздел Digital Learning Applications (Цифровые обучающие приложения).
3. Нажмите Add application (Добавить приложение).
4. В окне Browse Applications (Обзор приложений) нажмите Google Classroom (Google Класс).
5. Если это окно не появится, проверьте свою лицензию Campus Learning:
   • Найдите раздел Campus Learning Licensing (Лицензии Campus Learning) уточните статус своей лицензии в правом верхнем углу.
   • Если у вас ее нет, вы можете запросить временную 45-дневную лицензию, но только один раз.
   • Если у вас есть лицензия, но вам все равно не удается получить учетные данные, свяжитесь со службой поддержки Campus.

6. Нажмите Generate New OneRoster Connection (Новое подключение с OneRoster).

7. Выберите OneRoster 1.2.

8. Запишите значения следующих учетных данных OAuth:

   • Consumer key (Идентификатор клиента) – идентификатор OAuth;
   • Consumer secret (Секретный ключ клиента) – криптоключ OAuth;
   • OneRoster Base URL (Базовый URL OneRoster) – URL хоста.

Куда обратиться, если возникли проблемы с настройкой Infinite Campus:

• Поддержка Campus без авторизации
• Поддержка Campus для авторизованных пользователей

Шаг 1. Укажите Google в качестве поставщика в OneRoster и получите учетные данные OAuth

1. На странице настроек в Skyward в разделе System (Система) выберите Product Setup (Настройка продукта) Contact Access (Передача доступа).
2. В разделе Security (Безопасность) найдите подгруппу Users (Пользователи) и выберите Secured User (Защищенный пользователь) Add (Добавить).
3. В разделе Add Secured User (Добавление защищенного пользователя) выберите тип имени для поставщиков введите имя для Google. Для примера предположим, что вы ввели название "Google".

Совет. Запишите это название для использования на следующем шаге.

4. Нажмите Add Entered Name to Secured Users (Добавить указанное имя в список защищенных пользователей).
5. В разделе Security Information (Сведения о безопасности) выберите Account Information (Информация об аккаунте). Значением для ключа API будет GOOGLE.
6. Нажмите Save (Сохранить).
7. В списке Secured Users List (Список защищенных пользователей) найдите имя, которое вы указали на шаге 3 выше:
   • Убедитесь, что это имя обозначено как активный защищенный пользователь: рядом с ним будет символ "Y".
   • В правом нижнем углу нажмите API.
8. В окне API Access (Доступ API) нажмите Generate a New Secret (Сгенерировать новый секретный ключ). Запишите значение ключа доступа и секретного ключа. Эти данные, а также URL API необходимы для подключения к Классу.
9. Когда секретный ключ будет сгенерирован, вернитесь на страницу настроек Skyward, перейдите в раздел Product Setup (Настройка продукта) Contact Access (Передача доступа) District Setup (Настройка округа) Configuration (Конфигурация) выберите API Configuration (Конфигурация API).
10. Запишите значения полей Application URL (URL приложения) и Authentication URL (URL аутентификации). Эта информация является уникальной для вашего школьного округа. Если поле Application URL не заполнено, обратитесь в службу поддержки Skyward.

Примечание. URL OneRoster API – это URL приложения (уникальный для вашего школьного округа), совмещенный с конечной точкой OneRoster (которая всегда имеет значение /ims/oneroster/v1p1/). Например:

Пример URL приложения	https://esdemo1.skyward.com
Официальная конечная точка OneRoster	/ims/oneroster/v1p1/
Пример URL OneRoster API	https://esdemo1.skyward.com/api/ims/oneroster/v1p1/

11. В разделе OneRoster API Line Item Configuration (Настройка объектов OneRoster API) для параметра Default Category (Категория по умолчанию) выберите Assignments (Задания) или другой вариант.
    Примечание. Параметр Default Category автоматически заполняется в журнале успеваемости Skyward для заданий, экспортированных из Класса. Если этого параметра нет в списке, обратитесь в службу поддержки Skyward.
12. Запишите значения следующих учетных данных OAuth для Класса:
    • Key (ключ доступа)
    • Secret (секретный ключ)
    • OneRoster API URL (URL хоста)
13. Нажмите Save (Сохранить).

Требования

Класс можно подключить к Skyward Qmlativ, если:

• в вашем школьном округе используется Skyward Qmlativ с лицензией OneRoster® API;
• вы используете решение SaaS, которое полностью размещается и управляется на стороне Skyward;
• в вашем школьном округе для Skyward Qmlativ используется ваш собственный хостинг.

С этой СИУ также могут работать клиенты, которые хранят свои данные локально или на хостинге сервиса, но тогда Google не будет предоставлять поддержку.

Если вам потребуется помощь с первоначальной настройкой системы на портале Skyward, обратитесь в службу поддержки клиентов Skyward.

Шаг 1. Настройте доступ для интеграции Google и получите учетные данные OAuth

1. Настройте поставщика в OneRoster:
   1. В меню Skyward Qmlativ выберите Administrative Access (Доступ с правами администратора) API.
   2. Нажмите Vendor (Поставщик).
   3. В списке выберите "Google".
      • Если варианта "Google" нет в списке:
        1. Нажмите Add OneRoster Vendor (Добавить поставщика в OneRoster).
        2. Введите Google.
   4. Нажмите Save (Сохранить).
2. Настройте конфигурацию OneRoster:
   1. В меню Skyward Qmlativ выберите Administrative Access (Доступ с правами администратора) API.
   2. Нажмите OneRoster Configuration (Конфигурация OneRoster).
   3. Найдите строку с кодом "GGLCL" и поставщиком "Google".
      • Если вам не удалось найти GGLCL:
        1. Нажмите Add OneRoster Configuration (Добавить конфигурацию OneRoster).
        2. В разделе Add OneRoster Configuration (Добавить конфигурацию OneRoster) добавьте поставщика: Google.
        3. В поле Code (Код) введите GGLCL.
        4. В поле Description (Описание) введите Google Classroom.
        5. В разделе District (Округ) выберите свой округ.
        6. Установите флажок Allow Grade Pass Back (Разрешить синхронизацию оценок).
           • Если для синхронизации оценок у вас настроена категория по умолчанию (Default Category), вы можете выбрать ее из списка.
   4. Нажмите Save (Сохранить).
3. Настройте Integration Access (Доступ для интеграции) и сгенерируйте секретный ключ:
   1. В меню Skyward Qmlativ выберите Administrative Access (Доступ с правами администратора) API Integration (Интеграция).
   2. Найдите строку, в которой Google Dev Team – это название поставщика, а Google Classroom – название продукта.
   3. Чтобы найти интеграцию, нажмите Open (Открыть) Integration Accesses (Доступы для интеграций).
   4. Нажмите Add Integration Access (Добавить доступ для интеграции).
   5. Введите необходимые данные для интеграции:
      1. В поле Name (Название) введите название, например "Google Класс".
      2. В поле Key (Ключ) введите GOOGLE.
      3. В поле Authentication Type (Тип аутентификации) выберите OA2 – OAuth 2.0.
      4. Установите флажок Is Active (Активен).
      5. В пункте Effective Date (Начало срока действия) укажите, с какого дня должен действовать доступ.
         • Оставьте дату по умолчанию, если хотите, чтобы доступ был предоставлен с сегодняшнего дня.
      6. В пункте Expiration Date (Окончание срока действия) укажите, до какого числа будет открыт доступ. Период доступа, который подставляется по умолчанию, – один год, но вы можете его изменить, выбрав другие даты.
         • Для обеспечения безопасности Skyward рекомендует открывать доступ для интеграций ежегодно на весь учебный год. Чтобы не возникало перебоев, можно сразу задать несколько периодов доступа так, чтобы дата начала каждого нового периода наступала чуть раньше даты окончания предыдущего. Для каждого периода будут действовать разные ключи доступа и секретные ключи.
      7. В разделе Configuration (Конфигурация) найдите список OneRoster Configuration (Конфигурация OneRoster).
      8. Выберите код GGLCL и поставщика Google.
      9. Нажмите Save (Сохранить).
      10. В окне Review Results (Просмотр результатов) убедитесь, что для Successful Record (Успешная запись) указано "1".
      11. Нажмите Generate Secret (Сгенерировать секретный ключ).
      12. Чтобы скопировать ключ доступа для интеграции и секретный ключ в буфер обмена, нажмите Copy (Копировать).
          • Сохраните эти данные у себя, так как после настройки их нельзя будет посмотреть или восстановить. Однако у вас останется возможность сгенерировать новый секретный ключ, который заменит собой старый.
      13. Нажмите Run Process (Запустить процесс) Close (Закрыть).
4. Сгенерируйте секретный ключ:
   1. В меню Skyward Qmlativ выберите Administrative Access (Доступ с правами администратора) API.
   2. Нажмите Integration (Интеграция).
   3. Найдите строку, в которой "Google Dev Team" – это название поставщика, а "Google Classroom" – название продукта.
   4. Чтобы найти интеграцию, нажмите Open (Открыть) Integration Accesses (Доступы для интеграций).
   5. Выберите доступ, для которого нужно сгенерировать секретный ключ.
   6. Нажмите на кнопку меню со стрелкой Generate Secret (Сгенерировать секретный ключ).
   7. Чтобы скопировать ключ доступа для интеграции и секретный ключ в буфер обмена, в окне генерирования ключа нажмите Copy (Копировать).
      • Сохраните эти данные у себя, так как после настройки их нельзя будет посмотреть или восстановить. Однако у вас останется возможность сгенерировать новый секретный ключ, который заменит собой старый.
   8. Нажмите Run Process (Запустить процесс) Close (Закрыть).

Примечание. URL OneRoster® API – это уникальный для вашего округа URL приложения с "API" на конце, совмещенный с конечной точкой OneRoster® (которая всегда имеет значение /ims/oneroster/v1p1/). Например:

Пример URL приложения	https://demo.skyward.com/demo
Пример URL API	https://demo.skyward.com/demoAPI
Официальная конечная точка OneRoster®	/ims/oneroster/v1p1/
Пример URL OneRoster® API	https://demo.skyward.com/demoapi/ims/oneroster/v1p1/

Шаг 2. Подключите Класс

1. Перейдите на страницу classroom.google.com/admin.
2. Рядом с пунктом "Выберите систему информации об учащихся" нажмите на стрелку вниз .
3. Выберите систему информации об учащихся.
4. Нажмите Подключить к Google.

   

5. В разделе "Настройка системы информации об учащихся" нажмите Подключить.
6. Введите данные OAuth, записанные на шаге 1:
   • URL хоста;
   • ключ доступа;
   • секретный ключ.

   

7. Чтобы разрешить Google передавать ваше доменное имя поставщику СИУ, установите флажок "Включите поддержку СИУ".
   • Когда этот параметр включен, поставщик СИУ получает информацию о доменном имени организации, чтобы диагностировать сбои и устранять системные ошибки.
8. Нажмите Authorize (Авторизовать).
   • Если появится ошибка, обновите страницу.

Если вы включите поддержку, Google сможет передавать ваше доменное имя поставщику СИУ, чтобы диагностировать сбои и устранять системные ошибки.

1. Перейдите на страницу classroom.google.com/admin.
2. Установите флажок "Включите поддержку СИУ".
   • Настройка автоматически сохранится и ее можно в любой момент изменить.

После того как вы отключите Класс от СИУ, преподаватели не смогут пользоваться функциями интеграции. Экспортированные ранее данные будут сохранены, но не будут обновляться. Если позже вы снова подключите Класс к СИУ, оценки в ней могут оказаться продублированы.