Saltar al contenido principal

Método de actualización de certificados

clmBot admite dos métodos de actualización de certificados, que pueden elegirse según el entorno de red del servidor:

Método de actualizaciónModo de funcionamientoRequisito de puertoEscenario aplicable
Envío desde la nubeEl panel de administración inicia el envío, el servidor clmBot lo recibe y actualizaSe debe abrir el puerto de entrada 8862/tcpCuando la política de red lo permita y se requiera una actualización inmediata
Extracción programadacrontab o el Programador de tareas de Windows ejecuta clmBot periódicamente para comprobar actualizacionesNo es necesario abrir puertos de entradaPara servidores que no pueden abrir puertos de entrada (método recomendado por defecto)

Ambos métodos no entran en conflicto entre sí; dentro del mismo grupo de servidores, algunos pueden usar el envío y otros la extracción programada.

Método 1: Envío desde la nube​

Iniciar el servidor clmBot en el servidor​

./clm-bot-linux-amd64 server -a="0.0.0.0:8862"

-a especifica la dirección y el puerto de escucha, con el valor predeterminado 0.0.0.0:8862. Tras el inicio, clmBot se ejecuta de forma persistente como servidor, a la espera de las notificaciones push desde la nube.

Atención
  • Es necesario abrir el puerto de entrada 8862/tcp en el firewall del servidor y en el grupo de seguridad de la nube.
  • El servidor clmBot habilita la autenticación TLS mutua para las conexiones push desde la nube, y solo acepta certificados de nodos que hayan completado la activación y el acceso.

Si no desea abrir el puerto de entrada, utilice el Método 2: Extracción programada.

Información

El servidor clmBot debe mantenerse en ejecución para recibir las notificaciones push. En entornos de producción, se recomienda registrarlo como servicio del sistema y configurar el arranque automático; consulte Implementación y actualización como servicio.

Enviar certificados desde el panel de administración​

Inicie sesión en el panel de administración, vaya a la lista de puntos de instalación, localice el punto de instalación objetivo y haga clic en Enviar certificado. Tras confirmar, el sistema enviará el certificado más reciente al servidor y completará automáticamente la actualización.

Método 2: Extracción programada​

El modo de extracción programada no requiere abrir el puerto de entrada y es el método predeterminado recomendado. clmBot no incluye un programador periódico; es necesario ejecutar el comando de actualización de forma periódica mediante crontab, el Programador de tareas de Windows o un sistema de programación existente.

Linux: Configurar crontab​

Añada el comando de actualización de clmBot a crontab:

crontab -e

Agregar una línea (realizar la verificación de renovación de certificados a las 3 a. m. todos los días):

0 3 * * * cd /opt/clm-bot && ./clm-bot-linux-amd64 update-certificate >> update.log 2>&1
Atención
  • Antes de ejecutar el comando, debe usar cd para cambiar al directorio de instalación de clmBot, ya que clmBot lee config.yaml del directorio actual de forma predeterminada.
  • También puede especificar la ruta del archivo de configuración mediante el parámetro -c sin cambiar de directorio: ./clm-bot-linux-amd64 -c /opt/clm-bot/config.yaml update-certificate.
  • Sustituya la ruta por el directorio de instalación real.

La salida se añade a update.log. Además, clmBot registra su ejecución en logs/clm-bot.log, dentro del directorio que contiene el archivo de configuración.

Windows: Configurar una tarea programada​

Cree una tarea programada en el servidor Windows para ejecutar periódicamente:

cd /d C:\clm-bot && clm-bot-windows-amd64.exe update-certificate >> update.log 2>&1

Una vez completada la creación, puede hacer clic derecho en la tarea y seleccionar Ejecutar para verificar, y luego revisar el registro en el directorio de instalación para confirmar el resultado de la ejecución.

Renovación y actualización automática de certificados​

Los certificados actualizados por clmBot provienen de la renovación automática realizada en la nube. Inicie sesión en el panel de administración, vaya a la página de detalles del certificado SSL, y en la configuración de renovación automática, seleccione o ingrese el período de renovación (por ejemplo, 30 días) y guarde.

El efecto general después de la configuración:

  1. Antes de que expire el certificado, la nube completa automáticamente la renovación según el período configurado, generando un nuevo certificado.
  2. clmBot obtiene el nuevo certificado según el método configurado (empuje o extracción programada).
  3. clmBot ejecuta la actualización del certificado local:
  • Si el certificado local coincide con el último certificado de la nube, se omite la actualización.
  • Si no coincide, se intenta generar una copia de seguridad con marca de tiempo .bak, se ejecuta secuencialmente before_script, se escribe el nuevo certificado y se ejecuta after_script. Si la copia de seguridad falla, se registra el error pero se continúa con la actualización; si el servicio se ha recargado correctamente debe determinarse según el resultado del script y el estado del middleware.
Sugerencia

Si necesita forzar la ejecución de after_script sin actualizar el certificado (por ejemplo, para depurar el script de recarga), puede usar el parámetro --force-after.