# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guia-de-uso.tiflux.com/integracoes/api-tiflux/api-v2/autenticacao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.