[comment]: # translation:outdated

[comment]: # ({8d34cfb0-851ae152})
# 4 Tokens de API

[comment]: # ({/8d34cfb0-851ae152})

[comment]: # ({d632cee5-7d7a0a5c})
#### Visão geral

Esta seção permite criar e gerenciar tokens de API.

![](../../../../../assets/en/manual/web_interface/api_tokens.png){width="600"}

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 tokens ou status
(ativado/desativado). Clique no status do token na lista para ativar/desativar
rapidamente um token. Você também pode ativar/desativar vários tokens ao mesmo
tempo selecionando-os na lista e clicando nos botões *Enable/Disable* abaixo
da lista.

Para criar um novo token, clique no botão *Create API token* no canto superior
direito e preencha os campos obrigatórios na tela de configuração do token:

![](../../../../../assets/en/manual/web_interface/frontend_sections/users/api_token_conf.png){width="600"}

|Parameter|Description|
|--|--------|
|Name|Nome visível do token.|
|User|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 desejado na lista de preenchimento automático. Como alternativa, você pode clicar no 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 o 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 digite a data manualmente no formato YYYY-MM-DD hh:mm:ss|
|Enabled|Desmarque esta caixa de seleção se você precisar criar um token em estado desativado.|

Clique em *Add* para criar um token. 

![](../../../../../assets/en/manual/web_interface/frontend_sections/users/api_token.png){width="600"}

Copie o valor de *Auth token* e salve-o em um local seguro **antes de fechar a página**; depois, clique em *Close*.
O token aparecerá na lista.

::: notewarning
O valor de *Auth token* não pode ser visualizado novamente depois. Ele
fica disponível apenas imediatamente após a criação de um token. Se você perder um
token salvo, será necessário 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 para
qual usuário o token está atribuído. Clique no botão *Update* para salvar as alterações.
Se um token tiver sido perdido ou exposto, você pode clicar no 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* [section](/manual/web_interface/user_profile#api-tokens) se
*Manage API tokens* estiver permitido nas permissões de sua [user
role](/manual/web_interface/frontend_sections/users/user_roles).

[comment]: # ({/d632cee5-7d7a0a5c})