# 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

| 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](/operacao/historico-de-configuracao/), revelar variável sensível e credenciais de banco, criar token de API.

## Quais fatores valem

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](/conta/passkey/) ou um [app autenticador](/conta/autenticador-totp/) deixa a confirmação mais rápida e mais segura.

O [código de recuperação](/conta/codigos-de-recuperacao/) serve para entrar na conta, nunca para confirmar uma ação.

## Como o popup funciona

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.

## 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](/operacao/lixeira/).

## 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](/conta/visao-geral/).

## Na API

- 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](/seguranca/tokens-e-escopos/)).
