Ciberseguridad ·

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-lint y cis-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.