Pular para o conteúdo principal

Autenticação multifator (MFA / 2FA)

Sobre autenticação de múltiplos fatores​

O MFA (autenticação multifator) exige que os usuários forneçam dois ou mais fatores para provar quem são ao fazer login ou executar operações sensíveis: algo que eles sabem, como uma senha, mais algo que eles têm, como um telefone com um aplicativo autenticador. O 2FA (autenticação de dois fatores) é o caso comum de MFA com exatamente dois fatores, e no Casdoor os dois termos descrevem o mesmo recurso: uma senha, passkey ou login social seguido por um segundo fator.

O Casdoor suporta estes segundos fatores:

MethodWhat the user enters
TOTP authenticator app (Google Authenticator, Microsoft Authenticator and other apps)A six-digit code that changes every 30 seconds
SMSA code sent to the user's phone number
EmailA code sent to the user's email address
RADIUSThe password of the user's account on an external RADIUS server

Cada método também fornece ao usuário códigos de recuperação para quando o segundo fator for perdido. Os administradores podem tornar o MFA opcional ou obrigatório para uma organização com itens de MFA.

Once you enable MFA, Casdoor requires an authentication code every time someone attempts to sign in to your account. A única maneira de alguém fazer login na sua conta é se souberem tanto sua senha quanto tiverem acesso ao código de autenticação.

Configurando MFA​

  1. Na página de perfil do usuário, abra a seção de autenticação multifator. Se estiver ausente, certifique-se de que a organização adicionou o item de MFA na tabela de itens da conta.

    mfa_config

  2. Clique no botão "configurar".

    mfa_setup

  3. Digite sua senha e clique em "Próximo Passo".

    mfa_check_password

Configurando autenticação de múltiplos fatores usando um aplicativo móvel TOTP​

Um aplicativo de senha única baseada em tempo (TOTP) gera automaticamente um código de autenticação que muda após um certo período de tempo. Recomendamos usar:

dica

Para configurar autenticação via TOTP em múltiplos dispositivos, durante a configuração, escaneie o código QR usando cada dispositivo ao mesmo tempo. Se o 2FA já estiver ativado e você quiser adicionar outro dispositivo, você deve reconfigurar seu aplicativo TOTP a partir da página de perfil do usuário.

totp

Ao adicionar sua conta a um aplicativo autenticador, o nome da conta mostrará o nome de exibição da organização (ou o nome da organização se nenhum nome de exibição estiver definido). Isso ajuda a identificar a qual organização o código TOTP pertence ao gerenciar várias contas.

  1. No passo "Verificar Código", faça uma das seguintes ações:

    • Escanear o código QR com o aplicativo do seu dispositivo móvel. Após escanear, o aplicativo exibirá um código de seis dígitos que você pode inserir no Casdoor.
    • Se o código QR não puder ser escaneado, copie o segredo e insira-o manualmente no aplicativo TOTP.
  2. O aplicativo móvel TOTP salva sua conta no Casdoor e gera um novo código de autenticação a cada poucos segundos. No Casdoor, digite o código no campo "Código de Passagem" e clique em "Próximo Passo".

  3. Acima do botão "Ativar", copie seus códigos de recuperação e salve-os no seu dispositivo. Salve-os em um local seguro porque seus códigos de recuperação podem ajudá-lo a recuperar o acesso à sua conta se você perder o acesso.

    mfa_enable

cuidado

Cada código de recuperação só pode ser usado uma vez. Se você usar um código de recuperação para fazer login, ele se tornará inválido.

Configurando autenticação de múltiplos fatores usando mensagens de texto​

Se você adicionou seu número de telefone móvel, o Casdoor usará isso para enviar-lhe uma mensagem de texto.

mfa_bound

Se você não adicionou seu número de celular, adicione-o primeiro na sua conta.

mfa_binding

  1. Selecione seu código de país e digite seu número de telefone móvel.

  2. Verifique se suas informações estão corretas e clique em "Enviar Código".

  3. Digite o código de segurança da mensagem de texto em Enter your code e clique em Next Step.

  4. Acima do botão "Ativar", copie seus códigos de recuperação e salve-os no seu dispositivo. Salve-os em um local seguro porque seus códigos de recuperação podem ajudá-lo a recuperar o acesso à sua conta se você perder o acesso.

Configurando autenticação de múltiplos fatores usando email​

Configurando email como seu método de autenticação de múltiplos fatores é similar a usar mensagens de texto.

  1. Use seu email atual ou digite seu endereço de email e clique em "Enviar Código".

  2. Então digite o código no campo "Digite seu código" e clique em "Próximo Passo".

  3. Acima do botão "Ativar", copie seus códigos de recuperação e salve-os no seu dispositivo. Salve-os em um local seguro porque seus códigos de recuperação podem ajudá-lo a recuperar o acesso à sua conta se você perder o acesso.

Configurando autenticação multifator usando RADIUS​

O MFA RADIUS permite autenticar contra um servidor RADIUS externo para o segundo fator de autenticação. Isso é útil ao integrar com infraestrutura de autenticação existente.

Antes de usar o MFA RADIUS, seu administrador deve configurar um provedor RADIUS na aplicação. Uma vez configurado:

  1. Digite seu nome de usuário RADIUS quando solicitado durante a configuração.

  2. Digite sua senha RADIUS para verificar a configuração. Esta senha será verificada contra o servidor RADIUS configurado. Nos subsequentes logins, você digitara esta mesma senha RADIUS como seu segundo fator.

  3. Acima do botão "Ativar", copie seus códigos de recuperação e salve-os no seu dispositivo. Salve-os em um local seguro porque seus códigos de recuperação podem ajudá-lo a recuperar o acesso à sua conta se você perder o acesso.

nota

A autenticação RADIUS comunica-se com o servidor RADIUS externo configurado pelo seu administrador. Certifique-se de ter o nome de usuário e senha corretos para sua conta RADIUS.

Onde o MFA se aplica​

O Casdoor solicita o segundo fator ou a configuração de MFA quando a organização exige MFA (consulte Itens de MFA), em todos os caminhos de login que podem exibir uma página:

  • Login com senha, código de verificação ou provedor social na página de login.
  • Login com passkey (WebAuthn).
  • Login com Kerberos.

Os caminhos que enviam apenas uma senha não podem solicitar um segundo fator. Eles recusam usuários com MFA habilitado:

PathResult for a user with MFA enabled
Bind to the built-in LDAP serverinvalidCredentials with the user has MFA enabled and cannot bind with a password
Sign-in with ?username=<owner>/<name>&password=<password> in the URLthe user: <owner>/<name> has MFA enabled and cannot sign in with a password in the URL
Concessão de senha OAuth 2.0 e solicitação de token implícito com senha (OAuth 2.0)invalid_grant com the user has MFA enabled and cannot sign in with a password grant, please use the authorization code flow

Esses caminhos também recusam um usuário quando a organização tem Disable signin ativado, ou quando o usuário ainda precisa atualizar a senha ou configurar um método MFA obrigatório. O usuário conclui a alteração da senha ou a configuração de MFA primeiro na página de login. O login via URL verifica adicionalmente as restrições de IP da organização.

Limite de códigos incorretos​

Códigos MFA incorretos e códigos de recuperação incorretos contam contra o Failed signin limit e o Failed signin frozen time da aplicação do usuário: a aplicação com a qual o usuário se inscreveu, ou a aplicação padrão da organização. Os padrões são 5 tentativas e 15 minutos. Após muitos códigos incorretos, o Casdoor recusa novos códigos até que o tempo de congelamento tenha passado.

O Casdoor conta os códigos MFA incorretos separadamente das senhas incorretas. O limite também se aplica à verificação de código durante a configuração de MFA e à verificação de senha única baseada em tempo (TOTP) do servidor RADIUS integrado.

Alterando seu método MFA preferido​

Vários métodos MFA podem ser adicionados; apenas o preferido é usado no login.

Se você quiser definir um método MFA preferido, clique no botão "Definir preferido".

preferred_mfa_method

Um rótulo "Preferido" será exibido no seu método preferido.

Desativando autenticação de múltiplos fatores​

Se você quiser desativar a autenticação de múltiplos fatores, clique no botão "Desativar". Todas as suas configurações de autenticação de múltiplos fatores serão deletadas.

disable_mfa