# Seu histórico de alertas merece mais do que uma senha.

> Proteja sua conta do Pocket Alert com autenticação de dois fatores via TOTP e códigos de recuperação de uso único. Vale para web e celular, e suas chaves de API e scripts continuam funcionando.

<!-- source: https://pocketalert.app/pt/features/two-factor-auth -->

Última atualização: 2026-08-11

Autenticação de dois fatores TOTP com códigos de recuperação de uso único, aplicada no painel e no aplicativo. Suas chaves de API e scripts continuam intactos.

Documentação: https://info.pocketalert.app/features/two-factor-auth.html

## Configure em dois minutos

1. **Escaneie o código** — Abra Conta → Segurança e escaneie o QR code com seu aplicativo autenticador.
2. **Confirme uma vez** — Digite um código de seis dígitos para confirmar. A 2FA só é ativada após um código correto.
3. **Guarde os backups** — Guarde os códigos de recuperação em um lugar diferente do celular que roda o autenticador.

## 2FA de verdade, sem quebrar seus scripts

O histórico de notificações é um registro do que seus sistemas fazem e de quando eles quebram. Isso vale mais do que uma senha.

- **Funciona com qualquer autenticador** — TOTP padrão. Escaneie o QR code com o autenticador que você já usa e confirme um código para ativar.
- **Cobre web e celular** — Aplicada tanto no painel web quanto no aplicativo móvel após o login principal, então não existe uma porta lateral.
- **Códigos de recuperação que aguentam pressão** — Os códigos de recuperação de uso único são emitidos na configuração e consumidos de forma atômica, então dois logins paralelos não conseguem usar o mesmo código.
- **A automação continua intacta** — As chaves de API nunca são desafiadas. Sua automação continua funcionando exatamente como funcionava antes de você ativar a 2FA.
- **Seguro para recadastrar** — Um novo cadastro fica em um espaço pendente até você confirmá-lo, então uma configuração interrompida não deixa você do lado de fora da própria conta.
- **Proteção contra força bruta** — Cinco códigos errados bloqueiam a conta por quinze minutos, e você recebe um e-mail sempre que a 2FA é ativada ou desativada.

## Ativando

    
Abra Conta → Segurança e inicie a configuração. Você recebe um QR code e um segredo para escanear com qualquer autenticador TOTP, depois confirma um código de seis dígitos. Só depois de um código correto a 2FA é de fato ativada, e só então seus códigos de recuperação são exibidos. Guarde-os em algum lugar que não seja o celular com o autenticador.

    
## O que muda no login

    
No painel e no aplicativo, uma senha correta agora leva a uma tela de código, em vez de levar direto para a sua conta. Por trás dos panos, o endpoint de login retorna um desafio de curta duração em vez de um token, e uma segunda chamada troca esse desafio, junto com o seu código, pela sessão real. Os desafios expiram após cinco minutos.

    
O campo de código aceita um código TOTP de seis dígitos ou um dos seus códigos de recuperação, então perder o celular é um incômodo, não um bloqueio.

    
## O que não muda

    
As chaves de API não fazem parte disso. Elas se autenticam com o cabeçalho `Token` e nunca são desafiadas, o que significa que todo script, tarefa cron e pipeline de CI que você tem continua enviando alertas exatamente como antes. Esse também é o argumento para emitir uma chave separada para cada serviço: revogar uma deixa as outras intactas.

## Perguntas frequentes

### Quais aplicativos autenticadores funcionam?

Qualquer aplicativo TOTP padrão: Google Authenticator, 1Password, Authy, Bitwarden e qualquer outro que escaneie um QR code e gere códigos de seis dígitos.

### A 2FA vai quebrar meus scripts e chaves de API?

Não. A 2FA se aplica aos logins interativos no painel e no aplicativo móvel. As chaves de API se autenticam com o cabeçalho Token e nunca são desafiadas, então seus tarefas cron, pipelines de CI e webhooks de monitoramento continuam enviando alertas sem nenhuma alteração.

### E se eu perder meu celular?

Use um dos seus códigos de recuperação no lugar do código de seis dígitos. Cada um funciona uma única vez. Você pode gerar um novo conjunto a qualquer momento em Conta → Segurança, o que invalida os antigos.

### O que acontece se eu começar a configuração e desistir?

Ela não altera a 2FA que você já tem. O novo segredo fica em um espaço pendente e só substitui o ativo depois que você confirmar um código, então fechar a aba no meio do processo não deixa você do lado de fora.

### Como a 2FA muda o login pela API?

O login retorna um desafio de curta duração em vez de um token, e você troca esse desafio, junto com um código, pelo JWT real. Os desafios valem por cinco minutos. O campo de código aceita um código TOTP ou um código de recuperação.

### O que impede alguém de adivinhar meu código?

Cinco códigos errados bloqueiam a conta por quinze minutos, e novas tentativas retornam 429. Você também recebe um e-mail sempre que a 2FA é ativada ou desativada. Se chegar um e-mail e não foi você, troque sua senha imediatamente.
