> 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

Aqui vamos demonstrar como gerar o token de autenticação para a API v2.

## 🔑 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2Fb7UsziwYerE8BsTwWykt%2Fimage.png?alt=media&amp;token=b27f9f2f-20f4-43a8-b367-ebf965c45c29" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FB1shbXVhyQGZph2f9atR%2Fimage.png?alt=media&amp;token=cb56a6c8-38f3-4c00-b17d-fe4c7670a523" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2Fyt1sxfGmZFfoxDr63DzY%2Fimage.png?alt=media&amp;token=ea2403bb-1f6c-4786-8840-55918e810edc" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FGLRqqT8e6Ql7Kgr8ulO3%2Fimage.png?alt=media&amp;token=b66c9611-94df-4f0a-a856-b1cbe6a2f4c7" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FaRDJkxWZH3RdlAS55F2P%2Fimage.png?alt=media&amp;token=b4deaebe-cbf4-4bc5-ad2e-7f6848cf5498" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FJ2dAWCJPgCK0DiNjGC7A%2Fimage.png?alt=media&amp;token=309870de-31be-426b-b3fd-f9f72e25ef52" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2Ftms0VyKRH3XSAYku9Xzk%2Fimage.png?alt=media&amp;token=27310ae9-5abb-4050-844e-45d17a953018" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FSOyHmzSgvoEyerWqZeHl%2Fimage.png?alt=media&amp;token=9c03ad67-917e-408d-9882-ee1e9d4f4c02" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FEdyfEjo843KozRQcwlJp%2Fimage.png?alt=media&amp;token=e44bfb2e-9457-4a40-af9e-306647abbb1f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FTkFd21rEvV7kNNnlu77L%2Fimage.png?alt=media&amp;token=37cf51e3-da90-43b1-96b6-c78093af37e2" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FLKfx8H59bRIgJZRkg6if%2Fimage.png?alt=media&amp;token=0b875d6c-e301-45b5-9c42-edfb2f8517fe" alt=""><figcaption></figcaption></figure>

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