4 Tokens API
Visão geral
Esta seção permite criar e gerenciar tokens de API.
Você pode filtrar tokens de API por nome, usuários aos quais os tokens estão atribuídos, data de expiração, usuários que criaram os tokens ou status (habilitado/desabilitado). Clique no status do token na lista para habilitar/desabilitar rapidamente um token. Você também pode habilitar/desabilitar tokens em massa selecionando-os na lista e clicando nos botões Enable/Disable abaixo da lista.
Para criar um novo token, pressione o botão Create API token no canto superior direito e, em seguida, preencha os campos obrigatórios na tela de configuração do token:
| Parâmetro | Descrição |
|---|---|
| Name | Nome visível do token. |
| User | Usuário ao qual o token deve ser atribuído. Para selecionar rapidamente um usuário, comece digitando o nome de usuário, nome ou sobrenome e, em seguida, selecione o usuário necessário na lista de preenchimento automático. Como alternativa, você pode pressionar o botão Select e selecionar um usuário na lista completa de usuários. Um token pode ser atribuído a apenas um usuário. |
| Description | Descrição opcional do token. |
| Set expiration date and time | Desmarque esta caixa de seleção se um token não deve ter data de expiração. |
| Expiry date | Clique no ícone de calendário para selecionar a data de expiração do token ou insira a data manualmente no formato YYYY-MM-DD hh:mm:ss |
| Enabled | Desmarque esta caixa de seleção se precisar criar um token em estado desabilitado. |
Pressione Add para criar um token.
Copie o valor de Auth token e salve-o em um local seguro antes de fechar a página; em seguida, pressione Close. O token aparecerá na lista.
O valor de Auth token não pode ser visualizado novamente mais tarde. Ele fica disponível apenas imediatamente após a criação de um token. Se você perder um token salvo, terá que regenerá-lo, e isso criará uma nova string de autorização.
Clique no nome do token para editar o nome, a descrição, as configurações de data de expiração ou o status do token. Observe que não é possível alterar a qual usuário o token está atribuído. Pressione o botão Update para salvar as alterações. Se um token tiver sido perdido ou exposto, você pode pressionar o botão Regenerate para gerar um novo valor de token. Uma caixa de diálogo de confirmação será exibida, solicitando que você confirme esta operação, pois, após prosseguir, o token gerado anteriormente se tornará inválido.
Usuários sem acesso à seção de menu Administration podem ver e modificar os detalhes dos tokens atribuídos a eles apenas na seção User profile → API tokens se Manage API tokens estiver permitido nas permissões de sua função de usuário.