4 Tokens de API
Visão geral
Esta seção permite criar e gerenciar tokens de API.
Você pode filtrar os 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 |
|---|---|
| Nome | Nome visível do token. |
| Usuário | Usuário ao qual o token deve ser atribuído. Para selecionar rapidamente um usuário, comece a digitar 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. |
| Descrição | Descrição opcional do token. |
| Definir data e hora de expiração | Desmarque esta caixa de seleção se um token não deve ter data de expiração. |
| Data de expiração | 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 |
| Habilitado | Desmarque esta caixa de seleção se você 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 e, em seguida, pressione Close. O token aparecerá na lista.
O valor de Auth token não poderá ser visualizado novamente mais tarde. Ele só fica disponível 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 somente na seção User profile → API tokens se Manage API tokens estiver permitido nas permissões de sua função de usuário.