← volver

Automatización de la Gestión de Certificados SSL/TLS con Certbot y Ansible

Por · · [Admin-Sistemas] · lectura estimada: ~6 min

Introducción a la Automatización de Certificados SSL/TLS

La seguridad de las aplicaciones web depende en gran medida de la correcta implementación y gestión de certificados SSL/TLS. La expiración de un certificado puede provocar interrupciones del servicio, pérdida de confianza del usuario y, en última instancia, problemas de seguridad. La gestión manual de estos certificados es propensa a errores, consume tiempo y es difícil de escalar en entornos con múltiples servidores. La automatización de este proceso es crucial para mantener una infraestructura web segura y eficiente. En este artículo, exploraremos cómo utilizar Certbot, una herramienta popular para la obtención y renovación de certificados Let's Encrypt, junto con Ansible, una poderosa herramienta de automatización, para simplificar y automatizar la gestión de certificados SSL/TLS.

Nos centraremos en la creación de un playbook de Ansible que automatice los siguientes pasos:

  • Instalación de Certbot en los servidores.
  • Obtención de un nuevo certificado SSL/TLS.
  • Configuración del servidor web (Nginx o Apache) para utilizar el certificado.
  • Renovación automática de los certificados antes de su expiración.

Preparación del Entorno y Requisitos Previos

Requisitos del Sistema

Antes de comenzar, asegúrate de tener los siguientes requisitos:

  • Un servidor con sistema operativo Linux (Ubuntu, Debian, CentOS, etc.).
  • Acceso SSH al servidor con un usuario que tenga privilegios de sudo.
  • Ansible instalado en la máquina de control (la máquina desde la que ejecutarás los playbooks). Puedes instalarlo con:
  • sudo apt update
    sudo apt install ansible
  • Certbot instalado en la máquina de control (opcional, pero recomendado para pruebas).
  • Un servidor web (Nginx o Apache) instalado y configurado en los servidores objetivo.
  • Un dominio registrado y apuntando a la dirección IP de tus servidores.

Configuración de Ansible Inventory

Crea un archivo de inventario de Ansible (por ejemplo, hosts) que contenga la lista de servidores donde se gestionarán los certificados. Puedes usar un archivo simple con la dirección IP o el nombre de dominio de cada servidor:

[webservers]
server1.example.com
server2.example.com

[webservers:vars] ansible_user=your_user ansible_ssh_private_key_file=/path/to/your/private_key

Reemplaza server1.example.com y server2.example.com con los nombres de dominio de tus servidores. Asegúrate de configurar las variables ansible_user y ansible_ssh_private_key_file para permitir el acceso SSH sin contraseña.

Creación del Playbook de Ansible para la Gestión de Certificados

Estructura del Playbook

El playbook de Ansible se dividirá en las siguientes tareas:

  • Instalación de Certbot.
  • Obtención del certificado SSL/TLS.
  • Configuración del servidor web (Nginx o Apache).
  • Creación de un cronjob para la renovación automática.

Playbook de Ejemplo (Nginx)

A continuación, se presenta un ejemplo de playbook de Ansible para la gestión de certificados SSL/TLS con Nginx:

---
- hosts: webservers
  become: yes
  vars:
    domain: example.com
    certbot_email: your_email@example.com
    nginx_config_file: /etc/nginx/sites-available/default

  tasks:
    - name: Install Certbot
      apt:
        name: certbot
        state: present
      when: ansible_os_family == "Debian"

    - name: Install Certbot (CentOS/RHEL)
      yum:
        name: certbot
        state: present
      when: ansible_os_family == "RedHat"

    - name: Obtain SSL Certificate
      command: certbot certonly --standalone -d {{ domain }} -m {{ certbot_email }} --agree-tos --non-interactive
      register: certbot_output

    - name: Configure Nginx
      template:
        src: templates/nginx.conf.j2
        dest: "{{ nginx_config_file }}"
      notify: Restart Nginx

  handlers:
    - name: Restart Nginx
      service:
        name: nginx
        state: restarted

Explicación del Playbook

  • hosts: webservers: Especifica los servidores en los que se ejecutará el playbook (definidos en el archivo de inventario).
  • become: yes: Indica que las tareas se ejecutarán con privilegios de sudo.
  • vars: Define variables que se utilizarán en el playbook, como el dominio, la dirección de correo electrónico y el archivo de configuración de Nginx.
  • apt/yum: Instala Certbot utilizando el gestor de paquetes apropiado para el sistema operativo.
  • command: certbot certonly ...: Ejecuta el comando Certbot para obtener el certificado SSL/TLS. Las opciones incluyen:
    • --standalone: Utiliza un servidor web temporal para validar el dominio.
    • -d {{ domain }}: Especifica el dominio para el que se solicita el certificado.
    • -m {{ certbot_email }}: Especifica la dirección de correo electrónico para recibir notificaciones de Certbot.
    • --agree-tos: Acepta los términos de servicio de Let's Encrypt.
    • --non-interactive: Ejecuta Certbot en modo no interactivo.
  • template: Utiliza un archivo de plantilla Jinja2 (templates/nginx.conf.j2) para generar el archivo de configuración de Nginx. Esto permite personalizar la configuración del servidor web de forma dinámica.
  • notify: Restart Nginx: Notifica al handler "Restart Nginx" para reiniciar el servidor web después de modificar la configuración.
  • handlers: Define los handlers, que son tareas que se ejecutan en respuesta a las notificaciones. En este caso, el handler "Restart Nginx" reinicia el servicio Nginx.

Archivo de Plantilla Nginx (templates/nginx.conf.j2)

server {
    listen 80;
    server_name {{ domain }};

    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name {{ domain }};

    ssl_certificate /etc/letsencrypt/live/{{ domain }}/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/{{ domain }}/privkey.pem;

    # Otras configuraciones de Nginx...
}

Automatización de la Renovación de Certificados

Creación de un Cronjob

Para garantizar la renovación automática de los certificados, crearemos un cronjob que ejecute el comando Certbot de renovación. Esto se puede hacer utilizando la tarea `cron` de Ansible:

- name: Create Cronjob for Certificate Renewal
  cron:
    name: "Certbot Renewal"
    user: root
    minute: "0"
    hour: "12"
    job: "/usr/bin/certbot renew --quiet --no-self-upgrade"
  when: ansible_os_family == "Debian"

- name: Create Cronjob for Certificate Renewal (CentOS/RHEL)
  cron:
    name: "Certbot Renewal"
    user: root
    minute: "0"
    hour: "12"
    job: "/usr/bin/certbot renew --quiet --no-self-upgrade"
  when: ansible_os_family == "RedHat"

Este cronjob se ejecutará a las 12:00 AM todos los días y renovará los certificados si están a punto de expirar. Las opciones incluyen:

  • --quiet: Ejecuta Certbot en modo silencioso.
  • --no-self-upgrade: Evita la actualización automática de Certbot.

Troubleshooting: Errores Comunes y Soluciones

Error: Dominio No Valido

Si Certbot no puede validar el dominio, verifica que el dominio apunte correctamente a la dirección IP del servidor y que el servidor web esté configurado para responder a las solicitudes HTTP en el puerto 80.

Error: Permisos Insuficientes

Asegúrate de que el usuario que ejecuta el playbook tenga privilegios de sudo para instalar Certbot y modificar la configuración del servidor web.

Error: Certbot No Encontrado

Verifica que Certbot esté instalado correctamente en el servidor. Si no lo está, ejecuta la tarea de instalación de Certbot en el playbook.

Error: Configuración Incorrecta de Nginx

Revisa cuidadosamente el archivo de configuración de Nginx para asegurarte de que las rutas a los archivos de certificado sean correctas y que la configuración SSL/TLS sea válida.

Error: Renovación Fallida

Si la renovación de los certificados falla, revisa los logs de Certbot (generalmente ubicados en /var/log/letsencrypt/) para identificar la causa del problema.

Conclusión

La automatización de la gestión de certificados SSL/TLS con Certbot y Ansible simplifica significativamente el proceso, reduce el riesgo de errores y garantiza la seguridad y disponibilidad de tus aplicaciones web. Al crear un playbook de Ansible que automatice la obtención, configuración y renovación de certificados, puedes ahorrar tiempo, mejorar la eficiencia y mantener una infraestructura web segura y confiable. Este enfoque es especialmente valioso en entornos con múltiples servidores, donde la gestión manual de certificados puede ser abrumadora. Recuerda adaptar el playbook y las plantillas a tus necesidades específicas y probarlo exhaustivamente antes de implementarlo en producción.

comentarios(0)

$ dejar comentario

סHola! Soy SylonBot. Si te pierdes en el artículo, pregúntame 👋
☕ invítame a un café Si el contenido te fue útil · via PayPal