Saltar al contenido principal

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:

  1. Antes de que expire el certificado, la nube completa automáticamente la reemisión del certificado y genera uno nuevo.
  2. clmBot obtiene el certificado más reciente mediante push desde la nube o pull programado.
  3. 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.
  4. 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ónModo de funcionamientoRequisitos de puertoEscenario aplicable
Push desde la nubeEl panel de administración inicia el push, el servicio clmBot en el servidor recibe y actualiza el certificadoRequiere abrir el puerto de entrada 8862/tcpCuando la política de red permite abrir puertos de entrada y se desea una actualización inmediata
Pull programadoEjecutar clmBot periódicamente mediante crontab o el Programador de tareas de Windows para verificar y obtener los certificados más recientesNo requiere abrir puertos de entrada, solo acceso de salida a la nubeServidores 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:

MiddlewareFormato de certificadoDescripción
nginxPEMImplementación separada de certificado, cadena CA y clave privada
Apache HTTP ServerPEMImplementación separada de certificado, cadena CA y clave privada
TomcatPEM / JKSAdmite certificados PEM o keystore JKS
IISIISImporta PFX mediante script integrado y actualiza los enlaces del sitio, requiere permisos de administrador
ExchangeExchangeSolo 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 usoPágina recomendada
Primer uso, desea una implementación rápida y completar una actualización de certificadoInicio rápido
Conocer la configuración detallada de los dos métodos de actualizaciónMé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 localGestión de puntos de instalación
Consultar el significado de los campos de config.yaml y las variables de las plantillas de scriptsReferencia de configuración
Consultar ejemplos completos de instalación de certificados y recarga de nginx, Apache, Tomcat y otros middlewareEjemplos de configuración
Restringir los permisos de ejecución de clmBot en producción y configurar sudoersRequisitos de permisos de ejecución
Registrar clmBot como servicio del sistema, actualizarlo y consultar los registrosImplementación como servicio y actualización

Inicio rápido​

Si utiliza clmBot por primera vez, se recomienda seguir estos pasos:

  1. Genere AccessKey / AccessSecret en el panel de administración.
  2. Descargue clmBot y súbalo al servidor.
  3. Ejecute login para establecer la conexión y active el nodo en el panel.
  4. Ejecute discover-certificate para detectar automáticamente los certificados del servidor.
  5. Configure el método de actualización (envío o extracción programada).

Para consultar los pasos completos, consulte Inicio rápido.