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.
Quando o popup aparece
Seção intitulada “Quando o popup aparece”| 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.
Quais fatores valem
Seção intitulada “Quais fatores valem”A confirmação usa o fator mais forte que você já tem, nesta ordem:
- Passkey, o fator preferido e o mais seguro.
- App autenticador (TOTP), código de 6 dígitos.
- 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.
Como o popup funciona
Seção intitulada “Como o popup funciona”- Você pede a ação (por exemplo, apagar um projeto).
- O painel abre o popup Confirme sua identidade para continuar. Clique em Confirmar identidade.
- 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.
- 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.
Ações destrutivas
Seção intitulada “Ações destrutivas”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.
Dentro de Segurança da conta
Seção intitulada “Dentro de Segurança da conta”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 trazstep_up_class(standardoustrong),acr_values,popup_login_urle, na classestrongde 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
admine confirmação recente. O escopoenv:revealsó vale por 30 dias desde essa confirmação; depois, os valores sensíveis voltamnullaté um admin criar um token novo. - Ações destrutivas por token exigem a permissão
destroyna política do token (Tokens e escopos).