~/conhecimento/criando-servidor-criptografado-com-chave-no-pendrive-com-luks

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.

  1. Identificação precisa do dispositivo USB com o comando lsblk -f ou blkid. No cenário avaliado, o pendrive responde sob /dev/sdf1.
  2. Formatação da partição em sistema de arquivos nativo Linux (ext4):
    mkfs.ext4 /dev/sdf1
    
  3. Criação do ponto de montagem temporário e montagem do dispositivo:
    mkdir -p /mnt/usb
    mount /dev/sdf1 /mnt/usb
    
  4. 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
    
  5. 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:

  • :10 atrelado 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.attach avisa 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

Precisa disso implementado na sua empresa?

Eu faço o trabalho para você, com segurança e documentação.

>_ SOLICITAR ORÇAMENTO