Navegación
clmBot es un cliente ligero desplegado en el servidor de su red interna, utilizado para automatizar la implementación y actualización de certificados SSL: obtiene los certificados más recientes desde la nube, los escribe en los puntos de instalación de certificados del servidor y ejecuta scripts según la configuración para recargar los servicios de middleware.
Modo de funcionamiento
El flujo de actualización de certificados de clmBot es el siguiente:
- Antes de que expire el certificado, la nube completa automáticamente la reemisión del certificado y genera uno nuevo.
- clmBot obtiene el certificado más reciente mediante push desde la nube o pull programado.
- clmBot intenta hacer una copia de seguridad y reemplazar el archivo de certificado local en el servidor; si la copia de seguridad falla, se registra un error, pero no se bloquea la actualización posterior.
- clmBot ejecuta el script de recarga según la configuración (
after_script); si surte efecto depende del resultado de la ejecución del script y del estado del middleware.
Todo el proceso no requiere que nadie inicie sesión en el servidor para reemplazar certificados, ni expone la entrada de administración del servidor al exterior.
Métodos de actualización compatibles
clmBot admite dos métodos de actualización de certificados, que pueden seleccionarse por separado en diferentes servidores:
| Método de actualización | Modo de funcionamiento | Requisitos de puerto | Escenario aplicable |
|---|---|---|---|
| Push desde la nube | El panel de administración inicia el push, el servicio clmBot en el servidor recibe y actualiza el certificado | Requiere abrir el puerto de entrada 8862/tcp | Cuando la política de red permite abrir puertos de entrada y se desea una actualización inmediata |
| Pull programado | Ejecutar clmBot periódicamente mediante crontab o el Programador de tareas de Windows para verificar y obtener los certificados más recientes | No requiere abrir puertos de entrada, solo acceso de salida a la nube | Servidores donde no se pueden abrir puertos de entrada (recomendado como método predeterminado) |
Para obtener instrucciones de configuración detalladas, consulte Métodos de actualización de certificados.
Plataformas y middleware compatibles
Sistemas operativos compatibles:
- Linux (amd64, arm64)
- macOS (amd64, arm64)
- Windows (amd64; las versiones antiguas de Windows usan el paquete de compatibilidad legacy)
Middleware y formatos de certificado compatibles:
| Middleware | Formato de certificado | Descripción |
|---|---|---|
| nginx | PEM | Implementación separada de certificado, cadena CA y clave privada |
| Apache HTTP Server | PEM | Implementación separada de certificado, cadena CA y clave privada |
| Tomcat | PEM / JKS | Admite certificados PEM o keystore JKS |
| IIS | IIS | Importa PFX mediante script integrado y actualiza los enlaces del sitio, requiere permisos de administrador |
| Exchange | Exchange | Solo admite actualización; no admite descubrimiento, consulta ni sync-server, requiere permisos de administrador |
| Otros (scripts personalizados) | PFX, etc. | Admite cualquier escenario mediante after_script personalizado |
Cómo elegir la documentación
| Escenario de uso | Página recomendada |
|---|---|
| Primer uso, desea una implementación rápida y completar una actualización de certificado | Inicio rápido |
| Conocer la configuración detallada de los dos métodos de actualización | Métodos de actualización de certificados |
| Agregar puntos de instalación manualmente, sincronizar puntos de instalación desde el panel o usar la página de configuración web local | Gestión de puntos de instalación |
| Consultar el significado de los campos de config.yaml y las variables de las plantillas de scripts | Referencia de configuración |
| Consultar ejemplos completos de instalación de certificados y recarga de nginx, Apache, Tomcat y otros middleware | Ejemplos de configuración |
| Restringir los permisos de ejecución de clmBot en producción y configurar sudoers | Requisitos de permisos de ejecución |
| Registrar clmBot como servicio del sistema, actualizarlo y consultar los registros | Implementación como servicio y actualización |
Inicio rápido
Si utiliza clmBot por primera vez, se recomienda seguir estos pasos:
- Genere AccessKey / AccessSecret en el panel de administración.
- Descargue clmBot y súbalo al servidor.
- Ejecute
loginpara establecer la conexión y active el nodo en el panel. - Ejecute
discover-certificatepara detectar automáticamente los certificados del servidor. - Configure el método de actualización (envío o extracción programada).
Para consultar los pasos completos, consulte Inicio rápido.