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

Вы можете настроить систему управления обучением, совместимую с LTI (LMS), с помощью GitHub Classroom.

Кто может использовать эту функцию?

Organization owners who are admins for a classroom can connect learning management systems to 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.

  • Blackboard (это поддерживаемый сообществом вариант)
  • Холст
  • Moodle
  • Sakai.
  • Google Classroom;

Примечание.

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

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

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

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

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

  1. Войдите на портал разработчика Anthology.

  2. Щелкните значок "плюс" на странице "Мое приложение".

  3. Щелкните "Регистрация вручную " в раскрывающемся меню.

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

    Поле в новой конфигурации приложенияЗначение или параметр

Имя приложения | 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 | | Настраиваемые параметры | Оставьте пустым. |

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

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

  3. В таблице на странице "Мои приложения" в строке приложения GitHub Classroom щелкните три точки и выберите пункты "Управление размещением " в раскрывающемся меню.

  4. Щелкните знак** плюса**.

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

    Поле в новой конфигурации размещенияЗначение или параметр

Имя размещения | GitHub Classroom

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

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

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

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

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

  1. Переход к https://classroom.github.com/register-lms.

  2. Введите следующие данные:

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

  3. Щелкните Зарегистрировать.

  4. Вы увидите баннер "Успешно зарегистрированный LMS" в верхней части экрана, что означает, что вы зарегистрировали экземпляр LMS и преподаватели теперь могут связать свои классы.

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

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

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

  1. Войдите в Canvas.

  2. На левой боковой панели на домашней странице щелкните "Администратор **", а затем щелкните **"Администратор сайта".

  3. Щелкните ключи разработчика.

  4. В разделе "Ключи разработчика" нажмите кнопку +Ключ разработчика, а затем в раскрывающемся меню выберите +LTI Key .

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

    Поле в конфигурации приложения 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.

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

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

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

  1. Переход к https://classroom.github.com/register-lms.

  2. Введите следующие данные:

    • В разделе "Тип 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 добавленный в конце.

  3. Щелкните Зарегистрировать.

  4. Вы увидите баннер "Успешно зарегистрированный LMS" в верхней части экрана, что означает, что вы зарегистрировали экземпляр LMS и преподаватели теперь могут связать свои классы.

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

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

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

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

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

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

  1. Вернитесь на страницу Moodle "Администрирование сайта", щелкнув вкладку "Администрирование сайта" в меню верхнего уровня.

  2. Перейдите на вкладку "Подключаемые модули", а затем рядом с разделом "Модули действий" в разделе "Внешний инструмент" нажмите кнопку "Управление инструментами".

  3. Нажмите кнопку " Настройка средства" вручную.

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

    Поле в конфигурации приложения 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 |

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

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

  1. Переход к https://classroom.github.com/register-lms.

  2. Введите следующие данные:

    • В разделе "Тип LMS" выберите "Moodle" в раскрывающемся меню.
    • "Идентификатор издателя": идентификатор платформы из списка "Сведения о конфигурации инструмента" внешнего инструмента, созданного в Moodle
    • "Домен": базовый URL-адрес экземпляра Moodle
    • "Идентификатор клиента": "Идентификатор клиента" из списка "Сведения о конфигурации средства" внешнего инструмента, созданного в Moodle
    • "URL-адрес запроса проверки подлинности": "URL-адрес запроса проверки подлинности" из "Сведения о конфигурации средства" внешнего инструмента, созданного в Moodle
    • "URL-адрес маркера доступа": "URL-адрес маркера доступа" из списка "Сведения о конфигурации средства" внешнего инструмента, созданного в Moodle
    • "URL-адрес набора ключей": "URL-адрес открытого набора ключей" из раздела "Сведения о конфигурации инструмента" внешнего инструмента, созданного в Moodle

  3. Щелкните Зарегистрировать.

  4. Вы увидите баннер "Успешно зарегистрированный LMS" в верхней части экрана, что означает, что вы зарегистрировали экземпляр LMS и преподаватели теперь могут связать свои классы.

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

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

  1. Перейдите к Сакаи и войдите в систему.

  2. Перейдите в раздел "Администрирование рабочей области" и выберите внешние инструменты на левой боковой панели.

  3. Нажмите кнопку "Установить LTI 1.x Tool".

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

    Поле в конфигурации приложения SakaiЗначение или параметр

Имя средства | Класс GitHub — [имя курса]

Примечание. Вы можете использовать любое имя, но если вы настроите это на что-то другое, убедитесь, что это сообщается учителям. | | Текст кнопки (текст в меню инструментов) | Что учитель увидит на кнопке, чтобы запустить GitHub Classroom. Например, значение может быть sync. | | URL-адрес запуска | https://classroom.github.com/context-link | | Отправка имен пользователей во внешнее средство | Установите этот флажок. | | Предоставление списка внешним инструментам | Установите этот флажок. | | Средство поддерживает LTI 1.3 | Установите этот флажок. | | URL-адрес набора ключей средства LTI 1.3 | https://classroom.github.com/.well-known/jwks.json | | Конечная точка OpenID Connect/Initialization средства LTI 1.3 | https://classroom.github.com/lti1p3/openid-connect/auth | | Конечная точка перенаправления средства LTI 1.3 | https://classroom.github.com/lti1p3/openid-connect/redirect |

  1. После отправки Sakai отобразит сведения, необходимые для регистрации экземпляра Sakai с помощью GitHub Classroom.

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

  1. Переход к https://classroom.github.com/register-lms.

  2. Введите следующие данные:

    • В разделе "Тип LMS" выберите "Sakai" в раскрывающемся меню.
    • "Издатель платформы LTI 1.3": поле "Издатель платформы LTI 1.3", предоставленное Sakai
    • "Домен": базовый URL-адрес экземпляра Sakai
    • "Идентификатор клиента LTI 1.3": поле "Идентификатор клиента LTI 1.3", предоставленное Sakai
    • "URL-адрес проверки подлинности платформы OIDC": поле "URL-адрес проверки подлинности платформы OIDC" lTI 1.3, предоставленное Sakai
    • "LTI 1.3 Platform OAuth2 Bearer Token Retrieval URL": поле "LTI 1.3 Platform OAuth2 Bearer Token Retrieval URL", как указано Sakai
    • "LTI 1.3 Platform OAuth2 Well-Known/KeySet URL": поле "LTI 1.3 Platform OAuth2 Well-Known/KeySet URL", предоставленное Sakai

  3. Щелкните Зарегистрировать.

  4. Вы увидите баннер "Успешно зарегистрированный LMS" в верхней части экрана, что означает, что вы зарегистрировали экземпляр LMS и преподаватели теперь могут связать свои классы.