Descrição
O plugin Two-Factor adiciona uma camada extra de segurança ao seu login do WordPress, exigindo que os usuários forneçam uma segunda forma de autenticação além da senha. Isso ajuda a proteger contra acesso não autorizado, mesmo se as senhas forem comprometidas.
Instruções de configuração
Importante: Cada usuário deve configurar individualmente suas configurações de autenticação de dois fatores.
Para usuários individuais
- Navegue até o seu perfil: Vá em “Usuários” “Seu perfil” no painel administrativo do WordPress
- Encontre as opções de dois fatores: Role a tela para baixo até a seção “Opções de dois fatores”
- Escolha seus métodos: Ative um ou mais provedores de autenticação (observando que o administrador do site pode ter ocultado um ou mais, portanto, o que está disponível pode variar):
- Aplicativo autenticador (TOTP) – Use aplicativos como Google Authenticator, Authy ou 1Password
- Códigos por e-mail – Receba códigos de uso único via e-mail
- Códigos de backup – Gere códigos de backup de uso único para emergências
- Método fictício (Dummy) – Apenas para fins de teste (requer WP_DEBUG)
- Configurar cada método: Siga as instruções de configuração para cada provedor ativado
- Definir método principal: Escolha qual método usar como sua autenticação padrão
- Salvar alterações: Clique em “Atualizar perfil” para salvar suas configurações
Para administradores do site
- Configurações do plugin: O plugin fornece uma página de configurações em “Configurações Dois fatores” para configurar quais provedores devem ser desativados em todo o site.
- Gerenciamento de usuários: Os administradores podem configurar o 2FA para outros usuários editando seus perfis
- Recomendações de segurança: Incentive os usuários a ativar métodos de backup para evitar bloqueios de conta
Métodos de autenticação disponíveis
Aplicativo autenticador (TOTP) – Recomendado
- Segurança: Alta – Senhas de uso único baseadas em tempo
- Configuração: Escaneie o código QR com o aplicativo autenticador
- Compatibilidade: Funciona com Google Authenticator, Authy, 1Password e outros aplicativos TOTP
- Melhor para: A maioria dos usuários, oferece excelente segurança com boa usabilidade
Códigos de backup – Recomendado
- Segurança: Média – Códigos de uso único
- Configuração: Gere 10 códigos de backup para acesso de emergência
- Compatibilidade: Funciona em qualquer lugar, nenhum hardware especial é necessário
- Melhor para: Acesso de emergência quando outros métodos não estiverem disponíveis
Códigos por e-mail
- Segurança: Média – Códigos de uso único enviados por e-mail
- Configuração: Automática – usa seu endereço de e-mail do WordPress
- Compatibilidade: Funciona com qualquer dispositivo capaz de receber e-mails
- Melhor para: Usuários que preferem autenticação baseada em e-mail
Chaves de segurança FIDO U2F
- Descontinuado e removido devido à perda de suporte dos navegadores.
Método fictício (Dummy)
- Segurança: Nenhuma – Sempre tem sucesso
- Configuração: Disponível apenas quando WP_DEBUG está ativado
- Objetivo: Apenas testes e desenvolvimento
- Melhor para: Desenvolvedores testando o plugin
Notas importantes
Requisito de HTTPS
- Todos os métodos funcionam tanto em sites HTTP quanto HTTPS
Compatibilidade de navegador
- Os métodos TOTP e e-mail funcionam em todos os dispositivos e navegadores
Recuperação de conta
- Sempre ative os códigos de backup para evitar o bloqueio de sua conta
- Se perder o acesso a todos os métodos de autenticação, entre em contato com o administrador do site
Melhores práticas de segurança
- Use múltiplos métodos de autenticação quando possível
- Guarde os códigos de backup em um local seguro
- Revise e atualize regularmente suas configurações de autenticação
Para mais informações sobre autenticação de dois fatores no WordPress, consulte o Guia de Segurança de Administração Avançada do WordPress.
Para mais histórico, veja este post.
Ações e filtros
Aqui está uma lista de hooks de ações e filtros fornecidos pelo plugin:
- O filtro
two_factor_providerssubstitui os provedores de dois fatores disponíveis, como e-mail e senhas de uso único baseadas em tempo. Os valores do array são nomes de classe PHP os provedores de dois fatores. - O filtro
two_factor_providers_for_usersubstitui os provedores de dois fatores disponíveis para um usuário específico. Os valores do array são instâncias de classes de provedores e o objeto de usuárioWP_Userestá disponível como o segundo argumento. - O filtro
two_factor_enabled_providers_for_usersubstitui a lista de provedores de dois fatores ativados para um usuário. O primeiro argumento é um array de nomes de classe de provedores ativados como valores, o segundo argumento é o ID do usuário. - Ação
two_factor_user_authenticatedque recebe o objetoWP_Userlogado como o primeiro argumento para determinar o usuário logado logo após o fluxo de trabalho de autenticação. - O filtro
two_factor_user_api_login_enablerestringe a autenticação para REST API e XML-RPC apenas para senhas de aplicativo. Fornece o ID do usuário como o segundo argumento. - O filtro
two_factor_email_token_ttlsubstitui o intervalo de tempo em segundos que um token de e-mail é considerado válido após a geração. Aceita o tempo em segundos como o primeiro argumento e o ID do objetoWP_Usersendo autenticado. - O filtro
two_factor_email_token_lengthsubstitui a contagem padrão de 8 caracteres para tokens de e-mail. - O filtro
two_factor_backup_code_lengthsubstitui a contagem padrão de 8 caracteres para os códigos de backup. Fornece oWP_Userdo usuário associado como o segundo argumento. - O filtro
two_factor_rest_api_can_edit_usersubstitui se as configurações de dois fatores de um usuário podem ser editadas via REST API. O primeiro argumento é o booleano$can_editatual, o segundo argumento é o ID do usuário. - Ação
two_factor_before_authentication_promptque recebe o objeto do provedor e é disparada antes da mensagem exibida no formulário de autenticação. - Ação
two_factor_after_authentication_promptque recebe o objeto do provedor e é disparada após a mensagem exibida no formulário de autenticação. - Ação
two_factor_after_authentication_inputque recebe o objeto do provedor e é disparada após o campo de entrada exibido no formulário de autenticação (se o formulário não contiver nenhum campo de entrada, a ação é disparada imediatamente apóstwo_factor_after_authentication_prompt). two_factor_login_backup_linksfiltra os links de backup exibidos no formulário de login de dois fatores.
Redirecionar após o desafio de dois fatores
Para redirecionar os usuários para uma URL específica após concluir o desafio de dois fatores, use o filtro login_redirect nativo do WordPress Core. O filtro funciona da mesma forma que em um fluxo de login padrão do WordPress:
add_filter( 'login_redirect', function( $redirect_to, $requested_redirect_to, $user ) {
return home_url( '/dashboard/' );
}, 10, 3 );
Capturas de tela

Opções de dois fatores no perfil do usuário – Mostra a área de configuração principal onde os usuários podem ativar diferentes métodos de autenticação. 
Autenticação por código de e-mail durante o login do WordPress – Mostra a tela de verificação de e-mail que aparece durante o login. 
Configuração do aplicativo autenticador (TOTP) com código QR – Demonstra a geração do código QR e a inserção manual da chave para a configuração do TOTP. 
Geração e gerenciamento de códigos de backup – Mostra a interface de códigos de backup para gerar e gerenciar códigos de acesso de emergência.
Perguntas frequentes
-
Quais versões do PHP e do WordPress o plugin Two-Factor suporta?
-
Este plugin suporta as duas últimas versões principais do WordPress e a versão mínima do PHP suportada por essas versões do WordPress.
-
Como posso enviar feedback ou obter ajuda com um bug?
-
O melhor lugar para relatar bugs, sugestões de recursos ou qualquer outro feedback (que não seja de segurança) é na página de issues do Two Factor no GitHub. Antes de enviar uma nova issue, pesquise as existentes para verificar se outra pessoa já relatou o mesmo problema.
-
Onde posso relatar bugs de segurança?
-
Os colaboradores do plugin e a comunidade do WordPress levam a sério os bugs de segurança. Agradecemos seus esforços para relatar suas descobertas de forma responsável e faremos todo o esforço para reconhecer suas contribuições.
Para relatar um problema de segurança, visite o programa WordPress HackerOne.
-
E se eu perder o acesso a todos os meus métodos de autenticação?
-
Se você tiver os códigos de backup ativados, poderá usar um deles para recuperar o acesso. Se você não tiver códigos de backup ou tiver usado todos eles, precisará entrar em contato com o administrador do site para redefinir sua conta. É por isso que é importante sempre ativar os códigos de backup e mantê-los em um local seguro.
-
Posso usar este plugin com o WebAuthn?
-
O plugin anteriormente suportava FIDO U2F, que era um predecessor do WebAuthn. Há uma issue aberta para adicionar suporte ao WebAuthn aqui: https://github.com/WordPress/two-factor/pull/427
-
Existe uma maneira recomendada de usar chaves de acesso (passkeys) ou chaves de segurança de hardware com o Two-Factor?
-
Sim. For chaves de acesso (passkeys) e chaves de segurança de hardware, você pode instalar o plugin Two-Factor Provider: WebAuthn: https://wordpress.org/plugins/two-factor-provider-webauthn/
. Ele se integra diretamente com o Two-Factor e adiciona a autenticação baseada em WebAuthn como uma opção adicional de dois fatores para os usuários.
Avaliações
Colaboradores e desenvolvedores
“Two Factor” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.
ColaboradoresTwo Factor” foi traduzido para 40 localidades. Agradecemos aos tradutores por suas contribuições.
Traduzir o “Two Factor” para seu idioma.
Interessado no desenvolvimento?
Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.
Registro de alterações
0.16.0 – 27/03/2026
- Alterações significativas: Remove o suporte ao provedor legado FIDO U2F por #439.
- Novos recursos: Adiciona uma página dedicada de configurações para a configuração do plugin no wp-admin por #764.
- Novos recursos: Adiciona um filtro de links de suporte para que os usuários possam personalizar os links contextuais de recuperação/ajuda por #615.
- Novos recursos: Atualiza o estilo e o comportamento da interface do usuário dos códigos de backup por #804.
- Correções de bugs: Exclui os segredos TOTP armazenados quando o provedor TOTP for desativado por #802.
- Correções de bugs: Protege a manipulação de provedores para que as verificações de login/configurações não falhem no modo aberto quando provedores esperados desaparecerem por #586.
- Correções de bugs: Garante que apenas os provedores configurados sejam salvos e ativados nas configurações do usuário por #798.
- Correções de bugs: Melhora a acessibilidade da página de configurações e corrige o comportamento do link de configurações de perfil por #828 e #830.
- Correções de bugs: Resolve violações do PHPCS nos arquivos dos provedores por #851.
- Atualizações de desenvolvimento: Move os estilos de login e os scripts dos provedores da saída inline para scripts e estilos enfileirados/externos por #807 e #814.
- Atualizações de desenvolvimento: Melhora a documentação inline e a compatibilidade de análise estática (WPCS/phpstan) por #810, #815 e #817.
- Atualizações de desenvolvimento: Melhora a confiabilidade dos testes unitários e integra relatórios de cobertura de código de CI por #825, #841 e #842.
- Atualizações de desenvolvimento: Atualiza os documentos do readme e moderniza a infraestrutura do fluxo de trabalho de CI por #835, #837, #843 e #849.
- Atualizações de dependências: Atualiza o
qsde 6.14.1 para 6.14.2 por #794. - Atualizações de dependências: Atualiza o
basic-ftpde 5.0.5 para 5.2.0 por #816. - Atualizações de dependências: Aplica atualizações automáticas de lint/formatação e atualizações de pacotes Composer associados por #799.
0.15.0 – 13/02/2026
- Alterações significativas: Dispara o fluxo de dois fatores apenas quando esperado por @kasparsd em #660 e #793.
- Novos recursos: Inclui o endereço IP do usuário e aviso contextual nos e-mails de código de dois fatores por @todeveni em #728
- Novos recursos: Otimiza o texto de e-mail para o TOTP por @masteradhoc em #789
- Novos recursos: Adiciona link de ação “Configurações” na lista de plugins para acesso rápido ao perfil por @hardikRathi em #740
- Novos recursos: Hooks de formulário adicionais por @eric-michel em #742
- Novos recursos: Compatibilidade total com a RFC6238 por @ericmann em #656
- Novos recursos: Experiência do usuário consistente para configuração do TOTP por @kasparsd em #792
- Documentação: Documentação do
@sincepor @masteradhoc em #781 - Documentação: Atualiza documentos de usuário e administrador, prepara para mais capturas de tela por @jeffpaul em #701
- Documentação: Adiciona changelog e créditos, atualiza as notas de lançamento por @jeffpaul em #696
- Documentação: Limpa o arquivo readme.txt por @masteradhoc em #785
- Documentação: Adiciona informações de data e hora acima das instruções de configuração do TOTP por @masteradhoc em #772
- Documentação: Esclarece as instruções de configuração do TOTP por @masteradhoc em #763
- Documentação: Atualiza o RELEASING.md por @jeffpaul em #787
- Atualizações de desenvolvimento: Pausa deploys para o trunk do SVN para merges na branch
masterpor @kasparsd em #738 - Atualizações de desenvolvimento: Corrige verificações de CI para compatibilidade de PHP por @kasparsd em #739
- Atualizações de desenvolvimento: Corrige referências do Playground por @kasparsd em #744
- Atualizações de desenvolvimento: Mantém as traduções existentes ao introduzir novos textos de ajuda em e-mails por @kasparsd em #745
- Atualizações de desenvolvimento: Corrige
missing_direct_file_access_protectionpor @masteradhoc em #760 - Atualizações de desenvolvimento: Corrige
mismatched_plugin_namepor @masteradhoc em #754 - Atualizações de desenvolvimento: Introduz o fluxo de trabalho do Props Bot por @jeffpaul em #749
- Atualizações de desenvolvimento: Plugin Check: Corrige o parâmetro $domain ausente por @masteradhoc em #753
- Atualizações de desenvolvimento: Testes: Atualiza para a versão suportada 6.8 do WP por @masteradhoc em #770
- Atualizações de desenvolvimento: Corrige mensagem de descontinuação (deprecated) no PHP 8.5 por @masteradhoc em #762
- Atualizações de desenvolvimento: Exclui as verificações das versões 7.2 e 7.3 contra o trunk por @masteradhoc em #769
- Atualizações de desenvolvimento: Corrige erros do Plugin Check:
MissingTranslatorsCommenteMissingSingularPlaceholderpor @masteradhoc em #758 - Atualizações de desenvolvimento: Adiciona testes para PHP 8.5 para a versão mais recente e trunk do WP por @masteradhoc em #771
- Atualizações de desenvolvimento: Adiciona
phpcs:ignorepara falsos positivos por @masteradhoc em #777 - Atualizações de desenvolvimento: Correção(totp): link
otpauthna URL do código QR por @sjinks em #784 - Atualizações de desenvolvimento: Atualiza o arquivo deploy.yml por @masteradhoc em #773
- Atualizações de desenvolvimento: Atualiza a versão necessária do WordPress por @masteradhoc em #765
- Atualizações de desenvolvimento: Correção: garante que a execução pare após redirecionamentos por @sjinks em #786
- Atualizações de desenvolvimento: Corrige erros de
WordPress.Security.EscapeOutput.OutputNotEscapedpor @masteradhoc em #776 - Atualizações de dependências: Atualiza o qs e o express por @dependabot[bot] em #746
- Atualizações de dependências: Atualiza o lodash de 4.17.21 para 4.17.23 por @dependabot[bot] em #750
- Atualizações de dependências: Atualiza o lodash-es de 4.17.21 para 4.17.23 por @dependabot[bot] em #748
- Atualizações de dependências: Atualiza o phpunit/phpunit de 8.5.44 para 8.5.52 por @dependabot[bot] em #755
- Atualizações de dependências: Atualiza o symfony/process de 5.4.47 para 5.4.51 por @dependabot[bot] em #756
- Atualizações de dependências: Atualiza o qs e o body-parser por @dependabot[bot] em #782
- Atualizações de dependências: Atualiza o webpack de 5.101.3 para 5.105.0 por @dependabot[bot] em #780
0.14.2 – 11/12/2025
- Novos recursos: Adiciona filtro para rest_api_can_edit_user_and_update_two_factor_options por @gutobenn em #689
- Atualizações de desenvolvimento: Remove as ferramentas do Coveralls e adiciona relatório de cobertura inline por @kasparsd em #717
- Atualizações de desenvolvimento: Atualiza o caminho do blueprint para puxar da branch main em vez de uma excluída f… por @georgestephanis em #719
- Atualizações de desenvolvimento: Corrige os deploys de assets do blueprint e do wporg por @kasparsd em #734
- Atualizações de desenvolvimento: Envia o lançamento apenas em tags de release por @kasparsd em #735
- Atualizações de desenvolvimento: Atualiza o playwright e @playwright/test por @dependabot[bot] em #721
- Atualizações de desenvolvimento: Atualiza o tar-fs de 3.1.0 para 3.1.1 por @dependabot[bot] em #720
- Atualizações de desenvolvimento: Atualiza o node-forge de 1.3.1 para 1.3.2 por @dependabot[bot] em #724
- Atualizações de desenvolvimento: Atualiza o js-yaml por @dependabot[bot] em #725
- Atualizações de desenvolvimento: Marca como testado com a versão mais recente do WP core por @kasparsd em #730
0.14.1 – 05/09/2025
- Não codifica a URL do TOTP no formato URI para exibição por @dd32 em #711
- Remove o arquivo Security.md duplicado por @slvignesh05 em #712
- Corrige problemas de linting por @sudar em #707
- Atualiza as dependências de desenvolvimento e corrige falha no teste unitário do QR por @kasparsd em #714
- Dispara o evento change de JavaScript da caixa de seleção por @gedeminas em #688
0.14.0 – 03/07/2025
- Recursos: Ativa as senhas de aplicativos para autenticação de REST API e XML-RPC (por padrão) por @joostdekeijzer em #697 e #698. Anteriormente, isso exigia que o filtro two_factor_user_api_login_enable estivesse definido como true, o que agora é o padrão durante a autenticação por senha de aplicativo. O login por XML-RPC ainda está desativado para senhas regulares de usuários.
- Recursos: Identifica os métodos recomendados para simplificar a configuração por @kasparsd em #676 e #675
- Documentação: Adiciona demonstração do plugin no WP.org por @kasparsd em #667
- Documentação: Documenta as versões suportadas do WP core e PHP por @jeffpaul em #695
- Documentação: Documenta o processo de lançamento por @jeffpaul em #684
- Ferramental: Remove capturas de tela e gráficos duplicados do WP.org do trunk do SVN por @jeffpaul em #683

