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 saber mais sobre como conectar um curso LMS a uma sala de aula, confira Conectar um curso de 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 saber mais, confira Conectar um curso de sistema de gerenciamento de aprendizagem a uma 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.
- Blackboard (esta é uma opção com suporte da comunidade)
- 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 saber mais, confira Conectar um curso de sistema de gerenciamento de aprendizagem a uma sala de aula.
Configurando o Blackboard para o GitHub Classroom
Você pode registrar a instalação do Blackboard 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 Blackboard, consulte o site do Blackboard.
Etapa 1. Registrar as chaves do desenvolvedor do GitHub Classroom no Portal do Desenvolvedor da Anthology
-
Entre no Portal do Desenvolvedor da Anthology.
-
Clique no sinal de mais na página My Application.
-
Clique em Manual Registration no menu suspenso.
-
Na tela de configuração "Register a new application", defina os campos com os valores a seguir.
Campo na configuração de novo aplicativo Valor ou configuração Nome do Aplicativo GitHub Classroom
Você pode usar qualquer nome, ele será mostrado apenas aos administradores.Descrição Sync Blackboard course roster to GitHub Classroom
(ou algo semelhante)Domain(s) classroom.github.com
Grupo Deixe o valor padrão ou altere de acordo com as necessidades de sua instituição. My Integration supports LTI 1.3 Habilite o sinalizador. Login Initiation URL https://classroom.github.com/lti1p3/openid-connect/auth
Tool Redirect URL(s) https://classroom.github.com/lti1p3/openid-connect/redirect,https://classroom.github.com/context-link
Tool JWKS URL https://classroom.github.com/.well-known/jwks.json
Menu suspenso Signing Algorithm RS256
Parâmetros personalizados Deixe em branco. -
Clique em Register Application.
-
O Portal do Desenvolvedor mostrará uma tela que contém informações importantes que você precisará inserir nas próximas etapas do registro da instância no Blackboard e no GitHub Classroom abaixo. Anote-as em um local seguro e clique em Done.
-
Na tabela na página "My Applications", na linha do aplicativo GitHub Classroom, clique nos três pontos e, em seguida, em Manage Placements no menu suspenso.
-
Clique no sinal de adição.
-
Na tela de configuração "Register a new placement", defina os campos com os valores a seguir.
Campo na configuração da nova posição Valor ou configuração Placement Name GitHub Classroom
Você pode usar qualquer nome, mas ao definir um nome diferente, comunique isso aos professores.Descrição Sync Blackboard course roster to GitHub Classroom
(ou algo semelhante)Menu suspenso Tipo Ferramenta de Curso Allow students access Não habilite o sinalizador. Launch in new window Não habilite o sinalizador, a menos que você queira oferecer essa experiência do usuário. Target link URI https://classroom.github.com/context-link
Icon URL Deixe em branco ou forneça uma URL estática para o ícone. Se necessário, pode ser carregado manualmente no Blackboard posteriormente. Parâmetros personalizados Deixe em branco. -
Clique em Register Placement.
Etapa 2. Registrar as chaves do desenvolvedor do GitHub Classroom no Blackboard
- Entre em sua instância do Blackboard.
- Na barra lateral esquerda na home page, clique em Admin e depois em LTI Tool Providers.
- Na página "LTI Tool Providers", clique em Register LTI 1.3/Advantage Tool.
- Insira a ID do cliente / ID do aplicativo obtida no Portal do Desenvolvedor e clique em Submit.
- O Blackboard mostrará todos os dados do aplicativo. Nesta página:
- Verifique se o Tool Status é
Approved
. - Verifique se os sinalizadores User Fields to be Sent estão habilitados para "Role in Course", "Name", "Email Address".
- Verifique se o botão de opção Allow mark service access está definido como "No". Para habilitar essa opção, navegue até os Provedores de Ferramentas de LTI no Painel de Administração:
- Selecione Manage Global Properties
- Em Creation of Tool Provider Links, selecione o botão de opção “Allow links to any tool provider, but require approval for each new provider”
- Verifique se o botão de opção Allow Membership Service Access está na posição "Yes".
- Verifique se o Tool Status é
- Clique em Enviar.
Etapa 3. Registrar as chaves do desenvolvedor no GitHub Classroom
-
Preencha as seguintes informações:
- Em "LMS Type", escolha "Other" no menu suspenso.
- "Identificador do emissor":
https://blackboard.com
- "Domínio": a URL base da instância do Blackboard
- "Client ID": a "ID do cliente"/"ID do aplicativo" obtida no registro do aplicativo no Portal do Desenvolvedor da Anthology.
- "OIDC Initiation URL": o "ponto de extremidade da solicitação de autenticação OIDC" obtido no registro do aplicativo no Portal do Desenvolvedor da Anthology.
- "OAuth 2.0 Token Retrieval URL": o "ponto de extremidade do token de autenticação" obtido no registro do aplicativo no Portal do Desenvolvedor da Anthology.
- "Key Set URL": a "URL do conjunto de chaves público" obtida no registro do aplicativo no Portal do Desenvolvedor da Anthology.
-
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 agora os professores podem vincular as salas 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 valores a seguir.
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
-
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 valores a seguir 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.
-
Na lista suspensa "Privacidade", defina "Compartilhar o nome do launcher com a ferramenta" como "Sempre" e defina "Compartilhar email do launcher com a ferramenta" como "Sempre".
-
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
-
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.
-
Edite os valores a seguir nos campos.
Campo na configuração do aplicativo Sakai Valor ou configuração Nome da ferramenta GitHub Classroom – [Nome do curso]
Observação: você pode usar qualquer nome, mas ao definir um nome diferente, comunique isso aos professores.Texto do Botão (menu Texto na ferramenta) O que o professor verá no botão para iniciar no GitHub Classroom. Por exemplo, o valor pode ser sync
.URL de inicialização https://classroom.github.com/context-link
Enviar nomes de usuário à ferramenta externa Selecione essa caixa de seleção. Fornecer a lista de participantes do curso à ferramenta externa Selecione essa caixa de seleção. A ferramenta dá suporte à LTI 1.3 Selecione essa caixa de seleção. URL do conjunto de chaves da ferramenta LTI 1.3 https://classroom.github.com/.well-known/jwks.json
OpenID Connect/Ponto de extremidade de inicialização da ferramenta LTI 1.3 https://classroom.github.com/lti1p3/openid-connect/auth
Ponto de extremidade de redirecionamento da ferramenta LTI 1.3 https://classroom.github.com/lti1p3/openid-connect/redirect
-
Após o envio, o Sakai mostrará as informações necessárias para registrar a instância do Sakai no GitHub Classroom.
2. Registrar a instância do Sakai no GitHub Classroom
-
Preencha as seguintes informações:
- Em "Tipo de LMS", escolha "Sakai" no menu suspenso.
- "Emissor da Plataforma LTI 1.3": o campo "Emissor da Plataforma LTI 1.3" fornecido pelo Sakai
- "Domínio": a URL base da instância do Sakai
- "ID do cliente LTI 1.3": o campo "ID do cliente LTI 1.3" fornecido pelo Sakai
- "URL de Autenticação OIDC da Plataforma LTI 1.3": o campo "URL de Autenticação OIDC da Plataforma LTI 1.3" fornecido pelo Sakai
- "URL de recuperação de token de portador OAuth2 da plataforma LTI 1.3": o campo "URL de recuperação de token de portador OAuth2 da plataforma LTI 1.3" fornecido pelo Sakai
- "URL conhecida ou do conjunto de chaves OAuth2 da plataforma LTI 1.3": o campo "URL conhecida ou do conjunto de chaves OAuth2 da plataforma LTI 1.3" fornecido pelo Sakai
-
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 agora os professores podem vincular as salas de aula.