Tutorial de Debian 13 / Diagnosticar permisos con AppArmor y ajustar un perfil dedicado

Incluso si un archivo es legible según los permisos de archivo en Debian 13, un programa puede ser denegado para acceder si el perfil de AppArmor no lo permite. El modo enforce aplica la política; complain permite y registra los accesos sin una regla de autorización, con la excepción de las reglas deny explicada más adelante. Compruebe el modo, la ruta del ejecutable y los registros de denegación juntos.

Distinga los permisos de archivo de la política de AppArmor

AppArmor es una característica de seguridad de Linux que restringe los recursos a los que un programa puede acceder mediante perfiles. Además del DAC (Discretionary Access Control, control de acceso discrecional) basado en el propietario, grupo y bits de permiso generales, aplica políticas MAC (Mandatory Access Control, control de acceso obligatorio) a los programas. Que AppArmor permita el acceso no significa que se eliminen las denegaciones de los permisos de archivo existentes.

Aquí, copiamos el ejecutable cat a una ruta dedicada y adjuntamos un perfil solo a esa copia. No modificamos el /usr/bin/cat original, SSH ni la configuración de seguridad del sistema en general. Se crean dos archivos de prueba inofensivos con los mismos permisos, y se observa si la política afecta los resultados cuando el mismo usuario ejecuta el programa dedicado. No se utilizan archivos secretos reales.

Esto no es un ejemplo de cómo restringir el acceso de lectura para toda la cuenta. Los usuarios pueden leer archivos de prueba con el comando original cat sin estar sujetos a un perfil. Esto es una comparación para entender las restricciones específicas de programas, y para proteger datos importantes en toda la cuenta o proceso, necesita diseñar permisos de archivos junto con la ruta de ejecución real del servicio. Consulte los conceptos y modos básicos en la documentación de AppArmor de Debian.

Verifique AppArmor y las rutas dedicadas al laboratorio

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

La prueba del curso original se realizó en una máquina virtual Debian 13 con AppArmor 4.1.0, el archivo /sys/module/apparmor/parameters/enabled con el valor Y y apparmor.service en estado active. No asuma que solo escribir archivos de perfil en un sistema con AppArmor deshabilitado proporcionará la misma protección. Primero debe verificar el kernel, la configuración de arranque y el estado de la instalación.

En aa-status, distinga el número y el modo de los perfiles y los procesos a los que se aplican. El hecho de que un nombre de programa esté en la lista no significa necesariamente que el programa esté instalado, ejecutándose o recibiendo protección en modo enforce. En este entorno también había perfiles en modo enforce, complain y unconfined. Si ya existe una ruta de práctica, verifique el contenido anterior sin sobrescribirlo con una nueva tarea.

Prepare dos archivos igualmente legibles y un lector dedicado

Ejecute lo siguiente en una cuenta con privilegios de sudo. Asegúrese de que la carpeta de prueba no exista y de que la ruta no esté siendo utilizada por otra tarea.

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 los requisitos previos para la creación de carpetas o la copia de archivos fallan, deténgase y verifique el contenido existente. Ambos archivos son propiedad del administrador con permisos 644, y la carpeta es 755, por lo que los usuarios ordinarios también pueden leer los archivos. Esta copia es un archivo de práctica separado del cat del sistema, y no es un programa operativo donde las actualizaciones de paquetes se aplican automáticamente. Elimínelo después de la práctica.

Ejecute estos comandos en un terminal de usuario regular como lfstudent. Se puede usar otra cuenta si tiene los mismos permisos de lectura ordinarios.

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

Dado que el perfil para esta ruta aún no se ha cargado, se deben mostrar los contenidos de ambos archivos. Si este criterio no se verifica primero, será difícil distinguir más adelante si un fallo se debe a problemas de permisos regulares o a políticas de AppArmor.

Escriba y valide el perfil completo antes de cargarlo

Cree un archivo nuevo con sudo nano /etc/apparmor.d/lf-aa19-reader y guarde todo el contenido siguiente. Si nano no está disponible, puede usar otro editor. Si ya existe un archivo con el mismo nombre o un perfil cargado con el mismo nombre, no lo 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,
}

El nombre del perfil es lf-aa19-reader, y la ruta que sigue es el archivo ejecutable al que se vinculará el perfil. r es para permisos de lectura, y m es para permisos de asignación de memoria ejecutable. La abstracción base incluye reglas de acceso comunes necesarias para la ejecución del programa. Aquí, observe que no se ha otorgado permiso para restricted.txt. No se han añadido reglas de denegación explícitas.

La ruta, las comas y la estructura include siguen la sintaxis de los perfiles apparmor.d. No use este ejemplo corto como una política de seguridad completa para otros servicios complejos. Si las bibliotecas, archivos o transiciones de proceso requeridos difieren, el alcance permitido también diferirá.

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

-Q se procesa sin cargarse en el núcleo, y -K no utiliza lecturas o escrituras de caché. Incluso si el primer comando termina sin errores, este perfil aún no debería existir para la segunda búsqueda. En esta etapa, grep no debe encontrar coincidencias: el código de salida 1 es el resultado esperado. Si la verificación falla, modifique y vuelva a comprobar, pero aprobar la verificación no garantiza la política de acceso deseada.

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

Después de cargar o reemplazar el perfil con -r, verifique lf-aa19-reader (enforce). Las opciones del comando se pueden encontrar en la documentación de apparmor_parser. De ahora en adelante, el nuevo programa dedicado de lectura ejecutado es el objetivo.

Relacione una denegación en enforce con su registro del kernel

Ejecute las mismas dos solicitudes nuevamente desde un terminal de usuario normal. Cargar el perfil requiere privilegios de administrador, pero la comparación de lectura de archivos se realiza como el mismo usuario que antes.

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

Se espera que se muestre el archivo allowed.txt, mientras que la lectura de restricted.txt debe fallar con código de salida 1. El mensaje en inglés es Permission denied; su traducción depende del idioma del sistema. Dado que los permisos de archivo no se cambiaron, esta diferencia puede estar vinculada a la política. Verifique el registro del kernel con privilegios administrativos.

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

Los campos clave de las denegaciones observadas en el ejercicio son los siguientes. El PID (identificador del proceso), la hora del evento y el identificador del usuario varían según el entorno de ejecución, por lo que solo se muestran los campos necesarios para la comparación.

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

Verifique si el perfil, la ruta del archivo y los permisos solicitados coinciden con la operación que acaba de realizar. Si no hay registro, compruebe el rango de tiempo, los permisos de acceso al registro del kernel y si el perfil está realmente vinculado. No todos los fallos, desde archivos faltantes hasta denegaciones de DAC, se registran en el mismo registro de AppArmor. Usar chmod 777 sin control o deshabilitar AppArmor por completo no es una solución para la resolución de problemas.

Compare el acceso y su registro en modo complain

Recargue solo el perfil de ejercicio dedicado en modo "complain".

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

Después de confirmar que el perfil aparece en complain, intente leer restricted.txt nuevamente como un usuario normal.

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

Esta vez, se espera que el contenido se muestre, con un código de salida 0. Verificar nuevamente el registro del kernel mostrará que apparmor="ALLOWED" se registró con el mismo perfil y ruta. La prueba original confirmó que la lectura puede tener éxito y quedar registrada aunque no exista una regla de autorización para esa ruta.

El modo complain no proporciona el mismo comportamiento de bloqueo que el modo enforce. Sin embargo, las reglas de denegación explícitas aún pueden negar el acceso en modo complain. Por lo tanto, esta comparación utilizó la omisión de reglas de permiso sin usar denegación explícita. Si convierte todos los accesos observados en los registros a reglas de permiso de manera incondicional, puede incluir accesos incorrectos del programa en la política. Primero, determine si la acción es realmente necesaria.

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

Después de terminar la comparación, confirme que el perfil ha vuelto al modo enforce. Este comando es el método de restauración en este ejemplo donde no hay una indicador complain en el perfil del archivo. Si otros perfiles tienen configuraciones de modo permanente, también debe verificar esas configuraciones.

Autorice una ruta exacta y restaure la restricción

Solo agregue la ruta exacta si se determina que leer restricted.txt es una función legítima del programa. No comience abriendo ampliamente toda una carpeta como /srv/** r,. Mantenga el perfil original para que pueda restaurarse al contenido completo mostrado arriba, luego agregue una línea justo debajo de las reglas de allowed.txt de /etc/apparmor.d/lf-aa19-reader, antes de la llave de cierre.

    /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 ejecuta la misma lectura de restricted.txt como usuario normal manteniendo enforce, debería tener éxito. Esto es el resultado de permitir solo el acceso necesario sin cambiar los permisos del archivo ni la funcionalidad de seguridad general. Para revertir, elimine solo la línea añadida, valide el perfil con -Q -K, vuelva a cargarlo con -r -K y confirme que la misma lectura sea denegada nuevamente. La prueba original también comparó esta autorización y su revocación.

Primero, verifique si el perfil del paquete actual incluye el archivo complementario local/. Solo puede gestionar reglas locales en esa ruta si existe dicha inclusión. No cree un archivo asumiendo una conexión de inclusión inexistente, ni modifique directamente el archivo compartido abstractions/base, ya que esto podría afectar otros perfiles que la incluyen.

Descargue y elimine solo el perfil del laboratorio

El lector sale después de cada solicitud. Una vez que el lector del laboratorio ha terminado, descargue su perfil del núcleo antes de eliminar el archivo del perfil.

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

-R elimina el perfil. Después de confirmar que ya no aparece en las consultas, ejecute el programa dedicado como usuario normal para leer restricted.txt nuevamente. Este resultado demuestra una comparación que muestra que la política ha sido eliminada, no que los permisos generales del archivo se hayan fortalecido.

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

Se debe mantener el servicio AppArmor y los perfiles existentes. En la verificación del curso original, se confirmó comparando los nombres de los perfiles y las listas de modos antes y después que se conservaron tal cual. La limpieza no consiste en desactivar todas las funciones; solo elimina el perfil, el ejecutable y los datos de prueba creados esta vez.