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ón | Modo de funcionamiento | Requisito de puerto | Escenario aplicable |
|---|---|---|---|
| Envío desde la nube | El panel de administración inicia el envío, el servidor clmBot lo recibe y actualiza | Se debe abrir el puerto de entrada 8862/tcp | Cuando la política de red lo permita y se requiera una actualización inmediata |
| Extracción programada | crontab o el Programador de tareas de Windows ejecuta clmBot periódicamente para comprobar actualizaciones | No es necesario abrir puertos de entrada | Para 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.
- Es necesario abrir el puerto de entrada
8862/tcpen 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.
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
- Antes de ejecutar el comando, debe usar
cdpara cambiar al directorio de instalación de clmBot, ya que clmBot leeconfig.yamldel directorio actual de forma predeterminada. - También puede especificar la ruta del archivo de configuración mediante el parámetro
-csin 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:
- Antes de que expire el certificado, la nube completa automáticamente la renovación según el período configurado, generando un nuevo certificado.
- clmBot obtiene el nuevo certificado según el método configurado (empuje o extracción programada).
- 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 secuencialmentebefore_script, se escribe el nuevo certificado y se ejecutaafter_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.
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.