Como responsáveis pelos dados dos seus alunos, sabemos que vocês se preocupam profundamente com as implicações de privacidade e segurança da adoção de novas ferramentas de tecnologia educacional. Com o nível de integração que as ferramentas LTI podem oferecer, muitos detalhes técnicos podem afetar quais dados são compartilhados. Este guia tem como objetivo ajudá-los a entender as configurações para que possam tomar decisões informadas sobre o acesso concedido.
Na Chave de Desenvolvedor, em Configurações Adicionais, é possível definir o Nível de Privacidade da chave como Público ou Privado. Observe que definir um valor diferente do sugerido pelo fornecedor da ferramenta pode impedir o funcionamento dos serviços. Por exemplo, se as inicializações forem Privadas, a ferramenta não conseguirá atualizar o livro de notas corretamente, mesmo que a permissão "Pode criar e visualizar dados de tarefas no livro de notas associado à ferramenta" esteja ativada.
As informações padrão enviadas em todos os lançamentos designados como Privados incluem:
- Solicitação de link de recurso
- O ‘título’ ou o nome da conta, curso ou tarefa a partir da qual a ferramenta está sendo iniciada.
- ID do recurso
- Descrição do recurso
- O ID de implantação da ferramenta
- O tipo de contexto a partir do qual a ferramenta foi lançada.
- Informações sobre o contexto em que a ferramenta foi iniciada (por exemplo, se for um curso, o nome e o título do curso).
- A função LTI padrão do usuário (Administrador, Instrutor, Usuário, etc., sem funções personalizadas)
- O nome do posicionamento na tela a partir do qual a ferramenta foi iniciada.
Se o lançamento for designado como Público, incluirá adicionalmente:
- O ícone do usuário
- O endereço de e-mail do usuário
- O nome de usuário
- O nome próprio do usuário
- O sobrenome do usuário
- O ID SIS do usuário
- O ID SIS do curso
Além dessas informações, existem quatro áreas principais de configuração que você deve monitorar, pois elas podem impactar os dados compartilhados. Analisaremos cada uma delas em detalhes a seguir. As quatro áreas são:
- Permissões (Escopos)
- Implantações
- Colocações
- Expansões de variáveis
Permissões
Esta seção define os locais específicos que pertencem a cada categoria de local listada abaixo. Essas categorias são usadas ao longo desta documentação para indicar onde um recurso ou variável de substituição é compatível. Por exemplo, quando uma variável é descrita como funcionando em cursos, ela se aplica a todos os locais incluídos na categoria de local de curso correspondente definida aqui.
Permissão | Descrição | 1Especificação de Tecnologia Educacional |
|---|
É possível criar e visualizar dados de tarefas no livro de notas associado à ferramenta. | As ferramentas permitem criar e visualizar a pontuação máxima definida para uma tarefa, a data de início e a data de término do recebimento de submissões. | https://purl.imsglobal.org/spec/lti-ags/scope/lineitem |
É possível visualizar os dados da tarefa no livro de notas associado à ferramenta. | As ferramentas podem visualizar a pontuação máxima definida para uma tarefa, a data em que os envios começarão a ser aceitos e a data em que os envios deixarão de ser aceitos. | https://purl.imsglobal.org/spec/lti-ags/scope/lineitem.readonly |
É possível visualizar os dados de envio das tarefas associadas à ferramenta. | A ferramenta permite visualizar os resultados de uma determinada tarefa, incluindo IDs de usuário, pontuações dos usuários e a pontuação máxima possível, bem como quaisquer comentários visíveis para o aluno sobre a pontuação. | https://purl.imsglobal.org/spec/lti-ags/scope/result.readonly |
Permite criar e atualizar os resultados de submissão de tarefas associadas à ferramenta. | A ferramenta pode criar e editar os resultados de uma determinada tarefa, incluindo IDs de usuário, pontuações dos usuários e a pontuação máxima possível, bem como comentários visíveis para o aluno sobre a pontuação.
| https://purl.imsglobal.org/spec/lti-ags/scope/score |
É possível recuperar dados do usuário associados ao contexto em que a ferramenta está instalada.
| - A ferramenta permite visualizar o nome abreviado ou o código do curso, bem como o nome completo do curso.
- A ferramenta permite visualizar informações sobre os membros do curso em que está disponível. Os dados disponíveis encontram-se abaixo:
- Todas as ferramentas
- Localidade (idioma)
- ID da API
- Nome de usuário de login principal
- O idioma e o fuso horário do usuário.
- Estado de participação no curso
- ID LTI
- Papéis no contexto atual
- Ferramentas com privacidade definida como ‘pública’ ou ‘somente nome’
- Nome completo
- Nome dado
- Nome de família
- ID SIS
- Ferramentas com privacidade definida como "pública" ou "somente e-mail"
- Ferramentas com privacidade definida como "pública"
- Endereço de email
- Avatar
| https://purl.imsglobal.org/spec/lti-nrps/scope/contextmembership.readonly |
É possível atualizar o jwk público para serviços LTI.
| - O escopo específico do Canvas permite que a ferramenta atualize o JWT público.
- Nenhum dado do usuário foi fornecido. Isso é usado para autenticação do aplicativo com o Canvas.
| |
É possível consultar informações da conta.
| - Permite o acesso à API da conta Canvas LTI.
- As ferramentas podem visualizar o ID da conta, o nome, o UUID, o nome da conta principal, o ID da conta raiz e o estado da conta.
| |
É possível visualizar os registros de progresso associados ao contexto em que a ferramenta está instalada. | - Permite o acesso à API de progresso LTI do Canvas.
- A ferramenta permite visualizar o progresso de operações assíncronas da API, como quando foram iniciadas, atualizadas, concluídas e se foram bem-sucedidas. Nenhum dado do usuário é fornecido.
| |
É possível visualizar o conteúdo da página a partir da qual a ferramenta foi iniciada. | - Permite o uso do Canvas lti.getPageContent postMessage
- Isso permite que uma ferramenta solicite todo o conteúdo de uma página em HTML. Atualmente, esse recurso é compatível apenas com o posicionamento Top_Navigation quando acessado a partir de páginas de Tarefas e Wiki. Geralmente, é usado por ferramentas com inteligência artificial integrada.
- As configurações de localização, fuso horário e alto contraste do usuário são compartilhadas.
| |
Implantações
Em geral, as ferramentas só têm acesso a informações quando são iniciadas, e apenas sobre o contexto em que foram iniciadas e o usuário que as iniciou. Se uma ferramenta estiver instalada apenas no Curso A, ela não terá acesso a informações sobre o Curso B. Se uma ferramenta for usada apenas na Tarefa A, ela não terá acesso a informações sobre a Tarefa B. Da mesma forma, as ferramentas só terão acesso a informações de atualização relacionadas às tarefas em que são utilizadas.
Além disso, as ferramentas terão acesso apenas às informações do usuário que as iniciar, para qualquer configuração, com exceção das configurações do Cartão de Contexto do Aluno, que fornecerá o ID do aluno cujo cartão iniciou a ferramenta.
Colocações
Muitas variáveis de substituição estão disponíveis apenas em determinados locais. Agrupamos os tipos de locais abaixo para facilitar a compreensão de quais variáveis de substituição funcionam em cada um deles. Um documento com capturas de tela de cada local pode ser encontrado aqui.aqui.
Colocações | Variáveis de Substituição |
|---|
Colocações de Cursos | - Navegação do curso
- Página inicial do curso Subnavegação
- Configurações do Curso Subnavegação
- Menu de Índice de Tarefas
- Menu de Tarefas do Curso (Suporta Links Diretos)
- Seleção de Migração (Suporta Deep Linking)
- Notas de sincronização
- Botão do Editor (Suporta Deep Linking)
- Colaboração (Suporta Deep Linking)
- Menu de tópicos de discussão
- Menu de Índice de Discussões
- Menu de Quiz
- Índice de questionários
- Menu da página
- Índice de Páginas
- Navegação superior
- Menu do Grupo de Tarefas
- Seleção de links (compatível com Deep Linking)
- Menu de índice de módulos (bandeja)
- Menu Índice de Módulos (Modal)
- Menu do módulo
- Menu do Grupo de Módulos
- Modal de menu do módulo (compatível com Deep Linking)
|
Colocações em Gestão de Arquivos | - Menu Arquivo
- Menu de índice de arquivos
|
Alocação de tarefas | - Edição da tarefa
- Seleção de tarefas (com suporte para links diretos)
- Visão da atribuição
- Menu de tarefas
- Envio de tarefas (compatível com Deep Linking)
- Seleção do tipo de submissão (compatível com Deep Linking)
- Botão do Editor (Suporta Deep Linking)
|
Outras colocações | - Navegação Global
- Navegação da conta
- Configuração da ferramenta
- Cartão de Contexto do Aluno
- Navegação do usuário
|
Expansões de variáveis
A última forma de compartilhar dados com ferramentas é por meio de expansões de variáveis. Para ver a documentação técnica sobre todas as variáveis que o Canvas oferece, consulteaquiEsta lista tem como objetivo fornecer categorias gerais de variáveis e os tipos de informação que elas fornecem, bem como os contextos em que essas variáveis atuam.
Variável | Detalhes |
|---|
Informações da conta | Fornece dados sobre a conta do Canvas. Essas variáveis funcionam em qualquer lugar no Canvas. |
Informações analíticas | Fornece informações utilizadas pelo xAPI e pelo Caliper para fins de análise. - Funciona em cursos
- Funciona em qualquer lugar
|
Informações sobre a tarefa | Fornece informações sobre uma tarefa específica pertencente à ferramenta. Não inclui informações do usuário relacionadas à tarefa. Essas variáveis funcionam apenas dentro de tarefas. - com.instructure.Assignment.lti.id
- com.instructure.Assignment.description
- com.instructure.Assignment.allowedFileExtensions
- com.instructure.Assignment.anonymous_grading
- com.instructure.Assignment.restrict_quantitative_data
- Canvas.assignment.id
- Descrição da tarefa no Canvas
- Título da tarefa no Canvas
- Canvas.assignment.pointsPossible
- Canvas.assignment.unlockAt.iso8601
- Canvas.assignment.lockAt.iso8601
- Canvas.assignment.dueAt.iso8601
- Canvas.assignment.earliestEnrollmentDueAt.iso8601
- Canvas.assignment.allDueAts.iso8601
- Canvas.assignment.published
- Canvas.assignment.lockdownEnabled
- Canvas.assignment.allowedAttempts
- ResourceLink.available.startDateTime
- ResourceLink.available.endDateTime
- ResourceLink.submission.endDateTime
|
Informações contextuais | Esses elementos fornecem informações sobre o contexto a partir do qual a ferramenta é iniciada. Eles funcionam em qualquer lugar na tela. - com.instructure.Course.allow_canvas_resource_selection
- com.instructure.Course.available_canvas_resources
- Contexto.título
- Contexto.sourcedId
- com.instructure.Course.accept_canvas_resource_types
- com.instructure.Course.canvas_resource_type
- com.instructure.Course.canvas_resource_id
- Contexto.id
- com.instructure.Context.globalId
- com.instructure.Context.uuid
|
Informações sobre o curso | Informações sobre o curso a partir do qual a ferramenta é iniciada. Isso não inclui informações sobre indivíduos dentro do curso. Essas ferramentas funcionam apenas em Alocações de Curso, Alocações de Tarefas e Alocações de Gerenciamento de Arquivos quando acessadas dentro de um curso. - CourseOffering.sourcedId
- Contexto.id.histório
- Canvas.curso.id
- vnd.instructure.Course.uuid
- Canvas.course.name
- Canvas.course.sisSourceId
- com.instructure.Course.integrationId
- Canvas.curso.iniciarEm
- Canvas.course.endAt
- Canvas.curso.estado do fluxo de trabalho
- Canvas.term.startAt
- Canvas.term.endAt
- Canvas.term.name
- Canvas.term.id
- SeçãoCurso.IDFonte
- Canvas.matrícula.estado de matrícula
- com.instructure.Course.gradingScheme
- Canvas.curso.IDsContextoAnterior
- Canvas.course.previousContextIds.recursive
- Canvas.curso.IDsDoCursoAnterior
- com.instructure.contextLabel
|
Informações de gerenciamento de arquivos | Informações sobre arquivos dentro do sistema de gerenciamento de arquivos do Canvas. Essas informações funcionam apenas dentro do Gerenciamento de Arquivos para Estágios. - Canvas.file.usageRights.name
- Canvas.file.usageRights.url
- Canvas.file.usageRights.copyrightText
- Canvas.file.media.id
- Canvas.file.media.type
- Canvas.file.media.duration
- Tamanho do arquivo de tela
- Canvas.file.media.title
|
Informação Global | Informações técnicas das ferramentas, não incluem informações de usuário ou conta. Elas funcionam em qualquer lugar. - com.instructure.PostMessageToken
- ToolConsumerInstance.guid
|
Informações do grupo | Informações sobre um grupo. Não inclui os alunos que são membros do grupo. - Trabalho em Cursos e Tarefas
- com.instructure.Course.groupIds
- Canvas.group.contextIds
- Trabalha em tarefas
- com.instructure.Group.id
- com.instructure.Group.name
|
Informações do módulo | Informações sobre módulos. Funciona na maioria dos Cursos e Atividades de Aprendizagem quando o objeto pode fazer parte de um módulo. - Canvas.module.id
- Canvas.moduleItem.id
|
Informações do observador | Informações sobre usuários que estão observando um curso. Funciona apenas em Alocações de Curso e Tarefa. - com.instructure.User.observees
- com.instructure.Observee.sisIds
|
Informações sobre detecção de plágio | Informações utilizadas pelos verificadores de plágio. Isso não inclui informações específicas do usuário. - Trabalhar em tarefas
- com.instructure.OriginalityReport.id
- vnd.Canvas.OriginalityReport.url
- vnd.Canvas.submission.url
- vnd.Canvas.submission.history.url
- com.instructure.Submission.id
- com.instructure.File.id
- Trabalhe em qualquer lugar
- LtiLink.custom.url
- ToolProxyBinding.custom.url
- ToolConsumerProfile.url
|
Informações sobre RCE | Informações sobre o editor de conteúdo avançado. O arquivo com.instructure.Editor.contents inclui informações fornecidas pelo usuário no editor de texto avançado; portanto, se o usuário incluir seu nome ou informações pessoais nesse campo, elas serão compartilhadas. - Funciona no posicionamento do botão do editor.
- com.instructure.Editor.contents
- com.instructure.Editor.selection
- Funciona em qualquer lugar
- com.instructure.RCS.app_host
|
Informações sobre o link de recursos | Informações sobre links de recursos, que fornecem acesso a conteúdo. As ferramentas só podem acessar recursos que elas mesmas criaram. Nenhuma informação do usuário ou da conta é compartilhada. - Trabalhe apenas dentro das tarefas designadas
- ResourceLink.id
- ResourceLink.description
- Trabalhe em qualquer lugar
|
Informações sobre funções e permissões | Informações sobre as permissões e funções, tanto os tipos disponíveis na conta quanto para usuários específicos, se solicitado (a ferramenta deve fornecer o ID do usuário para solicitar informações de um usuário individual). Essas variáveis funcionam em todos os ambientes. - com.Instructure.membership.roles
- Canvas.membership.roles
- Canvas.membership.concludedFunções
- Membro.função
- Canvas.xuser.allRoles
- com.instructure.User.allRoles
- Canvas.user.isRootAccountAdmin
|
Informações da seção | Informações sobre seções. Não inclui uma lista de todos os usuários dentro de uma seção, mas pode fornecer uma seção para um determinado usuário. Funciona com alocações em cursos e tarefas. - com.instructure.User.sectionNames
- Canvas.course.sectionIds
- Canvas.curso.seçãoRestrita
- Canvas.course.sectionSisSourceIds
|
Informações sobre o envio | Informações sobre o número de entregas que um aluno fez em uma tarefa específica. Funciona dentro da seção Tarefas. - Canvas.assignment.submission.studentAttempts
|
Informações sobre a ferramenta | Informações sobre como a ferramenta está configurada no Canvas. Funciona em qualquer lugar. - Canvas.externalTool.global_id
- Canvas.externalTool.url
|
Detalhes do usuário | Informações sobre o usuário, incluindo as contas em que ele é administrador, seus pronomes, fuso horário, preferência por alto contraste e fuso horário. Essas variáveis funcionam em qualquer lugar. - Canvas.user.adminableAccounts
- Mensagem.local
- Canvas.user.prefersHighContrast
- Imagem do usuário
- com.instructure.Person.pronouns
- Pessoa.endereço.fuso horário
|
E-mail do usuário | O endereço de e-mail do usuário. Essas variáveis funcionam em qualquer lugar. - Pessoa.email.principal
- vnd.Canvas.Pessoa.email.sis
|
ID do usuário | Diversos IDs que representam um usuário. Essas variáveis funcionam em qualquer lugar. - ID do usuário
- Canvas.user.id
- vnd.instructure.User.uuid
- vnd.instructure.User.current_uuid
- Canvas.user.globalId
- Canvas.user.sisSourceId
- Canvas.user.sisIntegrationId
- ID de origem da pessoa
- Canvas.mascarandoUsuário.id
- Canvas.mascarandoUsuário.userId
- Usuário.nome de usuário
- Canvas.user.loginId
|
Sessão do usuário | Informações sobre a sessão do usuário no Canvas. Essas variáveis funcionam em qualquer lugar. - com.instructure.User.student_view
- Canvas.logoutService.url
|
Nome de usuário | O nome do usuário. Essas variáveis funcionam em qualquer lugar. - Nome completo da pessoa
- Exibição de nome da pessoa
- Pessoa.nome.família
- Pessoa.nome.dado
- com.instructure.Persona.nome_classificável
|