Tutorial de Debian 13 / Aislar un servicio systemd y diagnosticar restricciones de escritura
Ejecutar servicios en Debian 13 bajo cuentas dedicadas y limitar sus escrituras persistentes a los directorios de estado necesarios facilita la gestión. NoNewPrivileges · ProtectSystem · StateDirectory tienen diferentes roles, por lo que deben aplicarse paso a paso, y es necesario diferenciar entre que el proceso esté activo y que la funcionalidad real se ejecute correctamente.
Separe la propiedad de los archivos de las restricciones del servicio
Este tutorial crea un servicio de comprobación de escritura restringido a la interfaz local (loopback) en Debian 13 con systemd 257 y Python 3.13. Cuentas dedicadas separan la propiedad de archivos de otros usuarios, y las restricciones de systemd limitan aún más la visibilidad del sistema de archivos y el alcance de adquisición de privilegios para ese servicio. Estas restricciones pueden complementar las políticas basadas en rutas en el laboratorio de perfiles AppArmor, pero los mecanismos son diferentes.
| Configuraciones | Roles a verificar en este ejercicio |
|---|---|
| User / Group | Ejecutando el proceso bajo UID (identificador del usuario) y GID (identificador del grupo) dedicados |
| NoNewPrivileges | Evitar la obtención de nuevos privilegios a través de la ejecución posterior del programa; no bloquea por sí mismo la escritura de archivos |
| ProtectSystem=strict | Aplicar restricciones generales de solo lectura a la vista del sistema de archivos del servicio |
| ProtectHome=true | Restringir el acceso a rutas de los directorios personales |
| PrivateTmp=true | Proporcionar un directorio temporal separado para el servicio; distinto del aislamiento completo del sistema de archivos |
| StateDirectory | Preparar una ruta de estado persistente propiedad del servicio y proporcionar variables de entorno |
No copie todas las restricciones en cada servicio. Los ejecutables almacenados en directorios personales, los archivos temporales compartidos con otros programas y rutas adicionales con permisos de escritura pueden verse afectados. Consulte el manual de systemd.exec en Debian 13 junto con el comportamiento real del servicio.
Verifique conflictos y cree una cuenta de servicio
La nueva cuenta es lf-svc20 , y el servicio es lf-service20.service . No deberían existir cuentas, grupos, unidades o carpetas con los mismos nombres. No sobrescriba ni elimine elementos existentes encontrados en las consultas a continuación con este ejemplo.
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
Condiciones iniciales: las consultas de cuenta/grupo no devuelven coincidencias, la unidad muestra LoadState=not-found, los archivos no existen y el puerto 8080 no tiene líneas en escucha. Si falta Python o curl, verifique la lista de cambios de paquetes y prepárese con sudo apt install --no-install-recommends python3 curl. Para rutas y configuraciones de servicios, consulte los procedimientos de unidades systemd y archivos 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
Cree cuentas y grupos del sistema con el mismo nombre, y no use un shell de inicio de sesión normal ni cree un directorio personal. No otorgue al nuevo usuario un grupo sudo ni una contraseña de inicio de sesión. UID y GID se asignan automáticamente, por lo que no fije números de ejemplo. El shell nologin es una configuración para distinguirlo de los inicios de sesión interactivos y no impide que systemd ejecute programas con ese UID. Para el comportamiento de creación de cuentas, consulte la documentación de adduser de Debian.
/opt/lf-service20-scratch es una carpeta para comparación. Dé al usuario dedicado permiso ordinario de escritura en este directorio, y luego verifique si la restricción de solo lectura del servicio impide la escritura. No use archivos de aplicación reales.
Escriba el programa completo de prueba de escritura HTTP
Guarde todo el contenido siguiente en sudo nano /usr/local/libexec/lf-service20.py. Puede usar otro editor. Mantenga el programa como propiedad del administrador y permita acceso de solo lectura para la cuenta de servicio.
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()
Este programa realiza dos escrituras de prueba para cada solicitud de /health. La respuesta usa JSON (JavaScript Object Notation), un formato de datos estructurados. required contiene el resultado de la escritura en el directorio de estado necesario; outside contiene el resultado en el directorio de comparación. Si la escritura requerida falla, está diseñado para devolver HTTP 503 en lugar de terminar el proceso. Este comportamiento es para práctica, para observar errores y generalmente no se recomienda escribir archivos cada vez durante las verificaciones de estado operativo.
Dado que utiliza STATE_DIRECTORY proporcionado por systemd, se ejecuta a través de la unidad a continuación. No inicie el programa directamente en un terminal sin esa variable: use la unidad siguiente. Solo se utiliza la biblioteca estándar, por lo que no se requiere la instalación de pip. Escucha únicamente en el loopback y no es un servidor web de producción.
sudo chmod 644 /usr/local/libexec/lf-service20.py
ls -l /usr/local/libexec/lf-service20.py
Cree el servicio base y su directorio de estado
Guarde el contenido con 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
El StateDirectory=lf-service20 del servicio del sistema prepara /var/lib/lf-service20, y en este ejemplo, se utilizan el usuario y grupo especificados y el modo 0750. La ruta se pasa al programa como la variable de entorno STATE_DIRECTORY. El código y la configuración son propiedad del administrador, mientras que los archivos de estado modificables son propiedad de una cuenta dedicada para diferenciar la propiedad.
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
Después del inicio normal, se esperan HTTP 200 y ok: true en los campos required y outside. La carpeta de estado se muestra como lf-svc20:lf-svc20 con modo 750. Dado que todavía no hay restricciones del sistema de archivos, también se puede escribir en la carpeta de comparación. El breve retraso hasta que el puerto esté listo inmediatamente después del inicio se maneja con reintentos limitados de curl, y si continúa fallando, verifique los errores en el journal.
Aplique restricciones de privilegios y del sistema de archivos por etapas
Primero, consulte ls -ld /etc/systemd/system/lf-service20.service.d y confirme que el directorio de drop-ins tampoco existe. Si existe, deténgase y examine su contenido y propietario. Después, cree la carpeta con sudo install -d /etc/systemd/system/lf-service20.service.d, y guarde el contenido siguiente con 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
Verifique que ambas escrituras continúen teniendo éxito y que NoNewPrivs esté establecido en 1. Esta opción evita que el proceso y sus hijos obtengan nuevos privilegios al ejecutar otro programa. Por ejemplo, se enfoca en evitar la obtención de privilegios mediante configuraciones setuid que permiten la ejecución con los privilegios del propietario del archivo. No debe interpretarse que todo el acceso a archivos esté restringido solo porque esta opción esté habilitada. A continuación, escriba 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
Se esperan HTTP 200, ok: true en required y ok: false en outside. En la prueba original, errno (número de error del sistema) era 30 para outside, lo que indica un error de escritura en un sistema de archivos de solo lectura. La ruta preparada como STATE_DIRECTORY sigue permitiendo escritura como excepción, mientras que la ruta /opt utilizada para la comparación se vuelve de solo lectura desde la perspectiva del servicio.
En este entorno, no todas las rutas escritas por el servicio se limitan a una sola carpeta de estado. /tmp y /var/tmp, separadas con PrivateTmp, también permiten escritura, y los sistemas de archivos de interfaz del kernel, como /dev, /proc y /sys y cualquier otra excepción explícita también deben considerarse. Este ejercicio compara limitar las escrituras a rutas generales innecesarias mientras se mantienen las rutas de estado persistentes requeridas.
Esto no hace que todo el sistema de archivos del host sea de solo lectura. Para comparar la escritura fuera del servicio con el mismo UID, puede crear y después eliminar archivos separados de la siguiente manera.
sudo -u lf-svc20 touch /opt/lf-service20-scratch/from-normal-context
sudo rm -- /opt/lf-service20-scratch/from-normal-context
Incluso si la escritura es posible bajo permisos generales, los resultados difieren en el entorno de ejecución aislado del servicio. Es posible revisar excepciones adicionales con ReadWritePaths, pero esa opción no otorga propiedad ni modo del archivo en sí. Verifique las rutas realmente necesarias, y si la ruta de estado predeterminada es suficiente, no amplíe las excepciones.
Observe un servicio activo que devuelve HTTP 503
Para crear un ejemplo donde las funciones y las restricciones entren en conflicto, especifique únicamente una ruta de escritura necesaria incorrecta. Guarde el contenido con 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
El servicio está activo pero devuelve HTTP 503, y el campo ok de required pasa a false. La prueba original confirmó errno 30 para la ruta requerida y HTTP 503. El hecho de que el proceso pueda recibir solicitudes es diferente del hecho de que la funcionalidad de almacenamiento necesaria sea normal. En esta solicitud, no se utilizó --fail de curl para ver el cuerpo del error.
En lugar de eliminar todas las restricciones de seguridad, restaure la ruta especificada incorrectamente. Esta vez elimine solo el archivo de ejemplo fallido y reinicie.
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
Confirme que la escritura required vuelve a funcionar y la respuesta es HTTP 200, manteniendo ProtectSystem=strict y NoNewPrivileges=yes. No elimine otros archivos complementarios. Al diagnosticar fallas de acceso en un servicio real, también considere UID y GID, permisos generales de archivos, restricciones de ruta del servicio y registros de AppArmor, modificando solo las condiciones fallidas.
Verifique la persistencia del estado y retire los recursos del laboratorio
Los archivos en el StateDirectory no se eliminan automáticamente cuando el servicio se detiene. Después de verificar los archivos de estado actuales, compruebe si la escritura vuelve a funcionar después de iniciar el servicio de nuevo.
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 persistencia de la carpeta del estado en este ejemplo se confirmó en la prueba original al detener e iniciar el servicio, sin una prueba de reinicio de la VM. La configuración del enlace de inicio del servicio es independiente, por lo que este ejercicio lo mantuvo en un estado de inicio manual. Al eliminar datos operativos, es importante distinguir que eliminar unidades y eliminar datos son acciones separadas.
Al finalizar el ejercicio, detenga el servicio primero y elimine solo estos archivos. La eliminación de datos a continuación asume que solo existen los archivos de prueba recién creados mencionados en este texto.
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'
Confirme que la cuenta ha sido eliminada y que nada está escuchando en el puerto del laboratorio. Si queda un grupo dedicado con el mismo nombre y no es utilizado por otra cuenta, elimine solo ese grupo con sudo groupdel lf-svc20. Si la carpeta no está vacía, verifique si hay otros archivos y no la maneje con eliminación recursiva. La eliminación de la cuenta no incluye una función para encontrar y eliminar todos los datos del UID, por lo que mantenga el orden de primero limpiar las rutas de los datos que creó.




