Skip to main content

Registrar o sistema de gerenciamento de aprendizagem no GitHub Classroom

Você pode configurar um LMS (sistema de gerenciamento de aprendizagem) compatível com LTI no GitHub Classroom.

Quem pode usar esse recurso?

Organization owners who are admins for a classroom can connect learning management systems to 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 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 obter mais informações, 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.

  • 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 "Conectar um curso de sistema de gerenciamento de aprendizagem a uma 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

  1. Entre no Canvas.

  2. Na barra lateral esquerda na home page, clique em Administração e depois em Administrador do Site.

  3. Clique em Chaves do Desenvolvedor.

  4. Em "Chaves do Desenvolvedor", clique no botão + Chave do Desenvolvedor e selecione + Chave de LTI no menu suspenso.

  5. Na tela de configuração "Configurações de Chave", defina os campos com os valores a seguir.

    Campo na configuração do aplicativo CanvasValor ou configuração
    MétodoManual Entry
    TítuloGitHub Classroom

    Observação: você pode usar qualquer nome, mas ao definir um nome diferente, comunique isso aos professores.
    DescriçãoSync Canvas course rosters to GitHub Classroom (ou algo semelhante)
    URI do link de destinohttps://classroom.github.com/context-link
    URL de iniciação do OpenID Connecthttps://classroom.github.com/lti1p3/openid-connect/auth
    Método JWKPublic JWK URL
    URL JWK públicahttps://classroom.github.com/.well-known/jwks.json
    URIs de redirecionamentohttps://classroom.github.com/lti1p3/openid-connect/redirect
    Lista suspensa Serviços avançados de LTIMarque a caixa de seleção "Pode recuperar dados do usuário associados ao contexto em que a ferramenta está instalada".
    Lista suspensa Configurações AdicionaisEm "Nível de Privacidade", selecione Public
    PosicionamentosSelecione 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.
  6. Clique em Save (Salvar).

  7. 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.

  8. 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

  1. Ir para https://classroom.github.com/register-lms.

  2. 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.
  3. Clique em Registrar.

  4. 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

  1. Entre no Moodle.
  2. Clique na guia "Administração do site" no menu de nível superior.
  3. 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.
  4. Ao lado do campo "LTI", clique no botão de alternância para habilitar LTI.
  5. Clique na guia "Plug-ins" novamente, role para baixo até "Inscrições" e clique em Gerenciar plug-ins de inscrição.
  6. 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.
  7. 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.
  8. 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

  1. Retorne à página "Administração do site" do Moodle clicando na guia "Administração do site" no menu de nível superior.

  2. Clique na guia "Plug-ins" e, ao lado da seção "Módulos de atividade", em "Ferramenta externa", clique em Gerenciar ferramentas.

  3. Clique em Configurar uma ferramenta manualmente.

  4. Edite os valores a seguir nos campos.

    Campo na configuração do aplicativo MoodleValor ou configuração
    Nome da ferramentaGitHub Classroom

    Observação: você pode usar qualquer nome, mas ao definir um nome diferente, comunique isso aos professores.
    URL da Ferramentahttps://classroom.github.com
    Versão do LTILTI 1.3
    Tipo de chave públicaKeyset URL
    Conjunto de chaves públicohttps://classroom.github.com/.well-known/jwks.json
    URL para iniciar logonhttps://classroom.github.com/lti1p3/openid-connect/auth
    URIs de redirecionamentohttps://classroom.github.com/lti1p3/openid-connect/redirect
    Contêiner de inicialização padrãoNew window
  5. Marque a caixa de seleção Suporte à vinculação profunda (mensagem de item de conteúdo) .

  6. 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.

  7. 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".

  8. Clique em Salvar alterações.

  9. 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

  1. Ir para https://classroom.github.com/register-lms.

  2. 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
  3. Clique em Registrar.

  4. 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

  1. Acesse o Sakai e faça logon.

  2. Acesse "Workspace de Administração" e selecione Ferramentas Externas na barra lateral esquerda.

  3. Clique em Instalar Ferramenta LTI 1.x.

  4. Edite os valores a seguir nos campos.

    Campo na configuração do aplicativo SakaiValor ou configuração
    Nome da ferramentaGitHub 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çãohttps://classroom.github.com/context-link
    Enviar nomes de usuário à ferramenta externaSelecione essa caixa de seleção.
    Fornecer a lista de participantes do curso à ferramenta externaSelecione essa caixa de seleção.
    A ferramenta dá suporte à LTI 1.3Selecione essa caixa de seleção.
    URL do conjunto de chaves da ferramenta LTI 1.3https://classroom.github.com/.well-known/jwks.json
    OpenID Connect/Ponto de extremidade de inicialização da ferramenta LTI 1.3https://classroom.github.com/lti1p3/openid-connect/auth
    Ponto de extremidade de redirecionamento da ferramenta LTI 1.3https://classroom.github.com/lti1p3/openid-connect/redirect
  5. 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

  1. Ir para https://classroom.github.com/register-lms.

  2. 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
  3. Clique em Registrar.

  4. 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.