Skip to main content
failproofai auth login    # e-mail + código de uso único
failproofai auth logout   # revogar esta sessão
failproofai auth whoami   # exibir a identidade conectada
A forma legada com flags --login / --logout / --whoami ainda é aceita como alias para compatibilidade com versões anteriores. A autenticação é opcional. Políticas, o dashboard, a página /audit e todos os outros recursos locais funcionam exatamente da mesma forma, independentemente de você estar conectado ou não. A tela de login existe para que recursos que precisam de uma identidade estável (lembretes de re-auditoria por enquanto, mais no futuro) tenham onde se ancorar.

​
Fluxo de login

failproofai auth login
Solicita seu e-mail, envia um código de 6 dígitos de uso único para esse endereço, pede o código e, em caso de sucesso, grava ~/.failproofai/auth.json (modo 0600). A mesma sessão fica visível no dashboard do aplicativo — ao clicar em [ set a reminder ] em /audit, você aparecerá como conectado. O dashboard expõe o mesmo fluxo como um diálogo modal em /audit para usuários que nunca usam a CLI.

​
Sair

failproofai auth logout
Revoga a sessão atual no servidor e exclui ~/.failproofai/auth.json. Se o servidor de API estiver inacessível, o arquivo local é removido de qualquer forma — a intenção local de sair sempre prevalece.

​
Verificação de identidade

failproofai auth whoami
Exibe <email> (<user uuid>) e encerra com código 0 quando existe uma sessão válida, ou not signed in e encerra com código 1 caso contrário. Atualiza silenciosamente o token de acesso em segundo plano se ele estiver a menos de um minuto de expirar.

​
Lembrete recorrente de re-auditoria

Quando você clica em [ set a reminder ] na página /audit (ou entra via o modal que o botão acessa), o dashboard grava um pequeno arquivo auxiliar em ~/.failproofai/next-audit.json: 
{
  "next_audit_at": 1780765200,
  "user_email": "you@example.com",
  "set_at": 1780160574
}
Este arquivo está vinculado ao e-mail para o qual foi definido — trocar a sessão da CLI para uma conta diferente oculta qualquer lembrete pertencente ao usuário anterior. O intervalo padrão é de 7 dias, configurável futuramente quando o agendador for implementado. Criado com permissões 0600 como auth.json. O endpoint /api/auth/reminder do dashboard expõe GET (ler), POST (definir / reagendar) e DELETE (limpar), e requer uma sessão ativa.

​
O que há em ~/.failproofai/auth.json

{
  "access_token": "eyJhbGc…",
  "refresh_token": "9ede3e…",
  "access_expires_at": 1780160574,
  "refresh_expires_at": 1782748974,
  "user": { "id": "<uuid>", "email": "you@example.com" }
}
Criado com permissões 0600 (leitura/escrita somente pelo proprietário). O token de acesso é um JWT HS256 com validade de 1 hora; o token de atualização é uma string aleatória opaca de 256 bits que o servidor armazena como SHA-256(token). A reutilização do token de atualização é detectada no servidor e revoga todas as sessões do usuário.

​
Variáveis de ambiente

VariávelPadrãoFinalidade
FAILPROOF_API_URLhttps://api.befailproof.aiSubstitui a URL base do servidor de API. Útil para desenvolvimento local com um servidor de API auto-hospedado.
FAILPROOFAI_AUTH_DIR~/.failproofaiSubstitui o local onde auth.json é armazenado. Principalmente para testes.
Consulte Variáveis de ambiente para a lista completa.

​
Solução de problemas

“Could not reach the api-server” — a CLI não consegue abrir uma conexão TCP com FAILPROOF_API_URL. Verifique sua rede ou defina FAILPROOF_API_URL se você estiver executando um servidor de API auto-hospedado. “Rate limited” — muitas tentativas de login em uma janela de 15 minutos para aquele e-mail (5/e-mail) ou IP (20/IP), ou um cooldown de 30 segundos após a solicitação anterior para o mesmo e-mail. A mensagem de erro inclui o tempo de espera em segundos. Código rejeitado — o OTP estava incorreto, expirou ou a entrada atingiu o bloqueio de 5 tentativas erradas. Execute failproofai auth login novamente para solicitar um novo código.