2FA no Proxmox: TOTP e chaves de recuperação no login

Como ligar o 2FA com TOTP no Proxmox VE 9, gerar as chaves de recuperação e voltar pelo pveum se você perder o celular ou o login for bloqueado.

Publicado
Leitura
6 min
Testado em
Proxmox VE 9
Neste post

A interface web do Proxmox é a chave do homelab inteiro. Quem entra nela como root@pam pode apagar containers, restaurar backups por cima, abrir um console em qualquer guest e mexer na rede. E, por padrão, ela pede só usuário e senha.

O Proxmox já traz autenticação em dois fatores (2FA) pronta, sem instalar nada. Neste post mostro como ligar o TOTP, por que gerar as chaves de recuperação logo em seguida e o que fazer se o celular sumir. Tudo pela documentação oficial do Proxmox VE 9.

Os tipos de segundo fator #

Pela documentação, cada usuário pode configurar sozinho três tipos:

TipoO que éPrecisa de preparo no servidor?
TOTPCódigo de 6 dígitos que muda a cada 30 segundos, num app do celularNão
WebAuthnChave física (YubiKey e similares) ou o próprio aparelho, como passkeySim: certificado HTTPS confiável e configuração do WebAuthn
Chaves de recuperaçãoLista de códigos de uso único, para emergênciaNão

Existe ainda o YubiKey OTP, mas ele é configurado no realm inteiro e exige uma API da Yubico ou um servidor próprio de validação. Para um homelab, eu começaria pelo TOTP mais as chaves de recuperação, que não exigem nada além de um app de autenticação.

Ligando o TOTP #

O caminho na interface:

  1. Entre como o usuário que vai ganhar o segundo fator.
  2. Abra Datacenter → Permissions → Two Factor.
  3. Clique em Add → TOTP.
  4. Dê uma Description (por exemplo, o nome do celular). Em Secret, use Randomize para gerar a chave. O campo Issuer Name é opcional e ajuda a identificar a conta no app (por exemplo, pve-casa).
  5. Leia o QR code com o app de autenticação do celular.
  6. Digite o código que o app mostrar em Verify Code. Fora do root, o Proxmox também pede a senha atual.
  7. Clique em Add.
Janela Add a TOTP login factor do Proxmox VE, com usuário, descrição, chave secreta, QR code e código de verificação
Janela de cadastro do TOTP. Imagem: Proxmox VE (GNU FDL).

A documentação cita o FreeOTP como exemplo de app, mas qualquer app TOTP padrão funciona. Se você já usa um gerenciador de senhas que gera códigos TOTP, como o Vaultwarden, ele também serve. Só pense bem antes de colocar o segundo fator no mesmo lugar da senha: se esse cofre vazar, os dois fatores vazam juntos. Falei do cofre da família no post sobre o Vaultwarden no homelab.

As chaves de recuperação, logo em seguida #

Este é o passo que muita gente pula. Se o celular quebrar ou for perdido, o TOTP vai junto, e você fica do lado de fora.

As chaves de recuperação não exigem preparo. No mesmo painel, Datacenter → Permissions → Two Factor, clique em Add → Recovery Keys. O Proxmox mostra uma lista de códigos:

  • cada código funciona uma vez só;
  • cada usuário tem um conjunto de cada vez: gerar outro substitui o anterior.

Guarde essa lista longe do celular: impressa numa gaveta, num cofre de senhas que não dependa do celular ou nos dois. É a mesma lógica do backup: a cópia de emergência não pode estar no mesmo lugar do original, como contei no post sobre RAID e backup.

O bloqueio por tentativas #

O segundo fator protege contra senha vazada, mas um código de 6 dígitos poderia ser descoberto por força bruta. Por isso o Proxmox bloqueia depois de muitas tentativas erradas. Pela documentação:

  • TOTP: depois de 8 tentativas erradas, os fatores TOTP do usuário são desativados. Eles voltam quando o usuário entra com uma chave de recuperação.
  • WebAuthn e chaves de recuperação: o limite é maior, 100 tentativas, mas quando estoura, todos os segundos fatores ficam bloqueados por uma hora.

Se o TOTP era o único fator e foi bloqueado, só um administrador resolve. A própria documentação recomenda, nesse caso, pedir a troca de senha na hora: 8 erros seguidos no código, depois de a senha estar certa, é um bom sinal de que alguém tem a sua senha.

Perdi o celular: como voltar #

Se você ainda tem as chaves de recuperação, entre com uma delas no lugar do código e configure um TOTP novo.

Se não tem, o caminho é pelo shell do host. O 2FA da interface web não vale para o SSH, que segue as regras do sshd. Por isso, acesso por SSH com chave é o seu plano B. No meu caso, o SSH do host passa pelo Cloudflare Tunnel, como contei no post sobre SSH sem porta 22 aberta.

Pelo terminal do host, o pveum resolve:

# Ver os segundos fatores configurados
pveum user tfa list root@pam

# Destravar um usuário bloqueado por tentativas
pveum user tfa unlock root@pam

# Remover os segundos fatores do usuário (todos, se não passar --id)
pveum user tfa delete root@pam

O unlock só tira o bloqueio por tentativas. O delete remove o fator, e aí você configura um novo pela interface.

Exigir 2FA para todo mundo #

Se mais alguém tem acesso ao Proxmox, dá para tornar o segundo fator obrigatório por realm. Ao editar o realm (em Datacenter → Permissions → Realms), escolha o tipo no campo TFA. A partir daí, só entra quem já tiver o segundo fator configurado.

Cuidado com a ordem: configure o 2FA dos usuários antes de exigir. Se você exigir primeiro, quem ainda não configurou fica do lado de fora, possivelmente incluindo você.

E o WebAuthn? #

O WebAuthn é mais forte contra phishing, porque a chave confere o endereço do site. Mas ele pede duas coisas:

  • certificado HTTPS confiável, como um da Let’s Encrypt. Com o certificado autoassinado padrão, alguns navegadores avisam ou recusam;
  • a configuração em Datacenter → Options → WebAuthn Settings, com o domínio pelo qual você acessa o Proxmox.

A documentação avisa: mudar essa configuração depois pode invalidar todas as chaves já registradas. Se você acessa o Proxmox por IP hoje e pensa em trocar para um nome, decida o nome antes de registrar as chaves.

Resumindo #

  • O 2FA já vem no Proxmox. TOTP não exige nada no servidor.
  • Caminho: Datacenter → Permissions → Two Factor → Add → TOTP.
  • Gere as chaves de recuperação na mesma hora e guarde longe do celular.
  • Bloqueio: 8 erros no TOTP desativam o fator. 100 erros nos outros bloqueiam tudo por uma hora.
  • Plano B: SSH com chave no host e pveum user tfa unlock ou delete.
  • WebAuthn: só com HTTPS confiável e o domínio decidido antes.

Para um painel que controla todos os serviços da casa, são cinco minutos de configuração bem gastos.

Fontes e documentação