Pular para o conteúdo

Confirmação de identidade (step-up)

Algumas ações são sensíveis demais para valer só porque você está logado. Nelas, o painel abre um popup de confirmação de identidade (step-up). Você prova quem é de novo, o popup fecha e a ação continua de onde parou.

Classe Quando Janela
standard Ações sensíveis do dia a dia. Um login recente com segundo fator já vale. até 10 min desde a autenticação
strong Ações destrutivas, revelar segredo, tokens de API (criar, rotacionar, editar), aprovações, convidar admin ou owner e remover membro. Um login recente não basta: o popup pede uma nova prova. até 5 min desde a confirmação

Exemplos de ações strong: apagar projeto, serviço, banco ou volume, restaurar um banco sobre os dados vivos (target=same), restaurar uma versão de configuração, revelar variável sensível e credenciais de banco, criar token de API.

A confirmação usa o fator mais forte que você já tem, nesta ordem:

  1. Passkey, o fator preferido e o mais seguro.
  2. App autenticador (TOTP), código de 6 dígitos.
  3. Código enviado por e-mail, só se a sua conta não tiver nenhum dos dois acima.

Se a conta tem passkey ou autenticador, o código por e-mail não é aceito para confirmar, e a senha sozinha também não. Quem não tem nenhum fator forte confirma com o código de 6 dígitos enviado ao e-mail (vale 10 minutos). Cadastrar uma passkey ou um app autenticador deixa a confirmação mais rápida e mais segura.

O código de recuperação serve para entrar na conta, nunca para confirmar uma ação.

  1. Você pede a ação (por exemplo, apagar um projeto).
  2. O painel abre o popup Confirme sua identidade para continuar. Clique em Confirmar identidade.
  3. Uma janela de login abre. Confirme com a passkey (um toque) ou com o código do app autenticador; sem fator forte, com o código do e-mail.
  4. A janela fecha sozinha e a ação continua de onde parou.

Se o navegador bloquear a janela, use Confirmar nesta aba. Se a janela for fechada ou demorar mais de 2 minutos, aparece “Não recebemos a confirmação” e a ação não é executada: clique em Reabrir janela.

Se a ação exige passkey ou autenticador e a sua conta não tem nenhum, o popup diz “Sua conta não tem fator forte”. Clique em Cadastrar fator forte para ir à conta; o cadastro é confirmado com o código do e-mail.

Toda ação destrutiva pedida por uma pessoa exige confirmação recente, pelo fator mais forte da conta, e senha sozinha não basta. A exigência vale também para restaurar da lixeira.

Ao mexer em um fator (remover passkey, desativar o autenticador, trocar a senha), a confirmação precisa vir de outro fator que não seja o alterado. Aparece então uma janela Confirme com o que você tem, por exemplo “sua passkey ou o código do app autenticador”. Veja Conta e segurança.

  • Chamada de sessão sem a confirmação devida recebe 401 step_up_required. O corpo traz step_up_class (standard ou strong), acr_values, popup_login_url e, na classe strong de conta com fator forte, required_factors (["totp","passkey"]).
  • Token de API não abre popup. Para o token, quem confirmou a identidade foi a pessoa que o criou: criar o token exige papel admin e confirmação recente. O escopo env:reveal só vale por 30 dias desde essa confirmação; depois, os valores sensíveis voltam null até um admin criar um token novo.
  • Ações destrutivas por token exigem a permissão destroy na política do token (Tokens e escopos).