Debian 13 : tutoriel / Diagnostiquer les refus AppArmor avec un profil de test

Même si un fichier est lisible en fonction des permissions de fichier dans Debian 13, l'accès par un programme peut être refusé si le profil AppArmor ne le permet pas. Le mode enforce applique la politique, tandis que le mode complain autorise et journalise les tentatives dépourvues de règle d’autorisation, donc vous devez vérifier le mode, le chemin d'exécution et les journaux de refus ensemble.

Distinguer les permissions de fichier de la politique AppArmor

AppArmor est une fonctionnalité de sécurité Linux qui restreint les ressources auxquelles un programme peut accéder via des profils. En plus du DAC (Discretionary Access Control, contrôle d’accès discrétionnaire) basé sur le propriétaire, le groupe et les bits de permissions généraux, il applique des politiques MAC (Mandatory Access Control, contrôle d’accès obligatoire) aux programmes. Ce n'est pas parce qu'AppArmor permet l'accès que les refus provenant des permissions de fichier existantes sont supprimés.

Ici, nous copions l'exécutable cat vers un chemin dédié et attachons un profil uniquement à cette copie. Nous ne modifions pas le /usr/bin/cat original, SSH, ni les paramètres de sécurité système. Deux fichiers de test inoffensifs sont créés avec les mêmes autorisations, et il est observé si la politique affecte les résultats lorsque le même utilisateur exécute le programme dédié. Aucun fichier secret réel n'est utilisé.

Ceci n'est pas un exemple de restriction de l'accès en lecture pour l'ensemble du compte. Les utilisateurs peuvent lire des fichiers de test avec la commande cat originale sans être liés à un profil. Il s'agit d'une comparaison pour comprendre les restrictions spécifiques aux programmes, et pour protéger les données importantes sur l'ensemble du compte ou du processus, vous devez concevoir des permissions de fichiers ainsi que le chemin d'exécution réel du service. Reportez-vous aux concepts de base et aux modes dans la documentation AppArmor de Debian.

Vérifiez AppArmor et les chemins de laboratoire dédiés

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

Cette pratique a été réalisée sur une VM Debian 13 avec AppArmor 4.1.0, le fichier /sys/module/apparmor/parameters/enabled contenant Y et apparmor.service à l’état active. Ne supposez pas que l'écriture des fichiers de profil seule sur un système avec AppArmor désactivé offrira la même protection. Vous devez d'abord vérifier le noyau, la configuration du démarrage et le statut de l'installation.

Dans aa-status, distinguez le nombre et le mode des profils ainsi que les processus auxquels ils sont appliqués. Le fait qu'un nom de programme soit sur la liste ne signifie pas nécessairement que le programme est installé, en cours d'exécution ou reçoit une protection en mode enforce. Il y avait également des profils en mode enforce, complain et unconfined dans cet environnement. Si un chemin de pratique existe déjà, vérifiez le contenu précédent sans l'écraser avec une nouvelle tâche.

Préparez deux fichiers également lisibles et un lecteur dédié

Exécutez ce qui suit dans un compte avec des privilèges sudo. Assurez-vous que le dossier de test n'existe pas et que le chemin n'est pas utilisé par une autre tâche.

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

Si les prérequis pour la création du dossier ou la copie des fichiers échouent, arrêtez-vous et vérifiez le contenu existant. Les deux fichiers appartiennent à l'administrateur avec des permissions 644, et le dossier est en 755, donc les utilisateurs ordinaires peuvent également lire les fichiers. Cette copie est un fichier d'exercice séparé du cat système, et ce n'est pas un programme opérationnel où les mises à jour des paquets sont appliquées automatiquement. Supprimez-le après l'exercice.

Exécutez ces commandes dans un terminal en utilisateur ordinaire en tant que lfstudent. Un autre compte peut être utilisé s'il a les mêmes autorisations de lecture ordinaires.

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

Puisque le profil pour ce chemin n'a pas encore été chargé, le contenu des deux fichiers devrait être affiché. Si ce critère n'est pas vérifié en premier, il sera difficile de distinguer plus tard si un échec est dû à des problèmes d'autorisation ordinaires ou aux politiques AppArmor.

Écrire et valider le profil complet avant de le charger

Créez un nouveau fichier avec sudo nano /etc/apparmor.d/lf-aa19-reader et enregistrez l'intégralité du contenu suivant. Si nano n'est pas disponible, vous pouvez utiliser un autre éditeur. Si un fichier portant le même nom ou un profil chargé portant le même nom existe déjà, ne l'appliquez pas.

#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,
}

Le nom du profil est lf-aa19-reader, et le chemin qui suit est le fichier exécutable auquel le profil sera lié. r est pour les autorisations de lecture, et m est pour les autorisations de mappage de mémoire exécutable. L'abstraction de base inclut les règles d'accès communes nécessaires à l'exécution du programme. Ici, notez qu'aucune autorisation n'est donnée pour restricted.txt. Aucune règle de refus explicite n'a été ajoutée.

Le chemin, les virgules et la structure d’inclusion suivent la syntaxe des profils apparmor.d. N'utilisez pas cet exemple court comme une politique de sécurité complète pour d'autres services complexes. Si les bibliothèques requises, les fichiers ou les transitions de processus diffèrent, la portée autorisée différera également.

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

-Q est traité sans être chargé dans le noyau, et -K n'utilise pas de lectures ou écritures en cache. Même si la première commande se termine sans erreur, ce profil ne devrait pas encore exister pour le deuxième contrôle. grep ne doit trouver aucune correspondance à ce stade ; son code de sortie 1 est attendu. Si la vérification échoue, modifiez et revérifiez, mais réussir la vérification ne garantit pas la politique d'accès souhaitée.

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

Après avoir chargé ou remplacé le profil avec -r, vérifiez lf-aa19-reader (enforce). Les options de commande peuvent être trouvées dans la documentation apparmor_parser. Dorénavant, le programme de lecture dédié nouvellement exécuté est la cible.

Rapprocher un refus en mode enforce du journal du noyau

Exécutez à nouveau les deux mêmes demandes depuis un terminal utilisateur classique. Le chargement du profil nécessite des privilèges administratifs, mais la comparaison de lecture du fichier est effectuée en tant que même utilisateur qu'auparavant.

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

Le fichier allowed.txt devrait être affiché, tandis que la lecture de restricted.txt devrait échouer avec le code de sortie 1. Le message anglais est Permission denied ; sa traduction dépend de la langue du système. Étant donné que les permissions du fichier n'ont pas été modifiées, cette différence peut être liée à la politique. Vérifiez le journal du noyau avec des privilèges administratifs.

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

Les champs clés des refus observés lors de l'exercice sont les suivants. Le PID (identifiant du processus), l’horodatage et l’identifiant utilisateur varient en fonction de l'environnement d'exécution, donc seuls les champs nécessaires pour la comparaison sont affichés.

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

Vérifiez si le profil, le chemin du fichier et les autorisations demandées correspondent à l'opération que vous venez d'effectuer. S'il n'y a pas de journal, vérifiez la plage horaire, les autorisations d'accès au journal du noyau et si le profil est réellement lié. Toutes les défaillances, des fichiers manquants aux refus DAC, ne sont pas enregistrées dans le même journal AppArmor. Utiliser chmod 777 sans vérification ou désactiver complètement AppArmor n'est pas une solution pour le dépannage.

Comparer la lecture et sa journalisation en mode complain

Rechargez uniquement le profil d'exercice dédié en mode complain.

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

Après avoir vérifié l'affichage en mode complain, essayez de lire à nouveau restricted.txt en tant qu'utilisateur normal.

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

Cette fois, le contenu devrait s'afficher, avec un code de sortie 0. Vérifier à nouveau le journal du noyau montrera que apparmor="ALLOWED" a été enregistré avec le même profil et chemin. Dans cet exercice, nous avons confirmé qu'une lecture sans règle allow réelle peut réussir et être néanmoins enregistrée.

Le mode complain ne fournit pas le même comportement de blocage que le mode enforce. Cependant, les règles de refus explicite peuvent toujours refuser l'accès en mode complain. Par conséquent, cette comparaison a utilisé l'omission des règles allow sans utiliser de refus explicite. Si vous modifiez tous les accès observés dans les journaux en règles allow de manière inconditionnelle, cela peut inclure des accès incorrects du programme dans la politique. Tout d'abord, déterminez si l'action est réellement nécessaire.

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

Après avoir terminé la comparaison, vérifiez que le profil est revenu en mode enforce. Cette commande est la méthode de restauration dans cet exemple où il n'y a pas d’indicateur complain dans le profil du fichier. Si d'autres profils ont des paramètres de mode permanent, vous devez également vérifier ces paramètres.

Autoriser un chemin exact, puis rétablir la restriction

N'ajoutez le chemin exact que si la lecture de restricted.txt est déterminée comme une fonction légitime du programme. Ne commencez pas par ouvrir largement tout un dossier comme /srv/** r,. Conservez le profil original afin qu'il puisse être restauré au contenu complet montré ci-dessus, puis ajoutez une ligne juste en dessous des règles de allowed.txt de /etc/apparmor.d/lf-aa19-reader, avant l'accolade de fermeture.

    /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

Si vous exécutez à nouveau la lecture de restricted.txt en tant qu'utilisateur normal tout en maintenant enforce, cela devrait réussir. Cela résulte du fait de n'autoriser que l'accès nécessaire sans modifier les permissions du fichier ni la fonctionnalité générale de sécurité. Pour revenir en arrière, supprimez uniquement la ligne ajoutée, validez le profil avec -Q -K, rechargez avec -r -K et confirmez que la même lecture est de nouveau refusée. Dans l'exercice, cette autorisation et cette réversion ont également été comparées.

Tout d'abord, vérifiez si le profil du paquet réel inclut le fichier supplémentaire local/. Vous ne pouvez gérer que les règles locales dans ce chemin si un tel include existe. Ne créez pas simplement un fichier en supposant une connexion include inexistante, ou ne modifiez pas directement le fichier partagé abstractions/base, car cela pourrait affecter d'autres profils qui l'incluent.

Décharger et supprimer uniquement le profil du laboratoire

Le lecteur se ferme après chaque requête. Une fois que le lecteur de laboratoire a terminé, déchargez son profil du noyau avant de supprimer le fichier de profil.

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

-R supprime le profil. Après avoir confirmé qu'il n'apparaît plus dans les requêtes, exécutez le programme dédié en tant qu'utilisateur normal pour relire restricted.txt. Ce résultat démontre une comparaison montrant que la politique a été supprimée, et non que les permissions générales du fichier ont été renforcées.

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

Le service AppArmor et les profils existants doivent être maintenus. Dans la vérification de cet exercice, il a été confirmé en comparant les noms des profils et les listes de modes avant et après qu'ils ont été conservés tels quels. Le nettoyage ne consiste pas à désactiver toutes les fonctionnalités ; il supprime uniquement le profil, l'exécutable et les données de test créés cette fois-ci.