Apache

CertGuardian permite instalar certificados automáticamente en servidores Apache mediante la configuración del archivo certificates.yaml.

Este archivo se encuentra dentro del directorio config del agente:

certguardian-agent/
├── certguardian-agent(.exe)
└── config/
    └── certificates.yaml

Ejemplo de Configuración

El siguiente ejemplo muestra un certificado que será instalado en dos ubicaciones diferentes:

certificates:
  - id: 1
    installations:
      - id: web-frontend
        type: apache
        config:
          fullchain_path: /opt/apache/frontend/fullchain.pem
          key_path: /opt/apache/frontend/private.key
          reload: systemctl reload apache2

      - id: web-backend
        type: apache
        config:
          fullchain_path: /opt/apache/backend/fullchain.pem
          key_path: /opt/apache/backend/private.key
          reload: systemctl reload apache2

Estructura de la Configuración

id

Identificador del certificado dentro de la plataforma CertGuardian.

id: 1

Este identificador debe coincidir con el identificador del certificado configurado en la plataforma.

installations

Lista de instalaciones asociadas al certificado.

Un mismo certificado puede tener una o varias instalaciones.

installations:

installation.id

Identificador único de la instalación.

id: web-frontend

Este valor permite identificar la instalación dentro del archivo de configuración.

installation.type

Tipo de instalación que ejecutará el agente.

Para instalaciones Apache debe establecerse como:

type: apache

installation.config

Contiene los parámetros específicos de la instalación Apache.

config:

Parámetros Apache

fullchain_path

Ruta completa donde se instalará el certificado (fullchain).

fullchain_path: /opt/apache/frontend/fullchain.pem

key_path

Ruta completa donde se instalará la clave privada del certificado.

key_path: /opt/apache/frontend/private.key

reload

Comando que ejecutará el agente una vez completada la instalación.

Normalmente se utiliza para recargar la configuración de Apache y aplicar el nuevo certificado.

reload: systemctl reload apache2

Múltiples Instalaciones

Un mismo certificado puede asociarse a múltiples instalaciones.

En el ejemplo anterior, el certificado será desplegado en dos ubicaciones diferentes:

• /opt/apache/frontend/
• /opt/apache/backend/

Tras completar cada instalación, el agente ejecutará el comando definido en el parámetro reload.