Pular para o conteúdo

Autenticação de dois fatores

← Voltar ao índice da documentação

A autenticação de dois fatores (2FA) adiciona uma segunda etapa ao login: após sua senha, você insere um código curto de um aplicativo autenticador no seu celular. Mesmo que alguém descubra sua senha, não conseguirá acessar sua conta sem o seu dispositivo.

Funciona com qualquer autenticador TOTP padrão (Google Authenticator, Authy, 1Password, Microsoft Authenticator e outros), e está disponível para todas as contas, não apenas administradores. Proteger seu próprio login não é uma ação de gerenciamento de servidor, então visualizadores e operadores também podem ativá-la.

Abra o menu da conta (sua inicial ou foto de perfil, no canto superior direito) e escolha 2FA.

Menu da conta

Você verá uma janela de inscrição:

Inscrição

  1. Escaneie o código QR com seu aplicativo autenticador, ou toque em Copiar e insira a chave manual.
  2. Digite o código de 6 dígitos que seu aplicativo exibe agora.
  3. Confirme sua senha. Ativar a 2FA revalida sua senha, então uma sessão aberta indevidamente não pode ativá-la com o dispositivo de outra pessoa.
  4. Clique em Ativar.

No momento em que a 2FA é ativada, o painel exibe um conjunto de códigos de backup de uso único.

Códigos de backup

Cada código funciona uma vez, para fazer login caso você perca o acesso ao seu aplicativo autenticador. Salve-os em um local seguro (um gerenciador de senhas é ideal), pois eles não serão exibidos novamente. Você pode gerar um novo conjunto a qualquer momento (o que invalida os antigos).

A partir daí, o login terá uma segunda etapa. Após seu nome de usuário e senha, o painel solicitará seu código:

Login com 2FA

Insira o código atual de 6 dígitos do seu aplicativo (ou um dos seus códigos de backup) e pronto. Até que você complete esta etapa, a sessão não está logada: não pode acessar nenhuma página ou API.

Abra a mesma opção 2FA no menu da conta enquanto ela estiver ativada. Após confirmar sua senha, você pode:

  • Gerar Novos Códigos de Backup emite um novo conjunto e invalida o antigo.
  • Desativar 2FA remove-a da sua conta.

Ambas as opções revalidam sua senha atual primeiro.

Um administrador pode redefinir a 2FA de outro usuário em Configurações → Usuários (Redefinir 2FA no menu de ações desse usuário). Isso limpa a 2FA da conta para que o usuário possa fazer login apenas com a senha e configurá-la novamente. Administradores não podem redefinir sua própria 2FA sem senha. Eles passam pelo processo normal de desativação com senha, para que uma sessão de administrador comprometida não possa remover seu próprio segundo fator.

  • Os códigos são baseados em tempo e mudam a cada 30 segundos; o painel aceita uma pequena variação no relógio e se recupera silenciosamente se o relógio do servidor for corrigido posteriormente.
  • Um código não pode ser reutilizado: uma vez usado para fazer login, o mesmo código não funcionará novamente dentro de sua janela de validade.
  • Códigos incorretos estão sujeitos a limitação de taxa. O limitador é compartilhado com a etapa de senha (um bloqueio por conta mais um limitador por IP RATE_LIMIT_AUTH_PER_15MIN), então inserir uma senha correta não pode redefinir o contador pouco antes de adivinhar o código de 6 dígitos.
  • Alterações na 2FA (ativação, desativação, redefinição, uso de código de backup) são todas registradas no Log de Atividades.