O Ally precisa ser capaz de sincronizar dados da API REST do Canvas, tais como cursos e arquivos, a fim de gerar relatórios e fornecer comentários do instrutor. Para fazer isso com segurança, é preciso gerar um token de acesso.

Isso só está disponível para administradores do Instructure Canvas LMS.


Etapa 1: Criar uma função de conta

Com uma nova função de conta você pode definir as permissões concedidas ao serviço do Ally. Embora você possa ver especificamente quais permissões são concedidas ao serviço do Ally na interface de administração do Canvas, em um nível elevado essas permissões possibilitam ao Ally baixar informações de períodos, cursos e arquivos para gerar comentários de acessibilidade e versões alternativas. Elas também permitem que o Ally exclua e substitua conteúdos de arquivo que são operações importantes para ajudar os instrutores a corrigir o conteúdo de seus cursos.

  1. Entre em sua instalação do Canvas como administrador.
  2. Selecione o ícone Admin na navegação à esquerda e selecione sua conta na janela exibida.
  3. Selecione Permissões e depois Funções de conta.
  4. Selecione Adicionar função.
  5. Salve uma função com o nome Ally. Após salvá-la, uma nova coluna chamada Ally deve aparecer na tabela.
  6. Na coluna Ally, habilite as seguintes permissões.
    • Cursos – visualizar lista
    • Usuários – atuar como
    • Avisos – visualizar
    • Exercícios e questionários – adicionar/editar/excluir
    • Conteúdo do curso – adicionar/editar/excluir
    • Conteúdo do curso – visualizar
    • Arquivos do curso – adicionar/editar/excluir
    • Discussões – moderar
    • Discussões – visualizar
    • Páginas – adicionar/editar/excluir

Etapa 2: Criar um usuário

É considerada uma prática recomendada criar um usuário para cada integração com o Canvas. Se os usuários da sua instituição forem criados diretamente no Canvas, siga estas instruções para fazer isso. No entanto, se os usuários forem gerenciados em um sistema externo, tal como o SIA ou o LDAP, siga o processo de criação de usuários para uso no Canvas da sua instituição e, em seguida, prossiga para conceder ao novo usuário a função Ally.

Se os usuários forem criados diretamente no Canvas da sua instituição, execute as seguintes etapas.

  1. Navegue até a página Usuários no gerenciamento da sua conta.
  2. Selecione Novo usuário e adicione um novo usuário com o nome Ally.
  3. Certifique-se de que a caixa de seleção Enviar e-mail ao usuário sobre a criação desta conta esteja marcada.
  4. Clique no link recebido na caixa de entrada do seu e-mail para confirmar a criação da conta.

Etapa 3: Atribuir a função Ally ao novo usuário

  1. Navegue até a página Configurações no gerenciamento da sua conta.
  2. Selecione Admins.
  3. Selecione o botão + Admins de conta para adicionar o usuário.
  4. No formulário exibido, certifique-se de que a função Ally esteja selecionada no menu.
  5. Se os usuários forem criados diretamente no Canvas da sua instituição, você será orientado a inserir o endereço de e-mail do usuário criado na seção anterior. Se o usuário foi criado em um sistema externo, tal como o SIA ou o LDAP, insira no campo o identificador do usuário solicitado pelo Canvas.
  6. Selecione Continuar...
  7. Se o usuário for encontrado, selecione OK, tudo certo.
  8. Confirme se o usuário Ally foi adicionado à lista.

Etapa 4: Gerar um token de acesso

Nesta etapa final, geraremos um token de acesso que pode ser usado pelo serviço do Ally para interagir com segurança e proteção com a API REST.

  1. Entre como o usuário Ally.

    Mascarar-se como o usuário Ally não funcionará nessas etapas, pois o Canvas proíbe que administradores configurem tokens de acesso em nome de outros usuários.

  2. Navegue até as configurações do usuário selecionando Conta na navegação à esquerda, depois o link Configurações na nova janela.
  3. Selecione Novo token de acesso.
  4. Insira Integração do Ally.ac como o propósito do token; o campo de carimbo de data/hora de expiração pode ser deixado em branco.
  5. Selecione Gerar token.
  6. Uma nova janela com o token de acesso deverá ser exibida. Não se esqueça de copiar o token imediatamente, pois não será mais possível acessá-lo após sair desta página.