Usando letsencrypt.sh para crear y renovar certificados

La naturaleza abierta del proyecto Let’s Encrypt permite que existan  clientes alternativos al oficial. Yo me he decidido por uno escrito en Bash por Lukas Schauer, muy ligero y fácilmente trazable. Bueno, lo de fácilmente es un decir porque cuando se llega a la parte de openssl las cosas se complican un poco con tanto parámetro y tanto condicionante; el resto se comprende de un vistazo rápido.

El caso es que funciona muy bien y los resultados son fácilmente aplicables a los servicios del sistema como detallaré más abajo. De momento éstos son los pasos que he seguido:

  1. Descargar el programa
  2. Crear la configuración
  3. Activar (y verificar) el protocolo ACME challenge.
  4. Acomodar el programa en el sistema.

Descarga del programa

Tan simple como clonar el repositorio en algún lugar que no estorbe. En mi caso he empleado el directorio de trabajo de la cuenta que uso para configurar el servidor y luego lo he lanzado con privilegios de administración cuando lo he necesitado (que es más bien siempre).

Crear la configuración

El programa emplea como valor predeterminado para la configuración y los certificados la ruta

/etc/letsencrypt.sh

y me ha parecido muy bien, aunque se puede cambiar utilizando el parámetro

--config

. He creado el directorio y he situado allí dos archivos: uno para definir los dominios para los que quiero un certificado digital y otro para algunos ajustes en la configuración que me faciliten la automatización de la renovación.

El archivo

/etc/letsencrypt.sh/domains.txt

contiene en líneas aparte los dominios para los que queremos certificados separados por espacios en blanco. El primero es el dominio principal y los restantes son los nombres alternativos para el mismo.

taquiones.net mail.taquiones.net db.taquiones.net
astillas.net git.astillas.net 
vm69.net

Respecto a la configuración he añadido lo siguiente en

/etc/letsencrypt.sh/config.sh

(es un archivo shell):

# Archivo de configuración de openssl
OPENSSL_CNF=/usr/lib/ssl/openssl.cnf

# Ruta al directorio del protocolo ACME
WELLKNOWN=/var/www/letsencrypt

# Dirección de contacto
CONTACT_EMAIL=victor@example.net

Para crear los archivos CSR (Certificate Signing Request) con openssl es imprescindible que exista su archivo de configuración. Al parecer el mío había desaparecido del sistema y me he limitado a copiar una versión ejemplo que he encontrado por ahí y la he situado en

/etc/ssl/openssl.cnf

ya que Debian mantiene un enlace simbólico desde

/usr/lib/ssl/openssl.cnf

hacía allí; supongo que porque se trata de un archivo de configuración y la normativa Debian indica que deben estar bajo

/etc

.

Acomodar el programa en el sistema

Fase que incluye el probarlo por vez primera. Una vez que nos hemos asegurado de que respondemos correctamente al reto del protocolo ACME ejecutamos el programa con el parámetro

--cron

para obtener nuestros certificados.

Si todo ha ido bien los habrá creado bajo su directorio de configuración concretamente en bajo el subdirectorio certs:

.
├── certs
│   ├── astillas.net
|   .
|   .
│   ├── taquiones.net
|   .
|   .
|   └── vm69.net

En cada uno de ellos tendremos enlaces simbólicos apuntando a la última versión de cada componente que necesitamos:

  • cert.pem: es el certificado del servidor.
  • chain.perm: son los certificados intermedios.
  • fullchain.pem: el certificado del servidor y los intermedios.
  • privkey.pem: es la clave privada de lo anterior.

Después sólo resta instalar el programa y crear una tarea de renovación en el sistema:

$ sudo install -o root -g root -m 0555 letsencrypt.sh /usr/local/bin
$ cat <<EOF > renew.cron
# Renovación semanal en domingo
0 23 * * 0 root /usr/local/bin/letsencrypt.sh --cron
EOF
$ sudo install renew.cron /etc/cron.d/letsencrypt

Renovando certificados

El programa letsencrypt.sh, al igual que los demás que he visto, comprueban que la validez del certificado sea superior a los treinta días y si no es así solicitan renovarlo. También ocurre cuando la lista de dominios ha sufrido alguna alteración como el añadido o el borrado de algún nombre.

Luego está la cuestión de que tras la renovación los certificados han cambiado y nos encontramos con el problema de reiniciar aquellos servicios que hacen uso de ellos.

El programa letsencrypt.sh permite llamar a una función con el nombre de

deploy_cert()

que debe incluirse dentro del fuente principal en el archivo

hook.sh

del directorio de configuración.

Un ejemplo:

function deploy_cert
{
        local DOMAIN="${1}" KEYFILE="${2}" CERTFILE="${3}" FULLCHAINFILE="${4}" CHAINFILE="${5}"

        # En cualquier caso reiniciar el servidor web
        echo "Reiniciando servidor web ..." >&2
        systemctl restart apache2

        # y luego según el caso afinamos más
        case $DOMAIN in
        taquiones.net) 
                # Reiniciar servidores de correo, mensajería 
                echo "Reiniciando servidores de correo y mensajería ..." >&2
                systemctl restart qpsmtpd
                systemctl restart dovecot
                systemctl restart prosody
                ;;
        esac
}

 

Puede compartir este contenido vía