Segurança da Conta

As opções desta página ficam em Conta (menu lateral) > Minha conta > seção Segurança.

Autenticação de Dois Fatores (2FA)

O 2FA adiciona uma camada extra de segurança ao seu login.

Na Zenifra, o 2FA usa aplicativo autenticador (TOTP). Com o 2FA ativo, o código do login, da troca de senha, da recuperação de senha e da exclusão da conta vem do aplicativo. Sem 2FA, o login, a troca de senha e a exclusão da conta são confirmados por um código enviado ao seu email.

Ativar 2FA

A ativação tem duas etapas: você confirma a senha, escaneia o QR Code e só então confirma com um código do aplicativo.

Acesse Conta > seção Segurança
Clique em Ativar 2FA, informe a Senha atual e clique em OK
Em Configurar 2FA, escaneie o QR Code com seu aplicativo autenticador
Digite o código de 6 dígitos mostrado pelo aplicativo em Código do aplicativo autenticador
Clique em Confirmar ativação

Importante: o 2FA só passa a valer depois de Confirmar ativação. Se você fechar a janela antes disso, o 2FA continua desativado e a configuração iniciada expira em 10 minutos; para ativar, comece de novo. Não existem códigos de backup do 2FA; se perder o acesso ao aplicativo, escreva para [email protected].

Aplicativos compatíveis

Google Authenticator
Authy
Microsoft Authenticator
1Password
qualquer app TOTP compatível

Desativar 2FA

Acesse Conta > seção Segurança
Clique em Desativar 2FA
Informe a Senha atual e o Código TOTP atual do seu aplicativo
Clique em Desativar 2FA para confirmar

Códigos de uso único e limite de tentativas

Cada código do aplicativo autenticador vale uma única vez. Depois de usado (no login, na ativação ou desativação do 2FA, na troca ou recuperação de senha ou na exclusão da conta), o mesmo código é recusado; espere o aplicativo gerar o próximo, o que acontece a cada 30 segundos.
Depois de 10 códigos inválidos em uma hora, novas verificações da conta ficam bloqueadas até o fim dessa janela de uma hora, contada a partir da primeira falha. Um código correto antes de atingir o limite zera a contagem.
Os códigos enviados por email seguem o mesmo limite de 10 falhas por hora, contado separadamente para cada finalidade (login, verificação de email, troca de senha e exclusão da conta).

Alteração de Senha

Como alterar

Acesse Conta > seção Segurança
Informe a Senha atual
Defina a Nova senha (12 a 64 caracteres, com letra maiúscula, letra minúscula, número e caractere especial)
Repita em Confirmar nova senha
Informe o código:
- com 2FA ativo, o Código TOTP do aplicativo
- sem 2FA, clique primeiro em Alterar senha: um código é enviado ao seu email; digite-o em Código de verificação
Clique em Alterar senha

A senha atual é conferida antes do código. Depois da troca, todas as sessões da conta e as integrações conectadas são encerradas e você precisa entrar novamente.

A seção Histórico de login mostra os logins e tentativas dos últimos 7 dias, com data e hora, origem e status (sucesso ou falha).

Notificações de Segurança

Consulte Configurações de Conta para gerenciar preferências de notificação da conta, como Notificações de login e Alteração de senha.

Sessões

Sair encerra apenas a sessão do navegador em que você clicou; as sessões abertas em outros dispositivos continuam ativas.
Trocar ou redefinir a senha encerra todas as sessões da conta e desconecta as integrações autorizadas em Integrações conectadas, como a CLI conectada pelo navegador e o Zenifra MCP.
Pela API, DELETE /v1/authentication encerra a sessão atual e DELETE /v1/authentication?scope=all encerra todas as sessões e conexões autorizadas da conta. Qualquer outro valor de scope é recusado com 400.

Se suspeitar de acesso indevido, troque a senha: é a forma de encerrar todas as sessões pelo console.

Referência da API

Todas as rotas abaixo exigem uma sessão autenticada e ficam em https://api.zenifra.com/v1.

Ação	Requisição	Resposta de sucesso
Iniciar ativação do 2FA	`POST /authentication/2fa` com `{ "current_password": "..." }`	`200` com `data.qr_code`, `data.secret` e `data.requires_confirmation: true`
Confirmar ativação do 2FA	`POST /authentication/2fa` com `{ "code": "123456" }`	`200` (`2FA enabled with success`)
Desativar 2FA	`DELETE /authentication/2fa` com `{ "current_password": "...", "code": "123456" }`	`200` (`2FA disabled successfully`)
Sair desta sessão	`DELETE /authentication`	`200` (`logged out successfully`)
Sair de todas as sessões	`DELETE /authentication?scope=all`	`200` (`logged out successfully`)

Envie current_password ou code em cada chamada de POST /authentication/2fa, nunca os dois juntos. A etapa de confirmação precisa acontecer em até 10 minutos depois de iniciar.

Status	Mensagem ou `code`	Quando acontece
`400`	`current password does not match`	Senha atual incorreta ao iniciar a ativação ou ao desativar
`400`	`2FA not enabled for this user`	Tentativa de desativar com o 2FA desligado
`401`	`invalid TOTP code provided`	Código inválido ou já usado
`409`	`user already have totp`	Tentativa de ativar com o 2FA já ativo
`409`	`2FA setup expired`	Confirmação sem ativação iniciada ou depois de 10 minutos
`429`	`challenge_attempts_exceeded`	Limite de 10 códigos inválidos por hora atingido

Recursos ainda não disponíveis

Atualmente, estes recursos não estão disponíveis no console:

códigos de backup de 2FA
lista de sessões ativas ou de dispositivos conectados
encerramento de uma sessão específica de outro dispositivo
botão para sair de todas as sessões