Criando servidor criptografado (com chave no pendrive) com Luks
publicado em 25/06/2026 às 12:17 atualizado em 20/11/2026 às 07:36
Documentação Técnica: Inicialização Segura com LUKS e Chave USB
Alvo: Debian 13 (Trixie) | Arquitetura: amd64 | Hostname: playground
Autor: Infraestrutura & Experimentos Linux
1. Escopo e Objetivos
Esta documentação detalha o procedimento passo a passo para configurar a descriptografia automática de uma partição de sistema criptografada com LUKS utilizando um arquivo de chave armazenado em um dispositivo de armazenamento USB (pendrive). O design da solução garante que, caso o dispositivo USB esteja ausente, o sistema realize um fallback gracioso, solicitando a senha mestra do LUKS diretamente no teclado após um período determinado de timeout.
Todos os comandos a seguir assumem a execução pelo superusuário (root).
2. Topologia Logicial do Cenário Implementado
Com base na análise do hardware físico e partições do ambiente real mapeado (host playground), os seguintes identificadores e UUIDs foram aplicados com sucesso:
| Dispositivo | Tipo / Sistema de Arquivos | UUID Identificado | Ponto de Montagem / Função |
|---|---|---|---|
/dev/sda1 |
ext4 | 6133d958-8b83-4c4e-9102-c270aec3944b |
/boot (Não Criptografado) |
/dev/sda5 |
crypto_LUKS (v2) | c908b5f8-39dc-4472-b066-223c42db86ee |
Contêiner Criptografado Base |
/dev/mapper/sda5_crypt |
LVM2 Physical Volume | 7ojUZb-onTu-...-t9EaTj |
Volume Físico Descriptografado |
/dev/sdf1 |
ext4 (USB Key) | 03f1cea3-09f1-4a2d-b348-54ffec53bfde |
Dispositivo Chave (Pendrive) |
3. Passo 1: Preparação da Mídia USB e Geração da Chave
Com o sistema iniciado através da senha tradicional inserida manualmente durante a instalação, o dispositivo USB foi espetado e preparado para armazenar o segredo criptográfico aleatório.
- Identificação precisa do dispositivo USB com o comando
lsblk -foublkid. No cenário avaliado, o pendrive responde sob/dev/sdf1. - Formatação da partição em sistema de arquivos nativo Linux (ext4):
mkfs.ext4 /dev/sdf1 - Criação do ponto de montagem temporário e montagem do dispositivo:
mkdir -p /mnt/usb mount /dev/sdf1 /mnt/usb - Geração de um arquivo de chave com 4KB de entropia pura extraída diretamente de
/dev/urandom:dd if=/dev/urandom of=/mnt/usb/chave-luks.key bs=1024 count=4 - Proteção estrita dos privilégios de acesso do arquivo de segredo:
chmod 0400 /mnt/usb/chave-luks.key
4. Passo 2: Vinculando a Nova Chave ao Slot LUKS
O LUKS permite múltiplos slots de senhas independentes. O arquivo recém-criado foi injetado como um segredo autorizado a abrir o contêiner /dev/sda5 sem invalidar a senha de instalação (passphrase mestra).
cryptsetup luksAddKey /dev/sda5 /mnt/usb/chave-luks.key
Nota: O comando exigirá a digitação da senha atual configurada na instalação para homologar a adição do novo slot.
5. Passo 3: Implementando o Script de Intermediação e Fallback
O script nativo passdev entra em loop de repetição cego caso o pendrive não seja localizado, estourando o limite de tentativas sem abrir o terminal para digitação. Para contornar essa falha de arquitetura, foi desenvolvido e implementado um script wrapper inteligente em /usr/local/bin/pendrive-ou-senha.
Execute a criação do arquivo:
vim /usr/local/bin/pendrive-ou-senha
Injete o seguinte código estruturado em POSIX Shell (aperte 'i' no vim para modo de inserção, e depois ESC, :wq para salvar):
#!/bin/sh
# Script de Intermediação para Descriptografia LUKS via USB / Teclado
# Desenvolvido para contornar loops de indisponibilidade do cryptsetup
if ! /lib/cryptsetup/scripts/passdev "$1" 2>/dev/null; then
echo ""
echo "======================================================"
echo "AVISO: Chave USB nao localizada nas portas do host."
echo "======================================================"
/lib/cryptsetup/askpass "Digite a senha mestra do LUKS para liberar o boot: "
fi
Atribua direitos de execução imediatos ao binário:
chmod +x /usr/local/bin/pendrive-ou-senha
6. Passo 4: Persistência do passdev via Gatilho do Initramfs
Como o script customizado não invoca explicitamente o nome do pacote passdev nas dependências estruturais diretas do arquivo de configuração do crypttab, o utilitário initramfs-tools poderia expurgar o binário do ambiente de pré-boot. Para forçar sua inclusão permanente, criou-se um gancho (hook):
vim /etc/initramfs-tools/hooks/incluir-passdev
Conteúdo do script de hook:
#!/bin/sh
PREREQ=""
prereqs() { echo "$PREREQ"; }
case "$1" in
prereqs) prereqs; exit 0 ;;
esac
. /usr/share/initramfs-tools/hook-functions
copy_exec /lib/cryptsetup/scripts/passdev /lib/cryptsetup/scripts/passdev
Garantia de execução do hook:
chmod +x /etc/initramfs-tools/hooks/incluir-passdev
7. Passo 5: Ajustando o Arquivo de Mapeamento Criptográfico (/etc/crypttab)
O arquivo /etc/crypttab dita como os dispositivos criptográficos devem ser montados no início do carregamento. A configuração final aponta para o script intermediário e estipula um limite rígido de 10 segundos de timeout na busca pelo UUID do pendrive.
Edite o arquivo:
vim /etc/crypttab
Substitua a linha de definição do sda5_crypt pelo conteúdo consolidado abaixo (em linha única contínua):
sda5_crypt UUID=c908b5f8-39dc-4472-b066-223c42db86ee /dev/disk/by-uuid/03f1cea3-09f1-4a2d-b348-54ffec53bfde:/chave-luks.key:10 luks,keyscript=/usr/local/bin/pendrive-ou-senha,x-initrd.attach
Significado Prático das Opções:
:10atrelado ao caminho do arquivo determina que o barramento USB será escaneado por exatos 10 segundos antes do script desistir.keyscript=...transfere o controle do fluxo lógico para o nosso script wrapper.x-initrd.attachavisa ao gerenciador do sistema para não reprocessar ou tentar abrir o disco novamente na segunda fase.
8. Passo 6: Neutralização de Conflitos com o Systemd
Por se tratar de um volume mapeado que abriga o diretório raiz (/), o systemd em sua fase tardia de inicialização tenta remontar a infraestrutura lendo o arquivo primitivo do crypttab, gerando falsos positivos vermelhos de falha de dependências (Failed to mount run-systemd-cryptsetup...).
Para sanar a redundância de forma limpa e definitiva no Linux, o serviço nativo pós-boot foi completamente mascarado no sistema operacional:
systemctl mask systemd-cryptsetup@sda5_crypt.service
9. Passo 7: Compilação das Alterações no Microkernel (Initramfs)
Para fixar todas as alterações nas tabelas de blocos, ganchos e scripts dentro da imagem de boot executada pelo GRUB, compilou-se o ramdisk inicial do kernel ativo:
update-initramfs -u
Nota: Mensagens contendo avisos de opções ignoradas ("unknown option") exibidas pelo utilitário cryptsetup durante a compilação são normais e esperadas.
10. Manutenção: Alteração da Senha Mestra (Passphrase)
Para alterar a senha primária digitada manualmente no teclado, utilize o comando nativo do LUKS para troca de chaves. O sistema solicitará qualquer senha ou chave válida atual para autorizar a operação e, em seguida, pedirá a nova senha duas vezes.
cryptsetup luksChangeKey /dev/sda5
Dica Operacional: Esta ação altera apenas a senha mestra. A chave do pendrive, que reside em outro slot LUKS, permanecerá inalterada e funcionando perfeitamente.
11. Manutenção: Substituição do Pendrive (Em Caso de Extravio)
Caso o pendrive original seja perdido ou danificado, é estritamente necessário revogar o acesso dele para garantir a segurança e, em seguida, gerar um novo dispositivo. O sistema deverá ser inicializado utilizando a senha mestra.
1. Identificar e Revogar o Pendrive Antigo:
Verifique quais "slots" (espaços de chave) estão em uso no disco. Normalmente, a senha mestra fica no Slot 0 e o pendrive no Slot 1. Liste os slots ativos com o comando:
cryptsetup luksDump /dev/sda5
Após confirmar o slot que precisa ser destruído (aquele correspondente ao pendrive perdido), inutilize-o (substitua "X" pelo número do slot, por exemplo, 1):
cryptsetup luksKillSlot /dev/sda5 X
2. Preparar o Novo Pendrive:
Siga os mesmos passos de formatação e geração de entropia vistos no Passo 1 para o novo dispositivo (ajustando o caminho /dev/sdX1 conforme detectado no novo hardware):
mkfs.ext4 /dev/sdX1
mount /dev/sdX1 /mnt/usb
dd if=/dev/urandom of=/mnt/usb/chave-luks.key bs=1024 count=4
chmod 0400 /mnt/usb/chave-luks.key
3. Adicionar a Nova Chave ao LUKS:
Vincule o novo arquivo de chave ao seu disco. Será exigida a senha mestra atual para aprovação:
cryptsetup luksAddKey /dev/sda5 /mnt/usb/chave-luks.key
4. Atualizar o Arquivo de Mapeamento (/etc/crypttab):
Descubra o novo UUID do pendrive recém-criado com o comando blkid /dev/sdX1. Edite o crypttab e troque apenas o UUID antigo pelo novo:
vim /etc/crypttab
5. Regerar a Imagem de Boot:
Por fim, compile as novas regras de hardware e o novo UUID para dentro da inicialização do kernel:
update-initramfs -u