Como administrador, você pode usar este guia para identificar e resolver problemas comuns de integração do LTI 1.3.
Realizar verificações padrão no Lumina
Como administrador, você pode realizar verificações padrão para garantir que os parâmetros de configuração sejam os mesmos no Lumina e no seu sistema de gerenciamento de aprendizagem (LMS), já que o LTI 1.3 exige uma configuração bidirecional.
- Entre em contato com o seu gerente de contas para garantir que a sua instituição tenha o LTI 1.3 habilitado.
- Faça login no Lumina como administrador.
- Clique no botão Menu principal > Painel de administrador.
- Na barra lateral, selecione Integrações.
- Verifique se todos os parâmetros correspondem às informações geradas pelo seu LMS.
Resolver erros comuns
Como administrador, você pode usar esta seção para encontrar erros comuns de integração do LTI 1.3 e as etapas para resolvê-los.
- A integração do seu LMS com a YuJa para LTI 1.3 não forneceu um ISS válido: Verifique se o ISS e o ID do cliente estão corretos. Para conferir, acesse Painel de administrador > Integrações > LMS via LTI 1.3.
- A integração do seu LMS com a YuJa para LTI 1.3 não iniciou o login com todas as informações. O erro é: uma chave de assinatura deve ser especificada se o JWT especificado for assinado digitalmente: Verifique se o ID de implantação e o endpoint JWKS estão corretos. Para conferir, acesse Painel de administrador > Integrações > LMS via LTI 1.3.
- Esquema de autenticação não configurado para a sua organização para o LTI 1.3: Entre em contato com o seu gerente de contas da YuJa para habilitar a integração LTI 1.3 para a sua organização.
- A integração do seu LMS com a YuJa para LTI 1.3 não iniciou o login com todas as informações: Isso acontece quando algumas tags obrigatórias do LTI 1.3 estão ausentes na solicitação de inicialização. Verifique a compatibilidade entre a versão atual do seu LMS e o LTI 1.3.
- Declaração de versão do LTI ausente na solicitação de inicialização: Isso acontece quando a declaração de versão (Version Claim) está ausente. Entre em contato com a equipe de suporte do seu LMS para resolver o problema.
- Versão do LTI incorreta passada para a solicitação de inicialização do LTI 1.3: Isso acontece quando a declaração de versão está incorreta. Entre em contato com a equipe de suporte do seu LMS para resolver o problema.
- JWT inválido. Declarações críticas do LTI 1.3 ausentes na solicitação: Isso acontece quando a declaração Sub está ausente. Entre em contato com a equipe de suporte do seu LMS para resolver o problema.
-
Uma ou mais das declarações obrigatórias estão ausentes na solicitação de inicialização do LTI 1.3:
- Tipo de mensagem
- LTI
- ID de implantação
- URI do link de destino
- ID do link de recurso
- ID de usuário do LTI
- Funções do LTI
- Valores de IAT e/ou EXP inválidos passados na solicitação do LTI 1.3 / Campos de IAT e/ou exp inválidos na solicitação de inicialização do LTI 1.3: Isso acontece quando a solicitação contém um carimbo de data/hora expirado.
- KID não definido no cabeçalho: Isso acontece quando a chave de assinatura está ausente durante a solicitação de inicialização. Entre em contato com a equipe de suporte do seu LMS para resolver o problema.
- KID incorreto fornecido: O KID é usado para recuperar a chave correspondente para descriptografar as mensagens enviadas pelo LMS ao Lumina. Um KID incorreto pode ser causado por um ID de implantação incorreto no LMS. Alguns LMS têm o ID de implantação e o KID dissociados. Nesse caso, será necessária uma investigação mais aprofundada tanto do LMS quanto da YuJa.
- Assinatura incorreta - não foi possível validar o JWT: Isso acontece quando a URL da chave JWT está configurada incorretamente. Verifique se todos os outros parâmetros, incluindo ISS, ID de implantação e ID do cliente, estão corretos.
- Chave pública RSA não encontrada para o ISS informado: Isso acontece quando a URL da chave JWT está configurada incorretamente. Verifique se todos os outros parâmetros, incluindo ISS, ID de implantação e ID do cliente, estão corretos.
- Assinatura incorreta, não foi possível validar o JWT de estado: Isso acontece quando a URL da chave JWT está configurada incorretamente. Verifique se todos os outros parâmetros, incluindo ISS, ID de implantação e ID do cliente, estão corretos.
-
A URL da YuJa recusou a conexão: Isso acontece quando a integração não consegue identificar uma conta de usuário para conectar. Há dois motivos comuns.
- Se for um novo usuário, acesse a página Painel de administrador > Integrações > LMS via LTI 1.3 para verificar se o provisionamento automático de uma nova conta de usuário está habilitado.
- Se o objetivo for vincular um usuário existente usando o e-mail dele, verifique se há vários usuários que compartilham o mesmo endereço de e-mail. Entre em contato com o seu gerente de contas da YuJa para resolver o problema.