> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/integracoes/api-tiflux/api-v2/autenticacao.md).

# Autenticação

## 🔑 Autenticação e Geração de Token (API v2)

```
📍 Localização:
📂 Configurações > Usuários > Usuários | Configurações > Minha conta > Sessões
```

***

### 🎯 Introdução

A API v2 do Tiflux utiliza um modelo de autenticação baseado em tokens individuais por usuário. Este procedimento garante que cada integração possua as mesmas permissões e rastreabilidade do usuário vinculado, oferecendo uma camada extra de segurança e controle. O valor agregado desta configuração é a possibilidade de automatizar processos e integrar sistemas externos de forma segura e personalizada.

***

### 📚 Sumário

🧾 Requisitos de Licenciamento

🛠️ Atribuição da Licença ao Usuário

🧪 Gerando o Token de Acesso

📊 Gestão de Sessões de API

🔄 Renovação e Segurança do Token

***

### 📘 Conteúdo dividido em seções com emojis temáticos

#### 🧾 Requisitos de licenciamento

Diferente das versões anteriores, a autenticação na API v2 é vinculada diretamente ao perfil do colaborador. Para que o sistema permita a geração de chaves de acesso, o usuário em questão deve obrigatoriamente possuir a licença "API por usuário" ativa em seu cadastro. Sem esta atribuição, as abas de geração de token permanecerão ocultas ou desabilitadas.

#### 🛠️ Atribuição da licença ao usuário

Para habilitar o recurso, um administrador deve seguir este fluxo:

1. Acesse Configurações > Usuários > Usuários.
2. Localize e edite o usuário que realizará a integração.
3. Na aba de licenças, marque a opção "API por usuário".
4. Clique em Salvar para aplicar as alterações.

<figure><img src="/files/rtJv0MCfmOwsJbWgdtHu" alt=""><figcaption></figcaption></figure>

#### 🧪 Gerando o token de acesso

Com a licença atribuída, o próprio usuário deve gerar sua credencial:

1. Navegue até Configurações > Minha conta.<br>

   <figure><img src="/files/DrRgamJQBevj2QLVheJL" alt=""><figcaption></figcaption></figure>
2. Clique sobre a aba Sessões e localize o bloco intitulado Sessões API.
3. Clique no botão "Gerar novo token de sessão" e confirme em "Gerar novo token".<br>

   <figure><img src="/files/fluwx1ydaQoLwQhODDof" alt=""><figcaption></figcaption></figure>
4. O sistema exibirá o token em uma janela única. Copie e armazene-o em local seguro imediatamente.<br>

   <figure><img src="/files/jA8ENnIvuFo7u0lUAoKc" alt=""><figcaption></figcaption></figure>

#### 🔄 Renovação e segurança do token

Os tokens de sessão são chaves de acesso poderosas. Caso o token seja comprometido ou perdido, ele deve ser revogado imediatamente na lista de sessões de API. Como o sistema não permite a visualização do código após o fechamento da tela de geração, o esquecimento da chave exigirá a criação de um novo token, o que invalidará o anterior em suas aplicações.

<figure><img src="/files/cdig01BB7k37RGvW6sUB" alt=""><figcaption></figcaption></figure>

***

### ⚠️ Avisos importantes

> Exibição Única: O token de autenticação é exibido apenas uma vez no momento da criação. Por questões de segurança, o Tiflux não armazena o texto simples da chave em seus bancos de dados para consulta posterior.
>
> Segurança: Jamais compartilhe seu token de API em chats, e-mails ou fóruns públicos. Ele concede acesso total às funcionalidades permitidas ao seu usuário.

***

### ❓ Perguntas Frequentes (FAQ)

🔹 Por que não consigo ver a aba "Sessões API"? Provavelmente a licença "API por usuário" não foi atribuída ao seu cadastro nas configurações de usuários.

🔹 Posso ter mais de um token ativo ao mesmo tempo? Sim, você pode gerar múltiplos tokens para diferentes integrações sob o mesmo usuário.

🔹 O que acontece se eu excluir um token na lista de sessões? A integração que utiliza aquele token específico deixará de funcionar imediatamente (Erro 401 Unauthorized).

🔹 O token expira sozinho? Os tokens de API v2 geralmente não possuem expiração automática, a menos que sejam revogados manualmente ou o usuário seja inativado.

🔹 Perdi meu token, onde consulto ele? Não é possível consultar. Você deve gerar um novo token e atualizar sua aplicação.

🔹 A licença de API consome um slot de técnico? A licença de API é um recurso adicional que se atrela a um usuário técnico já existente.

🔹 O token tem as mesmas permissões que eu tenho no sistema? Sim, o token atua com o mesmo nível de permissão (Perfil de Acesso) do usuário que o gerou.

🔹 Consigo gerar um token para outro usuário? Não, cada usuário deve logar em sua própria conta para gerar seu token pessoal na aba "Minha Conta".

🔹 Como identifico qual token pertence a qual integração? Ao gerar, você pode identificar a sessão pela data de criação e pelo último uso na lista de sessões.

🔹 A API v1 continua funcionando com este token? Não, este procedimento é exclusivo para a arquitetura da API v2 do Tiflux.

***

### 🔍 Palavras-chave para IA, indexação e busca

Markdown

```
autenticação api,
token de sessão,
api v2 tiflux,
licença api por usuário,
gerar chave api,
integração externa,
segurança de dados,
sessão de api,
credenciais de acesso,
webservice tiflux
```

###

###

###

### <mark style="color:orange;">1. Requisitos:</mark>

Como a autenticação na API v2 é feita por usuário, o seu usuário do Tiflux deverá possuir atrelado a ele a licença de **"API por usuário".**

Para atribuir a licença ao usuário, você deverá acessar ***Configurações > Usuários > Usuários,*** localizar e acessar o usuário desejado, e marcar a licença **"API por usuário",** conforme ilustra a imagem abaixo:

<figure><img src="/files/a2nAAS1h5rCEAHbhh9lh" alt=""><figcaption></figcaption></figure>

### <mark style="color:orange;">2. Gerando o token de autenticação:</mark>

Para gerar o token de acesso à API v2, acesse as configurações da sua conta em: ***Configurações > Minha conta:***

<figure><img src="/files/OfOBJqcEW0dAE6aSfVN0" alt=""><figcaption></figcaption></figure>

Dentro da tela de configurações da sua conta, clique sobre a aba **"Sessões"** e localize a sessão **"Sessões API":**

<figure><img src="/files/Gdrwf76MG2x74PsZnCTz" alt=""><figcaption></figcaption></figure>

Para criar um novo token, clique em **"Gerar novo token de sessão"** e, em seguida, em **"Gerar novo token":**

<figure><img src="/files/wdS2JUzKEHJMq82AJl80" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/rrfHpQR3PMdE2ZYo3WDT" alt=""><figcaption></figcaption></figure>

Após concluir o procedimento descrito acima, o seu token de autenticação da API será gerado. Na tela seguinte, você poderá visualizar e copiar o token:

<figure><img src="/files/4wBe8ld2LmzJedPp3aZJ" alt=""><figcaption></figcaption></figure>

Pronto! O token da API do seu usuário está criado e pronto para uso.