Hub documentation
Autenticação de Dois Fatores (2FA)
Autenticação de Dois Fatores (2FA)
O uso da autenticação de dois fatores verifica a identidade de um usuário por meio de dois métodos, adicionando uma camada extra de segurança para garantir que apenas indivíduos autorizados possam acessar uma conta, mesmo que a senha seja comprometida.
Se você optar por ativar a autenticação de dois fatores, a cada login será necessário fornecer:
- Nome de usuário ou e-mail & senha (credenciais de login normais)
- Um segundo passo, usando um dos seus métodos de verificação em duas etapas:
- Uma das suas passkeys
- Um código de segurança de uso único de um aplicativo autenticador
Ativar a Autenticação de Dois Fatores (2FA)
A autenticação de dois fatores é gerenciada na seção “Autenticação de dois fatores” das suas Configurações de autenticação. Esta seção lista seus métodos de dois fatores (passkeys e aplicativo autenticador) e, uma vez que a 2FA esteja ativada, seus códigos de recuperação.
Para ativar a autenticação em duas etapas, você primeiro precisa de pelo menos um método: adicione uma chave de acesso pela seção “Passkeys” ou configure um aplicativo de autenticação (veja abaixo). Se você tiver apenas chaves de acesso, clique em “Turn on” na seção “Two-factor authentication”. A configuração de um aplicativo de autenticação ativa a autenticação em duas etapas automaticamente.

Configure um aplicativo de autenticação
Para configurar um aplicativo de autenticação com uma senha de uso único:
No Hugging Face Hub:
- Vá para suas Configurações de autenticação
- Na seção “Autenticação de dois fatores”, clique em “Configurar” ao lado de “Aplicativo autenticador”
No seu dispositivo (geralmente o seu celular):
- Instale um aplicativo compatível. Por exemplo:
- Authy
- Google Authenticator
- Microsoft Authenticator
- FreeOTP
- No aplicativo, adicione uma nova entrada de uma das duas formas:
- Escaneie o código exibido na tela do Hub com a câmera do seu dispositivo para adicionar a entrada automaticamente
- Insira a chave de configuração exibida na tela para adicionar a entrada manualmente
No Hugging Face Hub:
- Digite o número PIN de seis dígitos do seu dispositivo de autenticação em “Código de 6 dígitos do aplicativo”
- Salvar

Se você inseriu o PIN correto e a autenticação de dois fatores ainda não estava ativada, o Hub exibe uma lista de códigos de recuperação. Baixe-os e mantenha-os em um local seguro.
Você será solicitado a fornecer a 2FA a cada vez que fizer login e a cada 30 dias
Para migrar para um novo aplicativo de autenticação, clique em “Reset” ao lado de “Authenticator app”. Para removê-lo, clique em “Remove”: isso só é possível se você tiver pelo menos uma passkey para usar como sua segunda etapa. Caso contrário, desative a autenticação de dois fatores.
Use passkeys
Quando a autenticação de dois fatores está ativada, qualquer uma das suas passkeys pode ser usada como a segunda etapa. Se você não tiver um aplicativo de autenticação, sua última passkey não poderá ser removida: configure um aplicativo de autenticação ou desative a autenticação de dois fatores primeiro.

Códigos de recuperação
Logo após você ativar com sucesso a 2FA, será solicitado que você baixe uma coleção de códigos de recuperação gerados. Se você perder o acesso às suas passkeys e ao aplicativo de autenticação, pode usar um desses códigos de recuperação para fazer login na sua conta.
- Cada código pode ser usado apenas uma vez para fazer login na sua conta
- Você deve copiar e imprimir os códigos ou baixá-los para armazenamento em um local seguro. Se você optar por baixá-los, o arquivo é chamado de huggingface-recovery-codes.txt

Se você perder os códigos de recuperação ou quiser gerar novos, pode usar a página Configurações de autenticação.
Regenerar os códigos de recuperação de autenticação de dois fatores
Para regenerar os códigos de recuperação de 2FA:
- Acesse suas Configurações de autenticação
- Se você já ativou a 2FA, clique em “View” ao lado de “Recovery codes” na seção “Two-factor authentication”
- Clique em Regenerar códigos de recuperação
Se você regenerar os códigos de recuperação de 2FA, salve-os. Você não poderá usar nenhum código de recuperação criado anteriormente.
Faça login com a autenticação de dois fatores ativada
Ao fazer login com a verificação em duas etapas (2FA) ativada, o processo é apenas ligeiramente diferente do procedimento padrão de login. Após inserir seu nome de usuário e senha, você encontrará um prompt adicional. Quando solicitado, use uma de suas passkeys, forneça o PIN do aplicativo do seu autenticador de senha de uso único ou use um código de recuperação para concluir o processo de login. Se você configurou vários métodos, pode alternar entre eles a partir do prompt.
Se você entrar com uma passkey em vez da sua senha, não será solicitado um segundo passo.


Desativar a autenticação de dois fatores
Para desativar a 2FA:
- Acesse suas Configurações de autenticação
- Na seção “Autenticação de dois fatores”, clique em “Desativar”.
Isso remove seu aplicativo de autenticação e seus códigos de recuperação. Suas passkeys são mantidas, então você ainda pode usá-las para fazer login sem uma senha.
Opções de recuperação
Se você não tiver mais acesso ao seu dispositivo de autenticação, ainda poderá recuperar o acesso à sua conta:
- Use um código de recuperação salvo, se você os salvou ao ativar a autenticação de dois fatores
- Solicitando ajuda com a autenticação de dois fatores
Use um código de recuperação
Para usar um código de recuperação:
- Digite seu nome de usuário ou e-mail e sua senha na página de login do Hub
- Quando solicitado para a autenticação de dois fatores, clique em “Use a recovery code”
- Insira um dos seus códigos de recuperação
Após usar um código de recuperação, você não pode reutilizá-lo. Você ainda pode usar os outros códigos de recuperação que salvou.
Solicitando ajuda com a autenticação de dois fatores
Caso você tenha esquecido sua senha e perdido o acesso às suas credenciais de autenticação de dois fatores, você pode entrar em contato com o suporte ([email protected]) para recuperar o acesso à sua conta. Será necessário verificar sua identidade usando um fator de autenticação de recuperação, como uma chave SSH ou um token de acesso pessoal.
Update on GitHub