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 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:
1. Verifique se o Tool Status é Approved.
2. Verifique se os sinalizadores User Fields to be Sent estão habilitados para "Role in Course", "Name", "Email Address".
3. 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”
4. Verifique se o botão de opção Allow Membership Service Access está na posição "Yes".
Clique em Enviar.

Etapa 3. Registrar as chaves do desenvolvedor no GitHub Classroom

Ir para https://classroom.github.com/register-lms.
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

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

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.