> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.2/infraestrutura-instalacao-e-requisitos/configuracoes-criticas-do-servidor/autenticacao-de-duplo-fator-2fa.md).

# Autenticação de duplo fator (2FA)

Excelente. Esse é um dos artigos que merece uma boa reestruturação, mas sem perder a simplicidade. O conteúdo legado é suficiente, porém ele foi escrito de forma muito procedural, sem contextualizar a funcionalidade. Seguindo o padrão que adotamos para toda a documentação 5.3, eu o escreveria assim:

***

## Autenticação de Duplo Fator (2FA)

A autenticação de duplo fator (2FA) adiciona uma camada extra de segurança ao processo de autenticação do Weknow, exigindo que o usuário informe um código temporário gerado por um aplicativo autenticador, além de suas credenciais de acesso.

Quando habilitada, essa funcionalidade reduz o risco de acessos não autorizados, mesmo que a senha do usuário seja comprometida.

***

### Quando utilizar

Recomenda-se habilitar a autenticação de duplo fator em ambientes que:

* armazenam informações sensíveis;
* possuem acesso externo à rede da instituição;
* exigem maior controle de segurança sobre os acessos dos usuários;
* seguem políticas internas de segurança da informação.

***

### Habilitando a autenticação de duplo fator

A autenticação de duplo fator é habilitada no cadastro da conta.

Para ativá-la:

1. Abra o **Weknow Server**.
2. Acesse **Contas**.
3. Selecione a conta desejada.
4. Clique em **Editar**.
5. Acesse a guia **Configurações**.
6. Marque a opção **Habilitar autenticação de duplo fator (OTP)**.
7. Salve as alterações.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FpH8be3uLQvPhcEqKsJFy%2Fimage.png?alt=media&amp;token=8dfcf8d5-4a0f-42e9-878f-466e6dfba721" alt=""><figcaption></figcaption></figure>

***

### Primeiro acesso do usuário

Após a autenticação de duplo fator ser habilitada, no primeiro login do usuário será exibido um **QR Code** para registro do dispositivo autenticador.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FUcM4RgRb8D4qeC6XOPUp%2Fimage.png?alt=media&amp;token=2d775d2b-a549-44bf-a30c-49ab68004c59" alt=""><figcaption></figcaption></figure>

O QR Code deve ser escaneado utilizando um aplicativo compatível, como:

* Microsoft Authenticator;
* Google Authenticator;
* outros aplicativos compatíveis com o padrão TOTP.

Após o registro, o aplicativo passará a gerar códigos temporários de autenticação.

Informe o código apresentado para concluir o acesso ao Weknow.

***

### Autenticação nos próximos acessos

Após concluir o registro do dispositivo, todos os logins passarão a solicitar o código de autenticação gerado pelo aplicativo.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FohIiBzDJ4xLUcg8REOyv%2Fimage.png?alt=media&amp;token=44cb7c44-ad16-48d4-8de0-423a0134c7ba" alt=""><figcaption></figcaption></figure>

Basta abrir o aplicativo autenticador e informar o código exibido para concluir o processo de autenticação.

***

### Recuperação do QR Code

Caso o usuário perca o dispositivo autenticador ou necessite registrar um novo aparelho, será possível solicitar um novo QR Code durante o processo de autenticação.

Para isso:

1. Clique em **Enviar QR Code de registro por e-mail**.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FwTJOZvdZqemWi4XZzIv9%2Fimage.png?alt=media&amp;token=3b0a292d-3c3a-4b06-a729-cfa746169901" alt=""><figcaption></figcaption></figure>

2. Aguarde o recebimento da mensagem.
3. Escaneie o novo QR Code utilizando o aplicativo autenticador.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FcO1EztdGuhAnxHYZBidL%2Fimage.png?alt=media&amp;token=a854086c-174a-4afa-a3cd-9577c8dd0a18" alt=""><figcaption></figcaption></figure>

Para que essa funcionalidade esteja disponível, é necessário que:

* exista um servidor **SMTP** configurado como padrão;
* o usuário possua um endereço de e-mail válido cadastrado no Weknow.

Caso uma dessas condições não seja atendida, o envio do QR Code não será realizado.

***

### Boas práticas

Para garantir o funcionamento correto da autenticação de duplo fator, recomenda-se:

* utilizar aplicativos autenticadores confiáveis;
* manter o dispositivo móvel protegido por senha ou biometria;
* manter o endereço de e-mail do usuário sempre atualizado;
* revisar periodicamente a configuração do servidor SMTP.

#### ⚠️ Importante

O código OTP (One-Time Password) é gerado com base no horário atual.

Para que a autenticação funcione corretamente, o relógio do servidor onde o **Weknow Server** está instalado e o relógio do dispositivo utilizado pelo usuário devem estar sincronizados.

Diferenças de horário entre esses dispositivos podem impedir a validação do código de autenticação.

***

### Solução de problemas

#### Não recebo o e-mail com o QR Code

Verifique se:

* existe um servidor SMTP configurado;
* o endereço de e-mail do usuário está cadastrado corretamente;
* não há bloqueios no servidor de e-mail da instituição.