Hub documentation

Autenticação de Dois Fatores (2FA)

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

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:

  1. Vá para suas Configurações de autenticação
  2. Na seção “Autenticação de dois fatores”, clique em “Configurar” ao lado de “Aplicativo autenticador”

No seu dispositivo (geralmente o seu celular):

  1. Instale um aplicativo compatível. Por exemplo:
    • Authy
    • Google Authenticator
    • Microsoft Authenticator
    • FreeOTP
  2. 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:

  1. Digite o número PIN de seis dígitos do seu dispositivo de autenticação em “Código de 6 dígitos do aplicativo”
  2. 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:

  1. Acesse suas Configurações de autenticação
  2. Se você já ativou a 2FA, clique em “View” ao lado de “Recovery codes” na seção “Two-factor authentication”
  3. 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:

  1. Acesse suas Configurações de autenticação
  2. 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:

  1. Digite seu nome de usuário ou e-mail e sua senha na página de login do Hub
  2. Quando solicitado para a autenticação de dois fatores, clique em “Use a recovery code”
  3. 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