No Canvas, é possível criar dois tipos de chaves do desenvolvedor: Chaves de LTI e de API. Estas instruções são para chaves do desenvolvedor de LTI. Deseja criar chaves do desenvolvedor da API? Pular para as chaves do desenvolvedor da API do Canvas.
O Ally usa a LTI para realizar a integração com o sistema de gerenciamento de aprendizagem (LMS). A LTI é um padrão desenvolvido pela IMS Global para integrações seguras e perfeitas.
O padrão permite que os usuários acessem o Ally sem sair do Canvas. Fazer login em vários sites não é mais necessário: A LTI permite uma troca segura de informações que habilita uma experiência coesa para seus usuários.
Há duas versões de LTI: v1.1 e v1.3. Cada versão exige diferentes etapas de configuração. A versão atual é LTI v1.3. A maior diferença em relação às versões anteriores é o modelo de segurança atualizado com base em OAuth2, OpenID Connect e JSON Web Tokens.
O Ally está migrando para a LTI 1.3 para aproveitar o modelo de segurança atualizado.
O que isso significa para você? Se você for novo no Ally, nada. Realizamos a integração do Ally com você. Mas se o Ally já estiver integrado ao seu LMS, será necessário reconfigurar a integração com a LTI 1.3.
Reconfigure a integração do Ally com a LTI 1.3
Uma instituição típica terá as três ferramentas do Ally a seguir disponíveis na conta original:
Cada ferramenta tem uma chave e um aplicativo de desenvolvedor de LTI correspondentes.
Será necessário configurar cada ferramenta realizando o processo a seguir:
- Crie uma chave do desenvolvedor de LTI 1.3 para cada ferramenta.
- Configure cada aplicativo de ferramenta com as informações da chave do desenvolvedor.
- Envie o código da chave do desenvolvedor e o código de implantação de LTI de cada ferramenta ao Ally para configuração.
- Remova a configuração da LTI 1.1.
Realize essa etapa por último para uma transição sem interrupções.
Crie uma chave do desenvolvedor de LTI para cada ferramenta
- Acesse a conta raiz da instância do Canvas e, em seguida, acesse Chaves do desenvolvedor.
- Selecione o botão + Chave do desenvolvedor e selecione Chave de LTI. A tela Definir configurações de chave é aberta.
- Clique no menu Método e selecione Colar JSON.
- Abra o URL da ferramenta de LTI para a qual a chave está sendo criada para gerar a configuração JSON. Substitua [AllyEnvironment] pelas informações do ambiente em que sua instituição está hospedada.
- Relatório institucional: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/institution
- Configuração do cliente: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/config
- Relatório de acessibilidade do curso: https://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/course
- Copie as informações na página da web que é exibida.
- Copie e cole o link a seguir no campo Redirecionar URIs. Substitua [AllyEnvironment] pelas informações do ambiente em que sua instituição está hospedada.
- https://<AllyEnvironment>/api/v2/auth/lti/1.3/callback
- Forneça um nome de chave.
Inclua o nome da ferramenta e LTI 1.3 em cada uma. Por exemplo: Relatório institucional do Ally LTI 1.3, Relatório de acessibilidade do curso do Ally LTI 1.3 e Configuração do cliente do Ally LTI 1.3.
- Selecione Salvar. A nova chave é adicionada à página Chaves do desenvolvedor e está desativada por padrão.
- Ative a nova chave.
- Copie o número e o segredo do código da chave na coluna Detalhes. Este número de código de chave se for seu código de cliente exclusivo.
Ambiente do Ally para sua região
Use as informações do ambiente do Ally em que sua instituição está hospedada.
- Centro de dados dos EUA: prod.ally.ac
- Centro de dados do Canadá: prod-ca-central-1.ally.ac
- Centro de dados da Europa: prod-eu-central-1.ally.ac
- Centro de dados de Singapura: prod-ap-southeast-1.ally.ac
- Centro de dados da Austrália: prod-ap-southeast-2.ally.ac
Configuração da ferramenta
Siga as etapas a seguir para as ferramentas Relatório institucional, Configuração do cliente e Relatório de acessibilidade do curso.
- Na conta raiz, selecione Configurações.
- Selecione Aplicativos e Ver configurações do aplicativo.
- Selecione o botão adicionar um Aplicativo.
- No menu Tipo de configuração, selecione Por código do cliente.
- Cole o número do código da chave do cliente fornecida à equipe de suporte do Ally no campo Código do cliente.
- Selecione Enviar.
- Selecione Instalar.
- Copie o código de implementação de LTI para cada ferramenta de relatório.
Um novo link para a ferramenta é exibido na lista de links de navegação à esquerda. Depois que o Ally configurar a ferramenta no sistema do Ally, será possível acessá-la nesse link.
Enviar o código da chave ao Ally
Acesse o Behind the Blackboard e crie um tíquete de caso de suporte com as informações a seguir para que a equipe do Ally possa configurar as ferramentas no sistema do Ally.
- Código da chave do desenvolvedor de cada ferramenta
- Código de implantação de LTI de cada ferramenta
- Solicitação de configuração das ferramentas de LTI 1.3
Por exemplo, a chave do desenvolvedor do Meu relatório institucional é: #00000000000000000. O código de implantação do Meu relatório institucional é: 0000:00c00dc0ec00c00cdc000fced. Configurar meu relatório de LTI1.3.
É possível ter relatórios distintos para as diferentes subcontas em seu ambiente do Canvas. Copie o código da implantação da subconta e adicione essa informação ao tíquete de suporte também.
Atualizar o snippet do Ally para o tema do Canvas
Depois que o relatório institucional do Ally for configurado com a LTI 1.3, atualize o snippet do Ally no tema do Canvas. É necessário que haja um campo "lti13Id" correspondente ao código do cliente do relatório institucional de LTI 1.3 (o código da ferramenta Ally) adicionado.
- Como administrador do Canvas, acesse Administrador e selecione Conta.
- Selecione Temas.
- Indique o tema ativo e selecione Abrir no editor de temas.
- Selecione a guia Upload.
- No snippet do Javascript, adicione a propriedade ltil3Id. Substitua o [InstitutionalReportDeveloperKeyID] pelo código da chave do desenvolvedor do relatório institucional.
window.ALLY_CFG = {
'baseUrl': 'https://prod.ally.ac',
'clientId': 00000,
'lti13Id':
'<YourInstitutionalReportDeveloperKeyID>
' }; $.getScript(ALLY_CFG.baseUrl + '/integration/canvas/ally.js'); - Selecione Aplicar tema.