Pular para o conteúdo principal

Integração do Brightspace D2L com o POK LTI

Você pode conectar o POK Proof of Knowledge ao Brightspace D2L via LTI para emitir e gerenciar credenciais digitais diretamente dos seus cursos. A configuração tem duas partes: um administrador instala e registra a ferramenta POK no Brightspace, e depois os instrutores adicionam atividades POK aos cursos e configuram como cada credencial será emitida.

Instalar a ferramenta POK no Brightspace​

Passo 1: Conectar a POK ao seu LMS​

  1. Acesse a sua plataforma POK.
  2. Abra o menu no canto superior direito e selecione Integrações.
  3. Procure Brightspace na lista de plataformas.
  4. Clique em Conectar.

Um formulário será aberto, onde você deve informar:

  • Nome da integração: use um nome descritivo, por exemplo Brightspace Universidade - POK.
  • Sua URL: cole a URL do seu LMS.
  • Client ID
  • Client Secret

Para obter o Client ID e o Client Secret, siga as duas partes a seguir.

Parte 1: Obter o Client ID no Brightspace​

  1. Acesse o Brightspace com perfil de administrador.
  2. Vá em Admin Tools (o ícone de engrenagem).
  3. Abra Manage Extensibility.
  4. Clique na aba Service Users.
  5. Selecione New Service User para criar um novo usuário de serviço.
dica

Se você não visualizar a opção para criar um novo Service User, sua conta não tem a permissão necessária. Peça ao administrador principal da sua instituição para atribuí-la.

  1. Após criar o Service User, atribua as unidades de organização em que as atividades da POK ficarão disponíveis.
  2. Dentro do Service User, defina as permissões como All para o conjunto geral de opções.
  3. Abra o menu, escolha Grades e marque as caixas das seguintes permissões:
    • See user grade values (API Only)
    • Retrieve Grade Values for Course Offering Descendants (API Only)

Parte 2: Registrar o app OAuth 2.0​

  1. Selecione a aba OAuth 2.0.

  2. Clique em Register App.

  3. Preencha o formulário com estes valores:

    • Grant Type: selecione Client Credentials.
    • JWKS URL: informe a URL correspondente ao seu ambiente:
      • Produção: https://lti.pok.tech/.well-known/lti-jwks.json
      • QA / Testing: https://lti.credentity.xyz/.well-known/lti-jwks.json
    • Scopes:
    content:modules:manage content:topics:manage core:*:* grades:gradevalues:read grades:gradeobjects:read ltiadvantage:*:*
    • Em Add Service Users, selecione o Service User que você criou na Parte 1.
    • Access Token Lifetime: 3600

  4. Salve o aplicativo.

dica

Se você não visualizar a opção Client Credentials, seu usuário não tem a permissão correspondente. Solicite-a ao administrador da sua instituição.

Passo 2: Registrar a ferramenta POK no Brightspace​

  1. Acesse o Brightspace D2L com perfil de Administrador.
  2. Abra o menu Admin Tools (ícone de engrenagem no canto superior direito).
  3. Selecione Manage Extensibility.
  4. Acesse a aba LTI Advantage e clique em Register Tool.
  5. Selecione Dynamic Registration.
  6. Cole a URL dinâmica que você copiou da POK.
  7. Certifique-se de que o checkbox Configure deployment está ativado e clique em Registrar.
  8. Uma janela pop-up da POK confirmará que o registro foi bem-sucedido. Clique em Fechar.

Não vejo a aba LTI Advantage​

Se a aba LTI Advantage não aparecer em Manage Extensibility, seu perfil não tem as permissões necessárias. Ative-as assim:

  1. Faça login no seu ambiente Brightspace.

  2. Clique no ícone de engrenagem no canto superior direito e selecione Admin Tools.

  3. Abra Roles and Permissions. Você verá a lista de perfis configurados na sua instituição.

  4. Clique no perfil que você usa para a instalação (por exemplo, Administrator ou Instructor). O Brightspace mostra todas as permissões atribuídas a esse perfil.

  5. Use a busca do navegador (Ctrl + F) ou role até a seção External Learning Tools e marque as permissões necessárias para o LTI Advantage:

    • Manage LTI Advantage
    • Manage LTI Links
    • Manage LTI Deployments
    • Manage LTI Settings (opcional, mas recomendado)

  6. Marque também as permissões herdadas, para compatibilidade com versões anteriores:

    • Manage External Learning Tools
    • Manage LTI Tool Providers

    Os nomes podem variar conforme o idioma, mas sempre ficam dentro da categoria External Learning Tools.

  7. Clique em Save and Close.

  8. Volte ao menu Admin Tools, abra Manage Extensibility e confirme que a aba LTI Advantage agora aparece. Depois, continue com os passos de registro acima.

Verificar a configuração do registro​

  1. Ative o registro com o botão Enable.
  2. Dentro do registro, abra a configuração e verifique se as seguintes Extensions estão marcadas:
    • Assignment and Grade Services
    • Names and Role Provisioning Services
  3. Salve e feche o registro.

Passo 3: Criar um deployment​

O deployment associa a ferramenta registrada ao seu ambiente.

  1. Abra o menu Admin Tools (ícone de engrenagem no canto superior direito).
  2. Selecione External Learning Tools.
  3. Clique em New Deployment.
  4. No dropdown Tool, selecione o registro POK LTI que você acabou de criar.
  5. Defina um nome para o deployment.
  6. Ative a opção Enabled para que a ferramenta fique disponível.

Em seguida, confirme se as seguintes configurações estão marcadas no deployment.

Extensões necessárias:

  • Assignment and Grade Services
  • Names and Role Provisioning Services

Configurações de segurança (Security Settings), ative estes checkboxes:

  • Org Unit Information
  • User Information
  • Link Information
  • Classlist including users not known to this deployment

Disponibilidade: selecione as organizações em que você quer que a ferramenta fique disponível (organizações raiz, descendentes ou ambas). Depois, salve a configuração.

  1. No deployment da POK que você acabou de criar, clique no botão View Links.
  2. Selecione New Link para criar um novo link.
  3. Defina um nome para o link, por exemplo "POK Credentials".
  4. No campo de URL, informe: https://lti.pok.tech/lti/launch
  5. Em Type of Link, selecione Basic Launch.
  6. Salve e feche o novo link.

Adicionar a visualização Course Level​

Se você quiser uma visão geral que mostre o status de todas as credenciais emitidas no curso, crie um segundo link:

  1. No deployment da POK, clique no botão View Links.

  2. Selecione New Link para criar um novo link.

  3. Configure o link:

    • Nome do link: use um nome descritivo, por exemplo "Course Level" ou "Visão geral do curso".
    • URL: copie e cole a seguinte URL:
    https://lti.pok.tech/lti/course-level

  4. Salve as alterações para concluir a configuração.

Esse link permite que os usuários acessem a visualização em nível de curso.

Adicionar uma atividade POK dentro de um curso​

  1. Acesse o curso em que você quer adicionar a atividade, com perfil de administrador ou instrutor.
  2. Abra Content.
  3. Selecione uma unidade existente ou crie uma nova com o botão + New Unit.
  4. Clique em Add Existing e selecione External Tool Activity.
  5. Você verá a lista de todos os links configurados no seu deployment.
  6. Procure o nome do link da POK que você criou anteriormente.
  7. Clique nele. A atividade é adicionada automaticamente como recurso dentro do módulo de conteúdo.

Pronto: a ferramenta POK LTI já está instalada e integrada ao Brightspace D2L. Instrutores e estudantes podem emitir e visualizar credenciais diretamente dos seus cursos.

Configurar a emissão da credencial​

Depois de salvar a atividade, clique nela para abrir a configuração LTI e preencha o formulário:

  • Selecione o design da credencial.
  • Vincule uma página personalizada e uma rota de aprendizado (opcional).
  • Defina se a credencial terá data de expiração.
  • Mapeie os atributos personalizados do design com os dados disponíveis do estudante.
  • Escolha o tipo de credencial: básica ou blockchain.
  • Defina o idioma do e-mail que o estudante receberá.

Opção A: Emissão automática por avaliação​

Você pode fazer com que a credencial seja emitida automaticamente quando o estudante for aprovado em uma avaliação. Defina essa condição na própria configuração de emissão.

Opção B: Sem condições de emissão​

Se você preferir não ter pré-requisitos, ignore a opção A. Nesse caso, os estudantes podem abrir o item da credencial dentro do curso e gerá-la manualmente.

Salvar a configuração​

Depois de preencher todas as informações, salve a configuração. Sua credencial POK fica pronta para ser emitida automaticamente ou sob demanda, conforme o que você selecionou.

Ver a lista de credenciais​

Depois de configurar uma credencial no seu curso, você pode revisar o status dela e, se necessário, editar a configuração.

Para abrir a lista, clique no item da credencial dentro do módulo do curso. Ela mostra o status de cada estudante, e a partir dela você pode ver e gerenciar a emissão.

O que significam os status​

  • Pendente: a credencial ainda não foi gerada nem enviada ao estudante.
  • Enviado: a credencial foi gerada e o estudante recebeu um e-mail com o link para aceitá-la.
  • Aceito: o estudante aceitou a credencial pelo e-mail e ela foi emitida com sucesso.

Enviar credenciais manualmente​

Você pode enviar credenciais a qualquer momento para os estudantes que atendam aos critérios definidos:

  1. Clique no botão "Enviar".
  2. As credenciais são enviadas apenas para estudantes com status Pendente.
  3. Se um estudante já estiver com status Enviado ou Aceito, a credencial não será reenviada.

Editar uma credencial​

Se você precisar alterar a configuração de uma credencial, use o botão "Configurar emissão". Você pode atualizar os dados visíveis na credencial.

Visualização Course Level​

Quando um instrutor ou administrador abre o link de Course Level, ele vê um painel com todas as credenciais e certificados disponíveis no curso:

  • Credenciais enviadas: total de credenciais enviadas aos estudantes.
  • Credenciais aceitas: total de credenciais aceitas pelos estudantes.
  • Lista de certificados: cada credencial com seu status de automação e a quantidade de envios concluídos.

Esse painel permite que o instrutor ou administrador:

  • Monitore o progresso das credenciais em tempo real.
  • Gerencie certificados em um único lugar, sem sair do Brightspace.
  • Verifique a automação das credenciais.
  • Analise a participação dos estudantes em cada certificado.
  • Acesse rapidamente os detalhes e links de cada credencial.

Saiba mais​

Para saber como as integrações LTI da POK se conectam com o seu LMS e outros sistemas, acesse a página da funcionalidade de integrações com LMS e CRM.