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.

LMS compatíveis

Configurando o Blackboard para o GitHub Classroom

Você pode registrar a instalação do Blackboard no GitHub Classroom para permitir que os professores importem os dados da lista de turma para suas salas de aula. Para obter mais informações sobre o Blackboard, consulte o site do Blackboard.

Etapa 1. Registrar chaves de desenvolvedor do GitHub Classroom no Portal de Desenvolvedores Anthology

1. Entre no Portal do Desenvolvedor da Anthology.

2. Clique no sinal de mais na página Meu Aplicativo.

3. Clique em Registro Manual no menu suspenso.

4. 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` <br/><br/>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. | | Minha integração dá suporte à LTI 1.3 | Habilite o sinalizador.| | URL de Iniciação de Logon | https://classroom.github.com/lti1p3/openid-connect/auth | | URLs de redirecionamento para ferramentas | https://classroom.github.com/lti1p3/openid-connect/redirect,https://classroom.github.com/context-link | | URL JWKS da ferramenta | https://classroom.github.com/.well-known/jwks.json | | Menu suspenso Algoritmo de Assinatura | RS256 | | Parâmetros personalizados | Deixe em branco. |

5. Clique em Register Application.

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

7. Na tabela na página "Minhas Aplicações", na linha do aplicativo GitHub Classroom, clique nos três pontos e, em seguida, em Gerenciar Posicionamentos no menu suspenso.

8. Clique no sinal de adição.

9. Na página de configuração "Registrar uma nova alocação", defina os campos com os valores a seguir.

   Campo na configuração da nova colocação	Valor ou configuração

          **Nome do posicionamento** | `GitHub Classroom` <br/><br/>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) | | Tipo de menu suspenso | Ferramenta de Curso | | Permitir acesso aos alunos | Não habilite o sinalizador. | | Iniciar em uma nova janela | Não habilite o sinalizador, a menos que você queira oferecer essa experiência do usuário. | | URI do link de destino | https://classroom.github.com/context-link | | URL do ícone | 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. |

10. Clique em Register Placement.

Etapa 2. Registrar as chaves do desenvolvedor do GitHub Classroom no Blackboard

1. Entre em sua instância do Blackboard.
2. Na barra lateral esquerda na home page, clique em Admin e depois em LTI Tool Providers.
3. Na página "LTI Tool Providers", clique em Register LTI 1.3/Advantage Tool.
4. Insira a ID do cliente / ID do aplicativo obtida no Portal do Desenvolvedor e clique em Submit.
5. O Blackboard mostrará todos os dados do aplicativo. Nesta página:
   1. Verifique se o Tool Status é Approved.
   2. Verifique se os campos Campos do Usuário a Serem Enviados estão habilitados para "Função no Curso", "Nome", "Endereço de Email".
   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 Gerenciar Propriedades Globais
      • Em Criação de Links de Provedor de Ferramentas, selecione o botão de opção "Permitir links para qualquer provedor de ferramentas, mas exigir aprovação para cada novo provedor."
   4. Verifique se o botão de opção Allow Membership Service Access está marcado como "Sim".
6. Clique em Enviar.

Etapa 3. Registre as chaves de desenvolvedor no GitHub Classroom

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

2. 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 "OIDC auth request endpoint" obtido a partir do 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úblicas" obtida no registro do aplicativo no Portal do Desenvolvedor da Anthology.

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.

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 para as suas respectivas 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 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". | | Configurações Adicionais lista suspensa | Em "Nível de Privacidade", selecione Public | | Posicionamentos | Selecione Course Settings Sub Navigation.
   
   Observação: se você definir o posicionamento como algo diferente, isso deve ser comunicado aos professores. Nossa documentação esperará que este 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. Registre suas chaves de 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, acrescentando /api/lti/authorize_redirect 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 configuração da chave": a URL base da instância do Canvas com /api/lti/security/jwks adicionado 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 agora os professores 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 Moodle	Valor ou configuração

          **Nome da ferramenta** | `GitHub Classroom` <br/><br/>
          **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 |

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 iniciador com a ferramenta" como "Sempre" e defina "Compartilhar o email do iniciador 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 sua 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": o "ID da Plataforma" nos "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": o "ID do cliente" dos "detalhes da 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" nos "Detalhes de configuração da ferramenta" da ferramenta externa criada por você 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 agora os professores 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 login.

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 Sakai	Valor ou configuração

          **Nome da ferramenta** | GitHub Classroom – [Nome do curso] <br/><br/>
          **Observação**: você pode usar qualquer nome, mas ao definir um nome diferente, comunique isso aos professores. |
   

   | Texto do Botão (Texto no menu da 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 | | Ponto de Inicialização/Endpoint de Conexão OpenID 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 |

5. Após o envio, o Sakai mostrará as informações necessárias para registrar sua 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 sua 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 Well-Known/KeySet da plataforma LTI 1.3 OAuth2": o campo "URL Well-Known/KeySet da plataforma LTI 1.3 OAuth2" 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.