Tokens de API
Visão geral
Esta seção permite criar e gerenciar tokens de API.
Os tokens de API são usados para autenticação na API do Zabbix.
Cada token de API é atribuído a um único usuário e herda as permissões desse usuário.
As solicitações autenticadas com um token de API são autorizadas de acordo com a função e as permissões do usuário associado.
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 (ativado/desativado). Clique no status do token na lista para ativar/desativar rapidamente um token. Você também pode ativar/desativar tokens em massa 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:
| 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, o nome ou o sobrenome e 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 uma 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 desativado. |
Clique em 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, clique em Close. O token aparecerá na lista.
O valor de Auth token não poderá ser visualizado novamente. Ele fica disponível somente imediatamente após a criação de um token. Se você perder um token salvo, será necessário gerá-lo novamente, o que criará uma nova string de autorização.
Clique no nome do token para editar o nome, a descrição, as configurações da data de expiração ou o status do token. Observe que não é possível alterar o usuário ao qual o token está atribuído. Clique no botão Update para salvar as alterações. Se um token tiver sido perdido ou exposto, você poderá 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 essa operação, pois, após prosseguir, o token gerado anteriormente se tornará inválido.
Usuários sem acesso à seção de menu Administration podem visualizar e modificar os detalhes dos tokens atribuídos a eles na User profile > API tokens seção somente se Manage API tokens estiver permitido nas permissões da sua função de usuário.