Регистрация системы управления обучением в 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.

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

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

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

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

       **Щелкните значок "плюс**" на [странице "Мое приложение](https://developer.anthology.com/portal/applications)".

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

Поле в новой конфигурации приложения Значение или параметр
```
 **Имя приложения** | `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".
Введите следующие значения в полях.

Поле в конфигурации приложения 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 |
После отправки Sakai отобразит сведения, необходимые для регистрации экземпляра Sakai с помощью GitHub Classroom.

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

Переход к https://classroom.github.com/register-lms.
Введите следующие данные:
- В разделе "Тип 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
Щелкните Зарегистрировать.
Вы увидите баннер "Успешно зарегистрированный LMS" в верхней части экрана, что означает, что вы зарегистрировали экземпляр LMS и преподаватели теперь могут связать свои классы.