Debian 13 : tutoriel / Isoler un service avec les restrictions systemd et rétablir ses écritures
Exécuter des services dans Debian 13 sous des comptes dédiés et limiter leurs écritures persistantes aux répertoires d’état nécessaires facilite la gestion. NoNewPrivileges · ProtectSystem · StateDirectory ont des rôles différents, il faut donc les appliquer étape par étape, et il faut vérifier séparément que le processus est actif et que la fonction attendue réussit.
Séparer la propriété des comptes des restrictions de service
Ce tutoriel crée un service de vérification d'écriture en boucle locale uniquement sur Debian 13 avec systemd 257 et Python 3.13. Des comptes dédiés séparent la propriété des fichiers des autres utilisateurs, et les restrictions de systemd limitent davantage la visibilité du système de fichiers et la portée d'acquisition des privilèges pour ce service. Ces restrictions peuvent compléter les politiques basées sur les chemins dans le laboratoire sur les profils AppArmor, mais les mécanismes sont différents.
| Paramètres | Rôles à vérifier dans cet exercice |
|---|---|
| User / Group | Exécution du processus sous UID (identifiant utilisateur) et GID (identifiant de groupe) dédiés |
| NoNewPrivileges | Empêcher l'acquisition de nouveaux privilèges via l'exécution ultérieure du programme ; ne bloque pas lui-même l'écriture de fichiers |
| ProtectSystem=strict | Application de restrictions en lecture seule étendues à la vue du système de fichiers du service |
| ProtectHome=true | Restreindre l'accès aux chemins liés au répertoire personnel |
| PrivateTmp=true | Fournir un répertoire temporaire séparé pour le service ; distinct de l'isolation complète du système de fichiers |
| StateDirectory | Préparer un chemin d'état persistant appartenant au service et fournir des variables d'environnement |
Ne copiez pas chaque restriction dans chaque service. Les exécutables stockés dans les répertoires personnels, les fichiers temporaires partagés avec d'autres programmes et les chemins supplémentaires inscriptibles peuvent être affectés. Consultez le manuel Debian 13 systemd.exec ainsi que le comportement réel du service.
Vérifiez les conflits et créez un compte de service
Le nouveau compte est lf-svc20, et le service est lf-service20.service. Il ne devrait y avoir aucun compte, groupe, unité ou dossier existant portant les mêmes noms. Ne pas écraser ou supprimer les éléments existants trouvés dans les requêtes ci-dessous avec cet exemple.
getent passwd lf-svc20
getent group lf-svc20
systemctl show lf-service20.service -p LoadState
ls -ld /var/lib/lf-service20 /opt/lf-service20-scratch
ls -l /usr/local/libexec/lf-service20.py
sudo ss -lntp 'sport = :8080'
python3 --version
curl --version
Conditions initiales : les requêtes de compte/groupe ne renvoient aucun résultat, l’unité affiche LoadState=not-found, les fichiers n'existent pas, et le port 8080 n'a aucune ligne en écoute. Si Python ou curl sont manquants, vérifiez la liste des modifications de paquets proposées et préparez-vous avec sudo apt install --no-install-recommends python3 curl. Pour les chemins et les paramètres de service, utilisez unité systemd et procédures d'application drop-in.
sudo adduser --system --group --no-create-home --home /nonexistent --shell /usr/sbin/nologin lf-svc20
getent passwd lf-svc20
id lf-svc20
sudo passwd -S lf-svc20
sudo install -d -m 750 -o lf-svc20 -g lf-svc20 /opt/lf-service20-scratch
sudo install -d /usr/local/libexec
Créez des comptes et des groupes système portant le même nom, et n'utilisez pas de shell de connexion normal ni ne créez de répertoire personnel. Ne donnez pas au nouveau compte le groupe sudo ni de mot de passe de connexion. L'UID et le GID sont attribués automatiquement, donc ne fixez pas de numéros d'exemple. Le shell nologin est un paramètre pour le distinguer des connexions interactives et n'empêche pas systemd d'exécuter des programmes avec cet UID. Pour le comportement de création de compte, référez-vous à la documentation Debian adduser.
/opt/lf-service20-scratch est un dossier de comparaison. Donnez au compte dédié la permission d'écriture ordinaire sur ce répertoire, et vérifiez plus tard si la restriction en lecture seule du service empêche l'écriture. N'utilisez pas de fichiers d'application réels.
Écrivez le programme complet de test d'écriture HTTP
Enregistrez l'intégralité du contenu suivant dans sudo nano /usr/local/libexec/lf-service20.py. Vous pouvez utiliser des éditeurs autres que nano. Gardez l'exécutable appartenant à l'administrateur et autorisez uniquement l'accès en lecture au compte de service.
import json
import os
from http.server import BaseHTTPRequestHandler, HTTPServer
from pathlib import Path
def write_probe(path):
try:
path.write_text("write-probe-ok\n", encoding="utf-8")
return {"ok": True, "errno": None}
except OSError as error:
return {"ok": False, "errno": error.errno}
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
if self.path != "/health":
self.send_error(404)
return
required_dir = Path(os.environ.get("LF_WRITE_DIR", os.environ["STATE_DIRECTORY"]))
required = write_probe(required_dir / "required.txt")
outside = write_probe(Path("/opt/lf-service20-scratch/outside.txt"))
payload = json.dumps({"uid": os.getuid(), "required": required, "outside": outside}).encode()
self.send_response(200 if required["ok"] else 503)
self.send_header("Content-Type", "application/json")
self.send_header("Content-Length", str(len(payload)))
self.end_headers()
self.wfile.write(payload)
HTTPServer(("127.0.0.1", 8080), Handler).serve_forever()
Ce programme effectue deux écritures de test pour chaque demande /health. La réponse utilise JSON (JavaScript Object Notation), un format d’échange de données structurées. Le champ required décrit le résultat d’écriture dans le répertoire d’état nécessaire et outside celui du répertoire de comparaison. Si l'écriture requise échoue, il est conçu pour renvoyer HTTP 503 au lieu de terminer le processus. Ce comportement est destiné à la pratique pour observer les erreurs et il n'est généralement pas recommandé d'écrire des fichiers à chaque fois lors des vérifications de l'état opérationnel.
Puisqu'il utilise STATE_DIRECTORY fourni par systemd, il est exécuté via l'unité ci-dessous. Ne lancez pas directement le programme depuis un terminal dépourvu de cette variable : utilisez l’unité ci-dessous. Seule la bibliothèque standard est utilisée, donc l'installation de pip n'est pas nécessaire. Il écoute uniquement sur loopback et n'est pas un serveur web de production.
sudo chmod 644 /usr/local/libexec/lf-service20.py
ls -l /usr/local/libexec/lf-service20.py
Créer le service de base et son répertoire d'état
Enregistrez-le dans sudo nano /etc/systemd/system/lf-service20.service.
[Unit]
Description=Lesson 20 service write probe
[Service]
Type=exec
User=lf-svc20
Group=lf-svc20
ExecStart=/usr/bin/python3 /usr/local/libexec/lf-service20.py
StateDirectory=lf-service20
StateDirectoryMode=0750
UMask=0027
[Install]
WantedBy=multi-user.target
Le StateDirectory=lf-service20 du service système prépare /var/lib/lf-service20, et dans cet exemple, l'utilisateur et le groupe spécifiés ainsi que le mode 0750 sont utilisés. Le chemin est transmis au programme en tant que variable d'environnement STATE_DIRECTORY. Le code et la configuration appartiennent à l'administrateur, tandis que les fichiers d'état modifiables appartiennent à un compte dédié pour différencier la propriété.
sudo systemd-analyze verify /etc/systemd/system/lf-service20.service
sudo systemctl daemon-reload
sudo systemctl start lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
sudo stat -c '%U:%G %a %n' /var/lib/lf-service20
systemctl show lf-service20.service -p User -p Group -p MainPID
Après le démarrage normal, HTTP 200 est attendu, avec ok: true pour required et outside. Le dossier d'état est affiché comme lf-svc20:lf-svc20 avec le mode 750. Puisqu'il n'y a pas encore de restrictions sur le système de fichiers, il peut également être écrit dans le dossier de comparaison. Le court délai jusqu'à ce que le port soit prêt immédiatement après le démarrage est géré avec un nombre limité de réessais curl, et si l'échec continue, vérifiez les erreurs dans le journal.
Appliquer les restrictions de privilèges et de système de fichiers par étapes
Vérifiez d’abord avec ls -ld /etc/systemd/system/lf-service20.service.d que le répertoire des compléments n’existe pas non plus. S’il existe, arrêtez-vous et examinez son contenu et son propriétaire. Créez ensuite ce répertoire avec sudo install -d /etc/systemd/system/lf-service20.service.d, et enregistrez-le dans sudo nano /etc/systemd/system/lf-service20.service.d/20-privileges.conf.
[Service]
NoNewPrivileges=true
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
service_pid=$(systemctl show lf-service20.service -p MainPID --value)
sudo grep '^NoNewPrivs:' /proc/"$service_pid"/status
Vérifiez que les deux écritures continuent de réussir et que NoNewPrivs est réglé sur 1. Cette option empêche le processus et ses enfants d'obtenir de nouveaux privilèges lors de l'exécution d'un autre programme. Par exemple, elle cible l'obtention de privilèges via les paramètres setuid qui permettent l'exécution avec les privilèges du propriétaire du fichier. Il ne faut pas interpréter que tout accès aux fichiers est restreint simplement parce que cette option est activée. Ensuite, écrivez sudo nano /etc/systemd/system/lf-service20.service.d/30-filesystem.conf.
[Service]
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
sudo systemd-analyze verify /etc/systemd/system/lf-service20.service
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
systemctl show lf-service20.service -p NoNewPrivileges -p ProtectSystem -p ProtectHome -p PrivateTmp -p StateDirectory
HTTP 200 est attendu, avec ok: true pour required et ok: false pour outside. Dans le laboratoire original, errno (numéro d’erreur du système) valait 30 pour outside, indiquant une erreur d'écriture sur un système de fichiers en lecture seule. Le chemin préparé en tant que STATE_DIRECTORY reste inscriptible comme une exception, tandis que le chemin /opt utilisé pour la comparaison devient en lecture seule du point de vue du service.
Dans ce contexte, tous les chemins écrits par le service ne sont pas limités à un seul dossier d'état. /tmp et /var/tmp, séparés avec PrivateTmp, sont également inscriptibles, et les systèmes de fichiers d’interface du noyau, tels que /dev, /proc et /sys ainsi que toute autre exception explicite doivent également être pris en compte. Cet exercice compare la limitation des écritures aux chemins généraux non nécessaires tout en maintenant les chemins d'état persistants requis.
Ceci ne rend pas l'ensemble du système de fichiers hôte en lecture seule. Pour comparer l'écriture en dehors du service avec le même UID, vous pouvez créer puis supprimer des fichiers séparés comme suit.
sudo -u lf-svc20 touch /opt/lf-service20-scratch/from-normal-context
sudo rm -- /opt/lf-service20-scratch/from-normal-context
Même si l'écriture est possible sous des permissions générales, les résultats diffèrent dans l'environnement d'exécution isolé du service. Il est possible de revoir des exceptions supplémentaires avec ReadWritePaths, mais cette option ne confère pas la propriété ou le mode du fichier lui-même. Vérifiez les chemins réellement nécessaires, et si le chemin d'état par défaut est suffisant, n'élargissez pas les exceptions.
Observer un service actif qui renvoie HTTP 503
Pour créer un exemple où les fonctionnalités et les restrictions entrent en conflit, spécifiez incorrectement un chemin d'écriture requis. Enregistrez-le dans sudo nano /etc/systemd/system/lf-service20.service.d/90-wrong-path.conf.
[Service]
Environment=LF_WRITE_DIR=/opt/lf-service20-scratch
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
systemctl is-active lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -sS -i http://127.0.0.1:8080/health
sudo journalctl -u lf-service20.service -b --no-pager -n 20
Le service est actif mais renvoie HTTP 503, et le champ ok de required vaut false. Dans cet exercice, errno 30 pour le chemin requis et HTTP 503 ont été confirmés. Le fait que le processus puisse recevoir des requêtes est différent du fait que la fonctionnalité de stockage nécessaire est normale. Dans cette requête, le --fail de curl n'a pas été utilisé pour visualiser le corps de l'erreur.
Au lieu de supprimer toutes les restrictions de sécurité, restaurez le chemin spécifié incorrectement. Supprimez seulement le fichier exemple de l'échec cette fois et redémarrez.
sudo rm -- /etc/systemd/system/lf-service20.service.d/90-wrong-path.conf
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
systemctl show lf-service20.service -p ProtectSystem -p NoNewPrivileges
Vérifiez que l’écriture required réussit et que HTTP 200 est rétabli, tout en conservant ProtectSystem=strict et NoNewPrivileges=yes. Ne supprimez pas les autres fichiers supplémentaires. Lors du diagnostic des échecs d'accès dans un service réel, considérez également l’UID et le GID, les permissions générales des fichiers, les restrictions du chemin du service et les journaux AppArmor, en modifiant uniquement les conditions ayant échoué.
Vérifier la persistance de l'état et nettoyer le laboratoire
Les fichiers dans le StateDirectory ne sont pas automatiquement supprimés lorsque le service est arrêté. Après avoir vérifié les fichiers d’état actuels, vérifiez que l’écriture réussit après avoir relancé le service.
sudo systemctl stop lf-service20.service
sudo cat /var/lib/lf-service20/required.txt
sudo systemctl start lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
La persistance du dossier d'état dans cet exemple a été confirmée en arrêtant puis en relançant le service, sans essai de redémarrage de la machine. La configuration du lien de démarrage du service est séparée, donc cet exercice l'a maintenu dans un état démarré manuellement. Lors de la suppression des données opérationnelles, il est important de distinguer que supprimer des unités et supprimer des données sont des actions distinctes.
Lors de la fin de l'exercice, arrêtez d'abord le service et supprimez uniquement ces fichiers. La suppression des données ci-dessous suppose qu'il n'y a que les fichiers de test nouvellement créés mentionnés dans ce texte.
sudo systemctl disable --now lf-service20.service
sudo rm -- /etc/systemd/system/lf-service20.service.d/20-privileges.conf /etc/systemd/system/lf-service20.service.d/30-filesystem.conf
sudo rmdir -- /etc/systemd/system/lf-service20.service.d
sudo rm -- /etc/systemd/system/lf-service20.service /usr/local/libexec/lf-service20.py
sudo systemctl daemon-reload
sudo rm -- /var/lib/lf-service20/required.txt /opt/lf-service20-scratch/outside.txt
sudo rmdir -- /var/lib/lf-service20 /opt/lf-service20-scratch
sudo userdel lf-svc20
getent passwd lf-svc20
getent group lf-svc20
sudo ss -lntp 'sport = :8080'
Confirmez que le compte a été supprimé et qu'aucun service n'écoute sur le port du laboratoire. Si un groupe dédié portant le même nom reste et n'est utilisé par aucun autre compte, supprimez uniquement ce groupe avec sudo groupdel lf-svc20. Si le dossier n'est pas vide, vérifiez la présence d'autres fichiers et ne le traitez pas avec une suppression récursive. La suppression du compte n'inclut pas une fonction pour trouver et supprimer toutes les données de l'UID, donc maintenez l'ordre en commençant d'abord par le nettoyage des chemins des données que vous avez créées.




