Hardening de Ubuntu 22.04 con CIS Benchmark usando Ansible
Introducción
El CIS Benchmark para Ubuntu 22.04 es una colección de configuraciones recomendadas por el Center for Internet Security para reducir la superficie de ataque de un servidor Linux. Implementar manualmente cada control es tedioso y propenso a errores; por eso, la automatización con Ansible resulta ideal para sysadmins que gestionan múltiples nodos.
En este artículo describiremos:
- Cómo preparar el entorno de Ansible.
- Cómo estructurar los playbooks que aplican los controles CIS.
- Cómo validar los cambios con
ansible-lintycis-cat. - Cómo establecer una auditoría continua mediante cron y Git.
1. Preparación del entorno
1.1 Instalación de Ansible
En la máquina de control (puede ser tu laptop o un servidor de gestión) instala Ansible 2.14 o superior:
sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository --yes --update ppa:ansible/ansible
sudo apt install -y ansible
ansible --version
Verifica que la versión sea al menos 2.14 para contar con los módulos de ansible.builtin más recientes.
1.2 Creación del inventario
Define un archivo hosts.ini con los servidores objetivo:
[ubuntu_servers] srv-web01 ansible_host=192.168.10.10 ansible_user=admin srv-db01 ansible_host=192.168.10.11 ansible_user=admin
[ubuntu_servers:vars] ansible_python_interpreter=/usr/bin/python3
1.3 Descarga del CIS Benchmark
Regístrate en CIS y descarga el benchmark en formato PDF y, si está disponible, el archivo de referencia cis-hardening.yml que algunos proyectos comparten en GitHub. Aun sin el archivo, podemos mapear los controles manualmente.
2. Estructura del proyecto Ansible
2.1 Layout recomendado
Una estructura modular facilita el mantenimiento:
hardening-ubuntu22/
├─ inventories/
│ └─ production/
│ └─ hosts.ini
├─ group_vars/
│ └─ ubuntu_servers.yml
├─ roles/
│ ├─ cis_base/
│ │ ├─ tasks/
│ │ │ └─ main.yml
│ │ ├─ handlers/
│ │ │ └─ main.yml
│ │ └─ templates/
│ └─ cis_audit/
│ ├─ tasks/
│ │ └─ main.yml
│ └─ files/
│ └─ cis-cat.sh
└─ site.yml
2.2 Variables de seguridad
En group_vars/ubuntu_servers.yml declaramos los parámetros críticos que pueden variar entre entornos:
# group_vars/ubuntu_servers.yml
ssh_port: 2222
disable_root_login: true
password_policy:
minlen: 14
ucredit: -1
lcredit: -1
dcredit: -1
ocredit: -1
2.3 Rol cis_base: aplicación de controles
Ejemplo de roles/cis_base/tasks/main.yml que cubre varios controles del Benchmark:
- name: "1.1.1 Ensure mounting of cramfs filesystems is disabled"
ansible.builtin.modprobe:
name: cramfs
state: absent
blacklist: true
-
name: “1.1.2 Ensure mounting of freevxfs filesystems is disabled” ansible.builtin.modprobe: name: freevxfs state: absent blacklist: true
-
name: “5.2.1 Ensure SSH Protocol is set to 2” ansible.builtin.lineinfile: path: /etc/ssh/sshd_config regexp: ‘^Protocol’ line: ‘Protocol 2’ state: present notify: Restart ssh
-
name: “5.2.2 Ensure SSH LogLevel is set to INFO” ansible.builtin.lineinfile: path: /etc/ssh/sshd_config regexp: ‘^LogLevel’ line: ‘LogLevel INFO’ state: present notify: Restart ssh
-
name: “5.2.3 Set custom SSH port” ansible.builtin.lineinfile: path: /etc/ssh/sshd_config regexp: ‘^Port’ line: “Port {{ ssh_port }}” state: present notify: Restart ssh
-
name: “5.2.4 Disable root login” ansible.builtin.lineinfile: path: /etc/ssh/sshd_config regexp: ‘^PermitRootLogin’ line: ‘PermitRootLogin {{ “no” if disable_root_login else “yes” }}’ state: present notify: Restart ssh
-
name: “5.4.1 Ensure password expiration is 90 days or less” ansible.builtin.command: chage —maxdays 90 {{ item }} loop: ”{{ ansible_facts.user_ids | dict2items | map(attribute=‘key’) | list }}” when: item != ‘root’
name: “5.4.2 Enforce password complexity” ansible.builtin.copy: dest: /etc/pam.d/common-password content: | password requisite pam_pwquality.so retry=3 minlen={{ password_policy.minlen }}
ucredit={{ password_policy.ucredit }} lcredit={{ password_policy.lcredit }}
dcredit={{ password_policy.dcredit }} ocredit={{ password_policy.ocredit }} owner: root group: root mode: ‘0644’ notify: Reload pam
2.4 Handlers
Los handlers aseguran que los servicios se reinicien solo cuando sea necesario:
# roles/cis_base/handlers/main.yml
- name: Restart ssh
ansible.builtin.service:
name: ssh
state: restarted
name: Reload pam ansible.builtin.command: pam-auth-update —package
3. Validación de la configuración
3.1 Uso de ansible-lint
Antes de ejecutar el playbook, verifica la calidad del código:
ansible-lint site.yml
Corrige los avisos (por ejemplo, módulos no idempotentes) para garantizar que la ejecución sea segura.
3.2 Ejecutar el playbook
Ejecuta el playbook contra el inventario de producción:
ansible-playbook -i inventories/production/hosts.ini site.yml --check # modo dry‑run
ansible-playbook -i inventories/production/hosts.ini site.yml
3.3 Auditoría con CIS-CAT
Descarga CIS-CAT Pro (o la versión gratuita) y cópialo al nodo de auditoría:
scp cis-cat-pro-linux.zip admin@srv-audit:/tmp/
ssh admin@srv-audit 'unzip -d /opt/cis-cat /tmp/cis-cat-pro-linux.zip'
ssh admin@srv-audit '/opt/cis-cat/cis-cat.sh -b ubuntu22 -r /opt/cis-cat/reports'
El reporte generado (HTML o CSV) debe almacenarse en un repositorio versionado para trazabilidad.
4. Auditoría continua
4.1 Programar auditorías periódicas
En cada servidor, crea una tarea cron que ejecute CIS‑CAT semanalmente y envíe el informe a un servidor central:
# /etc/cron.d/cis-audit
0 2 * * 0 root /opt/cis-cat/cis-cat.sh -b ubuntu22 -r /opt/cis-cat/reports/$(hostname)-$(date +\%F).html && \
curl -X POST -H "Content-Type: application/json" \
-d @/opt/cis-cat/reports/$(hostname)-$(date +\%F).html \
https://audit.example.com/api/upload
4.2 Integración con Git para historial
En el servidor central, inicializa un repositorio Git donde se almacenen los informes:
mkdir -p /srv/cis-reports
cd /srv/cis-reports
git init --bare
# Cada día un script clona, agrega el nuevo reporte y hace push
Esto permite comparar la evolución de los hallazgos y detectar desviaciones rápidamente.
4.3 Alertas con Prometheus + Alertmanager
Exporta métricas del script de auditoría a un endpoint node_exporter personalizado:
# /usr/local/bin/cis_exporter.sh
#!/bin/bash
REPORT="/opt/cis-cat/reports/$(hostname)-$(date +%F).html"
if grep -q "FAIL" "$REPORT"; then
echo "cis_audit_failures{host=\"$(hostname)\"} 1"
else
echo "cis_audit_failures{host=\"$(hostname)\"} 0"
fi
Configura Prometheus para scrappear este script y crea una regla de alerta cuando cis_audit_failures == 1.
5. Troubleshooting y errores comunes
5.1 Módulos que no son idempotentes
Algunos módulos command o shell pueden ejecutarse siempre, provocando cambios innecesarios. Solución: reemplázalos por módulos específicos (ansible.builtin.lineinfile, ansible.builtin.copy) o usa creates/removes para controlar la ejecución.
5.2 Falta de reboot después de cambios críticos
Desactivar módulos del kernel (p. ej., cramfs) requiere que el nodo sea reiniciado. Añade un handler opcional:
- name: Reboot after kernel module changes
ansible.builtin.reboot:
reboot_timeout: 600
when: reboot_required | default(false)
Establece la variable reboot_required a true cuando sea necesario.
5.3 Conflictos con configuraciones preexistentes
Si el servidor ya tiene políticas de PAM personalizadas, el copy anterior sobrescribirá todo. Mejor: usa blockinfile para insertar solo la línea requerida.
- name: Ensure pam_pwquality line exists
ansible.builtin.blockinfile:
path: /etc/pam.d/common-password
block: |
password requisite pam_pwquality.so retry=3 minlen={{ password_policy.minlen }} \
ucredit={{ password_policy.ucredit }} lcredit={{ password_policy.lcredit }} \
dcredit={{ password_policy.dcredit }} ocredit={{ password_policy.ocredit }}
marker: "# {mark} ANSIBLE MANAGED BLOCK - CIS PWQUALITY"
5.4 Errores de permisos al ejecutar CIS‑CAT
El binario necesita privilegios de root para inspeccionar algunos archivos. Ejecuta el script con sudo o configura sudoers para permitir al usuario audit ejecutar el binario sin contraseña.
Conclusión
Aplicar el CIS Benchmark a servidores Ubuntu 22.04 es una tarea repetitiva que se beneficia enormemente de la automatización con Ansible. Con una arquitectura de roles bien definida, validación mediante ansible-lint y cis-cat, y una capa de auditoría continua usando cron, Git y Prometheus, los equipos de operaciones pueden mantener una postura de seguridad constante y verificable.
Recuerda que el hardening es un proceso iterativo: revisa periódicamente las nuevas versiones del benchmark, actualiza tus playbooks y ajusta las alertas. La combinación de infraestructura como código y monitoreo proactivo garantiza que los servidores permanezcan seguros frente a amenazas emergentes.