Como faço para gerenciar tokens de acesso de API como administrador?

Você pode gerenciar tokens de acesso de API a partir das suas configurações de usuário. Tokens de acesso fornecem acesso aos recursos do Canvas através da API do Canvas. Tokens de acesso podem ser gerados automaticamente para aplicativos de terceiros ou criados manualmente.

Usar a API do Canvas permite que o detentor do token de acesso acesse os mesmos recursos do Canvas que você acessa. Por exemplo, aplicativos de terceiros, incluindo dispositivos que você usou para abrir os aplicativos móveis do Canvas, estão autorizados a acessar o Canvas em seu nome. As chamadas de API requerem autorização e são feitas em nome de um usuário autorizado.  Para mais informações sobre o uso da API do Canvas, veja a documentação de API do Canvas.

Depois de ter um login do Canvas, você pode criar um desses tokens de acesso para usar para testar seus projetos de desenvolvimento. Este token deve ser incluído como um parâmetro de consulta de URL em todas as chamadas de API feitas ao Canvas.

Os tokens do Canvas estão alinhados com as permissões do Canvas. Se sua conta do Canvas for excluída, seus tokens serão revogados. Se você não tiver mais uma função administrativa no Canvas, seus tokens gerados anteriormente serão ajustados às novas permissões.

Nota:

  • Os usuários com privilégios de mascaramento não podem remover o token em nome de outros usuários.
  • Os administradores do Canvas não podem excluir tokens de acesso de API em massa para usuários em sua instituição.

Abrir Configurações do Usuário

Abrir Configurações do Usuário

Em Navegação Global, clique no link Conta (Account) [1], depois clique no link Configurações (Settings) [2].

Visualizar tokens de acesso

Os aplicativos de terceiros com tokens de acesso e tokens de acesso gerados pelo usuário estão listados na seção Integrações aprovadas (Approved Integrations) [1].

Para cada token de acesso, você pode visualizar o nome [2], finalidade [3], data de expiração [4] e data do último uso [5].

Nota: Os tokens de acesso móvel nunca expiram. Para remover acesso para um aplicativo móvel, o token de acesso deve ser excluído.

Adicionar token de acesso

Adicionar token de acesso

Para adicionar um token de acesso, clique no botão Adicionar novo token de acesso (Add New Access Token).

Adicionar detalhes do token

Adicionar detalhes do token

Insira uma descrição para seu token de acesso no campo Objetivo (Purpose) [1]. Você também pode selecionar uma data de expiração clicando no ícone Calendário [2]. Para gerar um token sem expiração, deixe o campo Expira vazio.

Para gerar um novo token de acesso, clique no botão Gerar token (Generate Token) [3].

Visualizar token de acesso

Visualizar token de acesso

Visualize a descrição do token [1]. Para visualizar detalhes do token, clique no link detalhes (details) [2].

Visualizar detalhes do token

Visualizar detalhes do token

Os detalhes do token de acesso incluem um token que pode ser usado para fazer chamadas de API em seu nome [1].

Para gerar um token de acesso, clique no botão Regenerar token (Regenerate Token) [2].

Excluir token de acesso

Excluir token de acesso

Para excluir um token de acesso, clique no ícone Excluir.

Confirmar Exclusão

Confirmar Exclusão

Para confirmar a exclusão, clique no botão OK.