Registrar o sistema de gerenciamento de aprendizagem no GitHub Classroom

Como registrar um LMS na sala de aula

Para conectar o LMS a uma sala de aula, um administrador da instância do LMS precisa configurá-lo para permitir o GitHub Classroom e depois registrar o LMS no GitHub Classroom para iniciar o handshake OAuth. O administrador só precisa fazer esse processo de registro uma vez, depois, qualquer professor que usar a instância do LMS poderá sincronizar os cursos do LMS com as salas de aula. Para obter mais informações de como conectar um curso do LMS a uma sala de aula, confira "Conectar um curso do sistema de gerenciamento de aprendizagem a uma sala de aula".

Observação: O Google Sala de aula não usa o protocolo LTI, portanto, não precisa estar conectado ao GitHub Classroom antes de importar a lista de participantes. Para obter mais informações, confira "Como importar uma lista de participantes do Google Sala de aula".

LMSes compatíveis

O GitHub Classroom dá suporte para conexão com LMSs que implementam os padrões de LTI (interoperabilidade entre ferramentas de aprendizagem).

LTI versão 1.3
Vantagem do LTI

Usar o LTI ajuda a manter suas informações protegidas e seguras. O LTI é um protocolo padrão do setor e o uso do LTI pelo GitHub Classroom é certificado pelo Sistema de Gerenciamento de Instruções (IMS) Global de Aprendizagem. Para obter mais informações, confira Learning Tools Interoperability e Sobre o IMS Global Learning Consortium no site do IMS Global Learning Consortium.

O GitHub testou e verificou o registro, a conexão e a importação dos dados da lista de participantes do curso dos LMSs a seguir no GitHub Classroom.

Tela
Moodle
Sakai
Google Classroom

Observação: outros LMSs que implementam o LTI 1.3 também podem funcionar com o GitHub Classroom, mas ainda não foram verificados. Os administradores do LMS podem precisar definir configurações personalizadas em relação à privacidade e ao posicionamento de botões e fornecer aos professores uma documentação que mostre como iniciar o GitHub Classroom por meio do LMS.

O Google Sala de aula não usa o protocolo LTI, portanto, não precisa estar conectado ao GitHub Classroom antes de importar a lista de participantes. Para obter mais informações, confira "Como importar uma lista de participantes do Google Sala de aula".

Como configurar o Canvas para o GitHub Classroom

Você pode registrar a instalação do Canvas no GitHub Classroom para permitir que os professores importem dados da lista de participantes do curso para as salas de aula. Para obter mais informações sobre o Canvas, acesse o site do Canvas.

1. Registrar as chaves do desenvolvedor do GitHub Classroom no Canvas

Entre no Canvas.
Na barra lateral esquerda na home page, clique em Administração e depois em Administrador do Site.
Clique em Chaves do Desenvolvedor.
Em "Chaves do Desenvolvedor", clique no botão + Chave do Desenvolvedor e selecione + Chave de LTI no menu suspenso.

Na tela de configuração "Configurações de Chave", defina os campos com os seguintes valores:

Campo na configuração do aplicativo Canvas	Valor ou configuração
Método	`Manual Entry`
Título	`GitHub Classroom` Observação: você pode usar qualquer nome, mas ao definir um nome diferente, comunique isso aos professores.
Descrição	`Sync Canvas course rosters to GitHub Classroom` (ou algo semelhante)
URI do link de destino	`https://classroom.github.com/context-link`
URL de iniciação do OpenID Connect	`https://classroom.github.com/lti1p3/openid-connect/auth`
Método JWK	`Public JWK URL`
URL JWK pública	`https://classroom.github.com/.well-known/jwks.json`
URIs de redirecionamento	`https://classroom.github.com/lti1p3/openid-connect/redirect`
Lista suspensa Serviços avançados de LTI	Marque a caixa de seleção "Pode recuperar dados do usuário associados ao contexto em que a ferramenta está instalada".
Lista suspensa Configurações Adicionais	Em "Nível de Privacidade", selecione `Public`
Posicionamentos	Selecione `Course Settings Sub Navigation`. Observação: se você definir o posicionamento como outra coisa, comunique isso aos professores. A documentação considera que esse seja o posicionamento do botão.

Clique em Save (Salvar).
Na tabela da página "Chaves do Desenvolvedor", na linha da chave do desenvolvedor do GitHub Classroom, anote o valor da ID do cliente na coluna "Detalhes", que precisa ser comunicado aos professores para que eles concluam a configuração.
Na tabela na página "Chaves do Desenvolvedor", na coluna "Estado", alterne o estado da chave para "Ativado".

2. Registrar as chaves do desenvolvedor no GitHub Classroom

Ir para https://classroom.github.com/register-lms.
Preencha as seguintes informações:
- Em "Tipo de LMS", escolha "Canvas" no menu suspenso.
- "Identificador do emissor": https://canvas.instructure.com
- "Domínio": a URL base da instância do Canvas
- "ID do cliente": a "ID do cliente" em "Detalhes" da chave do desenvolvedor que você criou
- "Ponto de extremidade de autorização OIDC": a URL base da instância do Canvas com /api/lti/authorize_redirect acrescentado no final.
- "URL de recuperação de token OAuth 2.0": a URL base da instância do Canvas com /login/oauth2/token acrescentado no final.
- "URL de definição da chave": a URL base da instância do Canvas com /api/lti/security/jwks acrescentado no final.
Clique em Registrar.
Você verá a faixa "LMS registrado com êxito" na parte superior da tela, o que significa que você registrou a instância do LMS e que os professores agora podem vincular as salas de aula.

Como configurar o Moodle para o GitHub Classroom

Você pode registrar a instalação do Moodle no GitHub Classroom para permitir que os professores importem dados da lista de participantes do curso para as salas de aula. Para obter mais informações sobre o Moodle, confira o site do Moodle.

Você deve usar a versão 3.0 ou superior do Moodle.

1. Habilitar a publicação como uma ferramenta de LTI no Moodle

Entre no Moodle.
Clique na guia "Administração do site" no menu de nível superior.
Na página "Administração do site", clique na guia "Plug-ins", role para baixo até a seção "Autenticação" e clique em Gerenciar autenticação.
Ao lado do campo "LTI", clique no botão de alternância para habilitar LTI.
Clique na guia "Plug-ins" novamente, role para baixo até "Inscrições" e clique em Gerenciar plug-ins de inscrição.
Ao lado do campo "Publicar como ferramenta de LTI", clique no botão de alternância para habilitar a publicação como uma ferramenta de LTI.
Retorne à página "Administração do site" clicando na guia "Administração do site" no menu de nível superior, role para baixo até a seção "Segurança" e clique em Segurança HTTP.
Ao lado de "Permitir inserção de quadros", marque a caixa de seleção para habilitar a inserção de quadros e clique em Salvar alterações.

2. Registrar o GitHub Classroom como uma ferramenta externa

Retorne à página "Administração do site" do Moodle clicando na guia "Administração do site" no menu de nível superior.
Clique na guia "Plug-ins" e, ao lado da seção "Módulos de atividade", em "Ferramenta externa", clique em Gerenciar ferramentas.
Clique em Configurar uma ferramenta manualmente.

Edite os seguintes valores nos campos:

Campo na configuração do aplicativo Moodle	Valor ou configuração
Nome da ferramenta	`GitHub Classroom` Observação: você pode usar qualquer nome, mas ao definir um nome diferente, comunique isso aos professores.
URL da Ferramenta	`https://classroom.github.com`
Versão do LTI	`LTI 1.3`
Tipo de chave pública	`Keyset URL`
Conjunto de chaves público	`https://classroom.github.com/.well-known/jwks.json`
URL para iniciar logon	`https://classroom.github.com/lti1p3/openid-connect/auth`
URIs de redirecionamento	`https://classroom.github.com/lti1p3/openid-connect/redirect`
Contêiner de inicialização padrão	`New window`

Marque a caixa de seleção Suporte à vinculação profunda (mensagem de item de conteúdo) .
Na lista suspensa "Serviços", ao lado de "Nomes de LTI do IMS e Provisionamento de Função", selecione "Usar este serviço para recuperar as informações dos membros de acordo com as configurações de privacidade" no menu suspenso.
Clique em Salvar alterações.
Agora, o GitHub Classroom está registrado como uma ferramenta externa. Em "Ferramentas", na caixa "GitHub Classroom", clique no ícone de menu para ver a tela "Detalhes da configuração da ferramenta". Essa tela contém informações importantes que você precisará inserir na última etapa do registro da instância no GitHub Classroom abaixo.

3. Registrar a instância do Moodle no GitHub Classroom

Ir para https://classroom.github.com/register-lms.
Preencha as seguintes informações:
- Em "Tipo de LMS", escolha "Moodle" no menu suspenso.
- "Identificador do Emissor": a "ID da plataforma" dos "Detalhes de configuração da ferramenta" da ferramenta externa que você criou no Moodle
- "Domínio": a URL base da instância do Moodle
- "ID do cliente": a "ID do cliente" dos "Detalhes de configuração da ferramenta" da ferramenta externa que você criou no Moodle
- "URL da solicitação de autenticação": a "URL de solicitação de autenticação" dos "Detalhes de configuração da ferramenta" da ferramenta externa que você criou no Moodle
- "URL do token de acesso": a "URL do token de acesso" dos "Detalhes de configuração da ferramenta" da ferramenta externa que você criou no Moodle
- "URL do conjunto de chaves": a "URL do conjunto de chaves público" dos "Detalhes de configuração da ferramenta" da ferramenta externa que você criou no Moodle
Clique em Registrar.
Você verá a faixa "LMS registrado com êxito" na parte superior da tela, o que significa que você registrou a instância do LMS e que os professores agora podem vincular as salas de aula.

Como configurar o Sakai para o GitHub Classroom

1. Registrar o GitHub Classroom como uma ferramenta externa

Acesse o Sakai e faça logon.
Acesse "Workspace de Administração" e selecione Ferramentas Externas na barra lateral esquerda.
Clique em Instalar Ferramenta LTI 1.x.