Регистрация системы управления обучением в GitHub Classroom

Регистрация LMS в аудитории

Прежде чем подключить LMS к аудитории, администратор экземпляра LMS должен настроить LMS, чтобы разрешить GitHub Classroom и зарегистрировать LMS с помощью GitHub Classroom для запуска подтверждения OAuth. Администратор должен выполнять этот процесс регистрации только один раз, а затем любой учитель, использующий экземпляр LMS, может синхронизировать курсы LMS с аудиториями. Дополнительные сведения о подключении курса LMS к аудитории см. в разделе Подключение курса системы управления обучением к аудитории.

Примечание.

Google Classroom не использует протокол LTI, поэтому не нужно подключаться к GitHub Classroom перед импортом списка. Дополнительные сведения см. в разделе Подключение курса системы управления обучением к аудитории.

Поддерживаемые системы управления обучением

GitHub Classroom поддерживает подключение к LMSes, реализующим стандарты взаимодействия средств обучения (LTI).

LTI версии 1.3
Преимущество LTI

Использование LTI помогает обеспечить безопасность информации. LTI — это протокол, который является стандартом в отрасли, и использование GItHub Classroom LTI сертифицировано Instructional Management System (IMS) Global Learning Consortium. Дополнительные сведения можно найти на страницах Взаимодействие средств обучения и Сведения о IMS Global Learning Consortium на веб-сайте IMS Global Learning Consortium.

GitHub проверил и проверил регистрацию, подключение и импорт данных реестра из следующих LMSes в GitHub Classroom.

Холст
Moodle
Sakai.
Google Classroom;

Примечание.

Другие LMSes, реализующие LTI 1.3, также могут работать с GitHub Classroom, но еще не проверены. Администраторам LMS может потребоваться настроить пользовательские параметры для размещения конфиденциальности и кнопки и предоставить преподавателям документацию о том, как запустить GitHub Classroom из LMS.

Настройка Blackboard для GitHub Classroom

Вы можете зарегистрировать установку Blackboard с помощью GitHub Classroom, чтобы преподаватели могли импортировать данные списка в свои аудитории. Дополнительные сведения о Blackboard см. на веб-сайте Blackboard.

Шаг 1. Регистрация ключей разработчика GitHub Classroom на портале разработчика Anthology

Войдите на портал разработчика Anthology.
Щелкните значок "плюс" на странице "Мое приложение".
Щелкните "Регистрация вручную " в раскрывающемся меню.

На экране конфигурации "Регистрация нового приложения" задайте поля следующим значениям.

Поле в новой конфигурации приложения	Значение или параметр
Имя приложения	`GitHub Classroom` Вы можете использовать любое имя, оно будет отображаться только администраторам.
Description	`Sync Blackboard course roster to GitHub Classroom` (или что-то подобное)
Домены	`classroom.github.com`
Групповое	Оставьте значение по умолчанию или измените его в соответствии с потребностями вашего учреждения.
Моя интеграция поддерживает LTI 1.3	Включите флаг.
URL-адрес запуска входа	`https://classroom.github.com/lti1p3/openid-connect/auth`
URL-адреса перенаправления инструментов	`https://classroom.github.com/lti1p3/openid-connect/redirect,https://classroom.github.com/context-link`
URL-адрес JWKS средства	`https://classroom.github.com/.well-known/jwks.json`
Раскрывающийся список алгоритма подписывания	`RS256`
Настраиваемые параметры	Оставьте пустым.

Нажмите кнопку " Зарегистрировать приложение".
На портале разработчика отобразится экран, содержащий важные сведения, которые необходимо ввести в следующих шагах регистрации экземпляра в экземпляре Blackboard и в GitHub Classroom ниже. Запишите их в безопасном месте и нажмите кнопку "Готово".
В таблице на странице "Мои приложения" в строке приложения GitHub Classroom щелкните три точки и выберите пункты "Управление размещением " в раскрывающемся меню.
Щелкните знак** плюса**.

На экране конфигурации "Регистрация нового размещения" задайте поля следующим значениям.

Поле в новой конфигурации размещения	Значение или параметр
Имя размещения	`GitHub Classroom` Вы можете использовать любое имя, но если вы настроите это на что-то другое, убедитесь, что это сообщается учителям.
Description	`Sync Blackboard course roster to GitHub Classroom` (или что-то подобное)
Раскрывающийся список типов	Средство курса
Разрешить учащимся доступ	Не включите флаг.
Запуск в новом окне	Не включите флаг, если вы не хотите предлагать этот пользовательский интерфейс.
URI целевой ссылки	`https://classroom.github.com/context-link`
URL-адрес значка	Оставьте его пустым или укажите статический URL-адрес значка. При необходимости позже в Blackboard можно отправить вручную.
Настраиваемые параметры	Оставьте пустым.

Нажмите кнопку "Зарегистрировать размещение".

Шаг 2. Регистрация ключей разработчика GitHub Classroom в Blackboard

Войдите в экземпляр Blackboard .
На левой боковой панели на домашней странице щелкните "Администратор **", а затем щелкните **"Поставщики инструментов LTI".
На странице "Поставщики инструментов LTI" нажмите кнопку Register LTI 1.3/Advantage Tool.
Вставьте идентификатор приложения идентификатора**** / клиента, полученный на портале разработчика, и нажмите кнопку "Отправить".
В черной доске будут отображаться все данные приложения. На этой странице:
1. Убедитесь, что состояние инструмента имеет значение Approved.
2. Убедитесь, что поля пользователей, отправляемые флаги, включены для параметра "Роль в курсе", "Имя", "Адрес электронной почты".
3. Убедитесь, что переключатель "Разрешить доступ к службе меток" имеет значение "Нет". Чтобы включить этот параметр, перейдите к поставщикам средств LTI на панели администрирования:
  - Выбор "Управление глобальными свойствами"
  - В разделе "Создание ссылок поставщика инструментов" выберите переключатель "Разрешить ссылки на любой поставщик инструментов, но требуется утверждение для каждого нового поставщика".
4. Убедитесь, что переключатель "Разрешить доступ к службе членства" имеет значение "Да".
Щелкните Отправить.

Шаг 3. Регистрация ключей разработчика с помощью GitHub Classroom

Переход к https://classroom.github.com/register-lms.
Введите следующие данные:
- В разделе "Тип LMS" выберите "Другое" в раскрывающемся меню.
- "Идентификатор издателя": https://blackboard.com
- "Домен": базовый URL-адрес экземпляра Blackboard
- "Идентификатор клиента": идентификатор клиента / "Идентификатор приложения", полученный из регистрации приложения на портале разработчика Anthology.
- "URL-адрес запуска OIDC": КОНЕЧНая точка запроса проверки подлинности OIDC, полученная из регистрации приложения на портале разработчика Anthology.
- "URL-адрес извлечения маркеров OAuth 2.0": "Конечная точка маркера проверки подлинности", полученная из регистрации приложения на портале разработчика anthology.
- "URL-адрес набора ключей": URL-адрес открытого набора ключей, полученный из регистрации приложения на портале разработчика Anthology.
Щелкните Зарегистрировать.
Вы увидите баннер "Успешно зарегистрированный LMS" в верхней части экрана, что означает, что вы зарегистрировали экземпляр LMS и преподаватели теперь могут связать свои классы.

Настройка Холста для GitHub Classroom

Вы можете зарегистрировать установку Холста с помощью GitHub Classroom, чтобы преподаватели могли импортировать данные реестра в свои классы. Дополнительные сведения о Canvas см. на веб-сайте Canvas.

1. Регистрация ключей разработчика GitHub Classroom на холсте

Войдите в Canvas.
На левой боковой панели на домашней странице щелкните "Администратор **", а затем щелкните **"Администратор сайта".
Щелкните ключи разработчика.
В разделе "Ключи разработчика" нажмите кнопку +Ключ разработчика, а затем в раскрывающемся меню выберите +LTI Key .

На экране конфигурации "Параметры ключа" задайте поля следующим значениям.

Поле в конфигурации приложения Canvas	Значение или параметр
Method	`Manual Entry`
Заголовок	`GitHub Classroom` Примечание. Вы можете использовать любое имя, но если вы настроите это на что-то другое, убедитесь, что это сообщается учителям.
Description	`Sync Canvas course rosters to GitHub Classroom` (или что-то подобное)
URI целевой ссылки	`https://classroom.github.com/context-link`
URL-адрес запуска OpenID Connect	`https://classroom.github.com/lti1p3/openid-connect/auth`
Метод JWK	`Public JWK URL`
Общедоступный URL-адрес JWK	`https://classroom.github.com/.well-known/jwks.json`
URI перенаправления	`https://classroom.github.com/lti1p3/openid-connect/redirect`
Раскрывающийся список служб преимущества LTI	Установите флажок "Может получить данные пользователя, связанные с контекстом, в котором установлено средство".
Раскрывающийся список дополнительных параметров	В разделе "Уровень конфиденциальности" выберите `Public`
Размещения	Выберите `Course Settings Sub Navigation`. Примечание. Если вы устанавливаете размещение на что-то другое, это должно быть передано учителям. Наша документация ожидает, что это размещение кнопки.

Нажмите кнопку Сохранить.
В таблице на странице "Ключи разработчика" в строке ключа разработчика GitHub Classroom обратите внимание на значение идентификатора клиента в столбце "Сведения" — это должно быть передано преподавателям, чтобы завершить настройку.
В таблице на странице "Ключи разработчика" в столбце "Состояние" переключите состояние ключа на "Вкл".

2. Регистрация ключей разработчика с помощью GitHub Classroom

Переход к https://classroom.github.com/register-lms.
Введите следующие данные:
- В разделе "Тип LMS" выберите "Canvas" в раскрывающемся меню.
- "Идентификатор издателя": https://canvas.instructure.com
- "Домен": базовый URL-адрес экземпляра Canvas
- "Идентификатор клиента": идентификатор клиента в разделе "Сведения" из созданного ключа разработчика
- "OIDC Authorization end-point": базовый URL-адрес экземпляра Canvas с /api/lti/authorize_redirect добавленным в конце.
- "URL-адрес извлечения маркера OAuth 2.0": базовый URL-адрес экземпляра Холста, /login/oauth2/token добавленный в конце.
- "URL-адрес набора ключей": базовый URL-адрес экземпляра Canvas, /api/lti/security/jwks добавленный в конце.
Щелкните Зарегистрировать.
Вы увидите баннер "Успешно зарегистрированный LMS" в верхней части экрана, что означает, что вы зарегистрировали экземпляр LMS и преподаватели теперь могут связать свои классы.

Настройка Moodle для GitHub Classroom

Вы можете зарегистрировать установку Moodle с помощью GitHub Classroom, чтобы преподаватели могли импортировать данные списка в свои аудитории. Дополнительные сведения о Moodle см. на веб-сайте Moodle.

Необходимо использовать Moodle версии 3.0 или более поздней.

1. Включение публикации в качестве инструмента LTI в Moodle

Войдите в Moodle.
Перейдите на вкладку "Администрирование сайта" в меню верхнего уровня.
На странице "Администрирование сайта" перейдите на вкладку "Подключаемые модули", а затем прокрутите вниз до раздела "Проверка подлинности" и нажмите кнопку "Управление проверкой подлинности".
Рядом с полем "LTI" нажмите кнопку переключателя, чтобы включить LTI.
Снова щелкните вкладку "Подключаемые модули", а затем прокрутите вниз до пункта "Регистрация" и нажмите кнопку "Управление подключаемыми модулями для регистрации".
Рядом с полем "Публикация как средство LTI" нажмите кнопку переключателя, чтобы включить публикацию в качестве инструмента LTI.
Вернитесь на страницу "Администрирование сайта", щелкнув вкладку "Администрирование сайта" в меню верхнего уровня, а затем прокрутите вниз до раздела "Безопасность" и щелкните HTTP Security.
Рядом с параметром "Разрешить внедрение кадров", установите флажок, чтобы включить внедрение кадров, а затем нажмите кнопку "Сохранить изменения".

2. Регистрация GitHub Classroom в качестве внешнего средства

Вернитесь на страницу Moodle "Администрирование сайта", щелкнув вкладку "Администрирование сайта" в меню верхнего уровня.
Перейдите на вкладку "Подключаемые модули", а затем рядом с разделом "Модули действий" в разделе "Внешний инструмент" нажмите кнопку "Управление инструментами".
Нажмите кнопку " Настройка средства" вручную.

Введите следующие значения в полях.

Поле в конфигурации приложения Moodle	Значение или параметр
Имя средства	`GitHub Classroom` Примечание. Вы можете использовать любое имя, но если вы настроите это на что-то другое, убедитесь, что это сообщается учителям.
URL-адрес средства	`https://classroom.github.com`
Версия LTI	`LTI 1.3`
Тип открытого ключа	`Keyset URL`
Открытый набор ключей	`https://classroom.github.com/.well-known/jwks.json`
Инициирование URL-адреса входа	`https://classroom.github.com/lti1p3/openid-connect/auth`
URI перенаправления	`https://classroom.github.com/lti1p3/openid-connect/redirect`
Контейнер запуска по умолчанию	`New window`

Установите флажок "Поддержка глубокого связывания" (сообщение о содержимом- элементе).
В раскрывающемся списке "Службы" рядом с "Имена LTI IMS и подготовка ролей" выберите "Использовать эту службу для получения сведений о членах в соответствии с параметрами конфиденциальности" в раскрывающемся меню.
В раскрывающемся списке "Конфиденциальность" задайте для параметра "Имя средства запуска share" значение Always и задайте для параметра "Отправить сообщение электронной почты средства с помощью средства" значение Always.
Нажмите кнопку Сохранить изменения.
Класс GitHub теперь зарегистрирован как внешний инструмент. В разделе "Сервис" в поле "Аудитория GitHub" щелкните значок меню, чтобы просмотреть экран "Сведения о конфигурации средства". На этом экране содержатся важные сведения, которые необходимо ввести на последнем шаге регистрации экземпляра в GitHub Classroom ниже.

3. Регистрация экземпляра Moodle с помощью GitHub Classroom

Переход к https://classroom.github.com/register-lms.
Введите следующие данные:
- В разделе "Тип LMS" выберите "Moodle" в раскрывающемся меню.
- "Идентификатор издателя": идентификатор платформы из списка "Сведения о конфигурации инструмента" внешнего инструмента, созданного в Moodle
- "Домен": базовый URL-адрес экземпляра Moodle
- "Идентификатор клиента": "Идентификатор клиента" из списка "Сведения о конфигурации средства" внешнего инструмента, созданного в Moodle
- "URL-адрес запроса проверки подлинности": "URL-адрес запроса проверки подлинности" из "Сведения о конфигурации средства" внешнего инструмента, созданного в Moodle
- "URL-адрес маркера доступа": "URL-адрес маркера доступа" из списка "Сведения о конфигурации средства" внешнего инструмента, созданного в Moodle
- "URL-адрес набора ключей": "URL-адрес открытого набора ключей" из раздела "Сведения о конфигурации инструмента" внешнего инструмента, созданного в Moodle
Щелкните Зарегистрировать.
Вы увидите баннер "Успешно зарегистрированный LMS" в верхней части экрана, что означает, что вы зарегистрировали экземпляр LMS и преподаватели теперь могут связать свои классы.

Настройка Sakai для GitHub Classroom

1. Регистрация GitHub Classroom в качестве внешнего средства

Перейдите к Сакаи и войдите в систему.
Перейдите в раздел "Администрирование рабочей области" и выберите внешние инструменты на левой боковой панели.
Нажмите кнопку "Установить LTI 1.x Tool".