Tutorial do Debian 13 / Diagnosticar bloqueios do AppArmor nos modos enforce e complain

Mesmo que um arquivo seja legível com base nas permissões de arquivo no Debian 13, o acesso por um programa pode ser negado se o perfil do AppArmor não permitir. O modo enforce aplica a política; o modo complain permite e registra os acessos sem regra de autorização, ressalvada a exceção das regras deny explicada adiante, portanto, é necessário verificar o modo, o caminho de execução e os registros de negação juntos.

Distinga as permissões de arquivo da política do AppArmor

AppArmor é um recurso de segurança do Linux que restringe os recursos que um programa pode acessar por meio de perfis. Além do DAC (Discretionary Access Control, controle de acesso discricionário) baseado em proprietário, grupo e bits de permissão gerais, ele aplica políticas MAC (Mandatory Access Control, controle de acesso obrigatório) aos programas. Só porque o AppArmor permite o acesso, não significa que as negações das permissões de arquivo existentes sejam removidas.

Aqui, copiamos o executável cat para um caminho dedicado e anexamos um perfil apenas a essa cópia. Não modificamos o /usr/bin/cat original, SSH ou configurações de segurança de todo o sistema. Dois arquivos de teste inofensivos são criados com as mesmas permissões, e observa-se se a política afeta os resultados quando o mesmo usuário executa o programa dedicado. Arquivos secretos reais não são utilizados.

Isto não é um exemplo de restrição de acesso de leitura para toda a conta. Os usuários podem ler arquivos de teste com o comando cat original sem estarem vinculados a um perfil. Esta é uma comparação para entender restrições específicas de programas e, para proteger dados importantes em toda a conta ou processo, você precisa projetar permissões de arquivo juntamente com o caminho real de execução do serviço. Consulte os conceitos básicos e modos na documentação AppArmor do Debian.

Verifique o AppArmor e os caminhos dedicados ao laboratório

cat /sys/module/apparmor/parameters/enabled
systemctl is-active apparmor.service
dpkg-query -W apparmor
sudo aa-status
ls -l /usr/local/libexec/lf-aa19-reader /etc/apparmor.d/lf-aa19-reader
ls -ld /srv/lf-aa19

O teste do curso original foi realizado em uma VM Debian 13 com AppArmor 4.1.0, o arquivo /sys/module/apparmor/parameters/enabled contendo Y e apparmor.service no estado active. Não presuma que apenas escrever arquivos de perfil em um sistema com AppArmor desativado fornecerá a mesma proteção. É necessário verificar primeiro o kernel, a configuração de inicialização e o status da instalação.

Em aa-status, diferencie o número e o modo dos perfis e os processos aos quais eles são aplicados. O fato de o nome de um programa estar na lista não significa necessariamente que o programa esteja instalado, em execução ou recebendo proteção no modo enforce. Havia perfis em modo enforce, complain e unconfined juntos neste ambiente também. Se um caminho de prática já existir, verifique o conteúdo anterior sem sobrescrevê-lo com uma nova tarefa.

Prepare dois arquivos igualmente legíveis e um leitor dedicado

Execute o seguinte em uma conta com privilégios de sudo. Certifique-se de que a pasta de teste não exista e que o caminho não esteja sendo usado por outra tarefa.

sudo test ! -e /srv/lf-aa19 &&
sudo install -d -m 755 /srv/lf-aa19 &&
printf 'allowed-example\n' | sudo tee /srv/lf-aa19/allowed.txt > /dev/null &&
printf 'restricted-example\n' | sudo tee /srv/lf-aa19/restricted.txt > /dev/null &&
sudo chmod 644 /srv/lf-aa19/allowed.txt /srv/lf-aa19/restricted.txt &&
sudo install -d /usr/local/libexec &&
sudo test ! -e /usr/local/libexec/lf-aa19-reader &&
sudo install -m 755 /usr/bin/cat /usr/local/libexec/lf-aa19-reader
cmp /usr/bin/cat /usr/local/libexec/lf-aa19-reader
ls -ld /srv/lf-aa19
ls -l /srv/lf-aa19/allowed.txt /srv/lf-aa19/restricted.txt

Se os pré-requisitos para criação de pasta ou cópia de arquivos falharem, pare e verifique o conteúdo existente. Ambos os arquivos são de propriedade do administrador com permissões 644, e a pasta é 755, então usuários comuns também podem ler os arquivos. Esta cópia é um arquivo de prática separado do cat do sistema, e não é um programa operacional onde atualizações de pacotes são aplicadas automaticamente. Exclua-o após a prática.

Execute esses comandos em um terminal de usuário comum como lfstudent. Outra conta pode ser usada se tiver as mesmas permissões de leitura comuns.

/usr/local/libexec/lf-aa19-reader /srv/lf-aa19/allowed.txt
/usr/local/libexec/lf-aa19-reader /srv/lf-aa19/restricted.txt

Como o perfil para este caminho ainda não foi carregado, o conteúdo de ambos os arquivos deve ser exibido. Se esse critério não for verificado primeiro, será difícil distinguir depois se uma falha se deve a problemas de permissão comuns ou às políticas do AppArmor.

Escreva e valide o perfil completo antes de carregá-lo

Crie um novo arquivo com sudo nano /etc/apparmor.d/lf-aa19-reader e salve todo o conteúdo a seguir. Se nano não estiver disponível, você pode usar outro editor. Se um arquivo com o mesmo nome ou um perfil carregado com o mesmo nome já existir, não o aplique.

#include <tunables/global>
profile lf-aa19-reader /usr/local/libexec/lf-aa19-reader {
    #include <abstractions/base>
    /usr/local/libexec/lf-aa19-reader mr,
    /srv/lf-aa19/allowed.txt r,
}

O nome do perfil é lf-aa19-reader, e o caminho que segue é o arquivo executável ao qual o perfil será vinculado. r é para permissões de leitura, e m é para permissões de mapeamento de memória executável. A abstração base inclui regras de acesso comuns necessárias para a execução do programa. Aqui, observe que nenhuma permissão foi concedida para restricted.txt. Nenhuma regra de negação explícita foi adicionada.

O caminho, as vírgulas e a estrutura de inclusão seguem a sintaxe dos perfis apparmor.d. Não use este exemplo curto como uma política de segurança completa para outros serviços complexos. Se as bibliotecas, arquivos ou transições de processo exigidos forem diferentes, o escopo permitido também será diferente.

sudo apparmor_parser -Q -K /etc/apparmor.d/lf-aa19-reader
sudo grep '^lf-aa19-reader ' /sys/kernel/security/apparmor/profiles

-Q é processado sem ser carregado no kernel, e -K não usa leituras ou gravações em cache. Mesmo que o primeiro comando termine sem erros, este perfil ainda não deve existir para a segunda consulta. Nesta etapa, grep não deve encontrar correspondência; o código de saída 1 é esperado. Se a verificação falhar, modifique e verifique novamente, mas passar na verificação não garante a política de acesso desejada.

sudo apparmor_parser -r -K /etc/apparmor.d/lf-aa19-reader
sudo grep '^lf-aa19-reader ' /sys/kernel/security/apparmor/profiles

Após carregar ou substituir o perfil com -r, verifique lf-aa19-reader (enforce). As opções de comando podem ser encontradas na documentação do apparmor_parser. A partir de agora, o programa dedicado de leitura recém-executado é o alvo.

Relacione um bloqueio em enforce ao registro do kernel

Execute os mesmos dois pedidos novamente a partir de um terminal de usuário comum. Carregar o perfil requer privilégios de administrador, mas a comparação de leitura do arquivo é realizada como o mesmo usuário de antes.

/usr/local/libexec/lf-aa19-reader /srv/lf-aa19/allowed.txt
/usr/local/libexec/lf-aa19-reader /srv/lf-aa19/restricted.txt
echo $?

Espera-se que o arquivo allowed.txt seja exibido, enquanto que a leitura de restricted.txt deve falhar com código de saída 1. A mensagem em inglês é Permission denied; sua tradução depende do idioma do sistema. Como as permissões do arquivo não foram alteradas, essa diferença pode estar ligada à política. Verifique o log do kernel com privilégios administrativos.

sudo journalctl -k --since '-5 minutes' --no-pager | grep 'profile="lf-aa19-reader"'

Os campos principais das negações observadas no exercício são os seguintes. O PID (identificador do processo), o horário do evento e o identificador do usuário variam dependendo do ambiente de execução, então apenas os campos necessários para comparação são mostrados.

apparmor="DENIED" operation="open" profile="lf-aa19-reader" name="/srv/lf-aa19/restricted.txt" requested_mask="r" denied_mask="r"

Verifique se o perfil, o caminho do arquivo e as permissões solicitadas correspondem à operação que você acabou de realizar. Se não houver nenhum registro, verifique o intervalo de tempo, as permissões de acesso ao registro do kernel e se o perfil está realmente vinculado. Nem todas as falhas, desde arquivos ausentes até negações DAC, são registradas no mesmo log do AppArmor. Usar chmod 777 sem verificação ou desativar completamente o AppArmor não é uma solução para resolução de problemas.

Compare a leitura e seu registro no modo complain

Recarregue apenas o perfil de exercício dedicado em modo complain.

sudo apparmor_parser -r -C -K /etc/apparmor.d/lf-aa19-reader
sudo grep '^lf-aa19-reader ' /sys/kernel/security/apparmor/profiles

Após confirmar que o perfil aparece em complain, tente ler restricted.txt novamente como um usuário comum.

/usr/local/libexec/lf-aa19-reader /srv/lf-aa19/restricted.txt
echo $?

Desta vez, espera-se que o conteúdo seja exibido, com código de saída 0. Verificar o log do kernel novamente mostrará apparmor="ALLOWED" registrado com o mesmo perfil e caminho. O teste original confirmou a leitura bem-sucedida e seu registro mesmo sem uma regra de autorização para esse caminho.

O modo complain não fornece o mesmo comportamento de bloqueio que o modo enforce. No entanto, regras de negação explícita ainda podem negar o acesso no modo complain. Portanto, essa comparação usou a omissão de regras de permissão sem usar negação explícita. Se você alterar todos os acessos observados nos logs para regras de permissão incondicionalmente, isso pode incluir acessos incorretos do programa na política. Primeiro, determine se a ação é realmente necessária.

sudo apparmor_parser -r -K /etc/apparmor.d/lf-aa19-reader
sudo grep '^lf-aa19-reader ' /sys/kernel/security/apparmor/profiles

Após terminar a comparação, confirme que o perfil voltou ao modo enforce. Este comando é o método de restauração neste exemplo, onde não há sinalizador complain no perfil do arquivo. Se outros perfis tiverem configurações em modo permanente, você também deve verificar essas configurações.

Autorize um caminho exato e restaure a restrição

Adicione o caminho exato apenas se for determinado que ler restricted.txt é uma função legítima do programa. Não comece abrindo amplamente uma pasta inteira como /srv/** r,. Mantenha o perfil original para que ele possa ser restaurado para o conteúdo completo mostrado acima, depois adicione uma linha logo abaixo das regras de allowed.txt de /etc/apparmor.d/lf-aa19-reader, antes da chave de fechamento.

    /srv/lf-aa19/restricted.txt r,
sudo apparmor_parser -Q -K /etc/apparmor.d/lf-aa19-reader
sudo apparmor_parser -r -K /etc/apparmor.d/lf-aa19-reader
sudo grep '^lf-aa19-reader ' /sys/kernel/security/apparmor/profiles

Se você executar a mesma leitura de restricted.txt novamente como um usuário normal mantendo o enforce, isso deve ser bem-sucedido. Este é o resultado de permitir apenas o acesso necessário sem alterar as permissões do arquivo ou a funcionalidade geral de segurança. Para reverter, remova apenas a linha adicionada, valide o perfil com -Q -K, recarregue com -r -K e confirme que a mesma leitura é negada novamente. No exercício, essa permissão e reversão também foram comparadas.

Primeiro, verifique se o perfil real do pacote inclui o arquivo suplementar local/. Você só pode gerenciar regras locais nesse caminho se tal inclusão existir. Não crie apenas um arquivo assumindo uma conexão de inclusão inexistente, nem modifique diretamente o arquivo compartilhado abstractions/base, pois isso poderia afetar outros perfis que a incluam.

Descarregue e remova apenas o perfil do laboratório

O leitor sai após cada solicitação. Uma vez que o leitor do laboratório tenha terminado, descarregue seu perfil do kernel antes de excluir o arquivo de perfil.

sudo apparmor_parser -R /etc/apparmor.d/lf-aa19-reader
sudo grep '^lf-aa19-reader ' /sys/kernel/security/apparmor/profiles

-R remove o perfil. Após confirmar que ele não aparece mais nas consultas, execute o programa dedicado como um usuário normal para ler restricted.txt novamente. Este resultado demonstra uma comparação mostrando que a política foi removida, e não que as permissões gerais do arquivo foram reforçadas.

sudo rm -- /etc/apparmor.d/lf-aa19-reader /usr/local/libexec/lf-aa19-reader
sudo rm -- /srv/lf-aa19/allowed.txt /srv/lf-aa19/restricted.txt
sudo rmdir -- /srv/lf-aa19
systemctl is-active apparmor.service
sudo aa-status

O serviço AppArmor e os perfis existentes devem ser mantidos. Na verificação do curso original, foi confirmado por meio da comparação dos nomes dos perfis e das listas de modos antes e depois que eles foram preservados como estão. A limpeza não consiste em desativar todos os recursos; ela apenas remove o perfil, o executável e os dados de teste criados desta vez.