Saltar al contenido principal

Inicio Rápido

Esta página le guía para completar la implementación de clmBot en 15 minutos y ejecutar un flujo completo de renovación de certificados.

Antes de comenzar, confirme lo siguiente:

  • Tiene el servicio sslTrus CaaS activado y puede iniciar sesión en el panel de administración.
  • El servidor de destino puede acceder a los servicios en la nube mediante conexiones salientes.
  • Posee privilegios de administrador en el servidor (para instalar e inicializar clmBot).

Paso 1: Generar AccessKey / AccessSecret​

Inicie sesión en el panel de administración, vaya a Servicio sslTrus CaaS -> Detalles del producto -> Detalles del certificado SSL, y haga clic en 生成AK/SK para obtener el AccessKey (AK) y el AccessSecret (SK).

Nota

Guarde el AccessKey y el AccessSecret de forma segura. No envíe el AccessSecret a repositorios de Git, scripts públicos o sistemas de terceros no confiables; si sospecha de una fuga, regenérelo en el panel de administración.

Paso 2: Descargar clmBot y subirlo al servidor​

Descargue el programa correspondiente a la versión del sistema desde la página de lanzamiento de clmBot:

Descargar clmBot

Seleccione la versión adecuada según el sistema operativo y la arquitectura del servidor (por ejemplo, clm-bot-linux-amd64) y súbala al servidor. Se recomienda crear un directorio de instalación independiente, por ejemplo /opt/clm-bot.

mkdir -p /opt/clm-bot && cd /opt/clm-bot
chmod 755 clm-bot-linux-amd64

Paso 3: Iniciar sesión y establecer la conexión​

Ejecute el comando login en el directorio de instalación para establecer la conexión:

./clm-bot-linux-amd64 login

Primero, según las indicaciones, seleccione el número de secuencia de la dirección de la nube (o ingrese directamente la dirección de la nube), luego ingrese AccessKey y AccessSecret secuencialmente.

Después de un inicio de sesión exitoso, clmBot generará el archivo de configuración config.yaml en el directorio de instalación para guardar la información de conexión.

Paso 4: Activar el nodo en el panel de administración​

Inicie sesión en el panel de administración, vaya a la lista de nodos de clmBot y verá que se ha agregado un nuevo nodo de clmBot. Haga clic en el interruptor ¿Permitir conexión? a la derecha del nodo para activar ese nodo.

Información

Los nodos recién conectados están deshabilitados por defecto. Solo después de activarlos en el panel de administración, clmBot podrá obtener certificados normalmente desde la nube.

Paso 5: Descubrir certificados en el servidor​

Ejecute el comando de descubrimiento de certificados para escanear automáticamente los certificados ya implementados en el servidor y sus rutas de almacenamiento:

./clm-bot-linux-amd64 discover-certificate

Después de ejecutar el comando, la información de los certificados encontrados se mostrará en forma de tabla (origen, tipo, emisor, ruta, dominio, etc.). Ingrese el número de serie del certificado que desea cargar para confirmar y agregarlo a la administración del backend:

  • all: cargar todo
  • none: no cargar
  • 1,3-5: seleccionar por número de serie, admite notación de rango

Después de una carga exitosa, estos certificados aparecerán como puntos de instalación en el backend de administración, y clmBot generará la configuración correspondiente para cada punto de instalación en config.yaml del directorio actual.

Información

En la configuración generada automáticamente, cada punto de instalación incluye los campos before_script y after_script, donde after_script es el script de recarga que se ejecuta después de la actualización del certificado, y debe confirmar si está disponible según el entorno real. Consulte Referencia de configuración para conocer el significado de los campos.

Paso 6: completar la primera actualización de certificado​

Después de configurar el ciclo de reemisión automática de certificados en el panel de administración (consulte Métodos de renovación de certificados), puede activar manualmente una actualización para verificar todo el flujo:

./clm-bot-linux-amd64 update-certificate

Tras la ejecución, clmBot verificará si hay certificados actualizados en la nube:

  • El certificado local ya está actualizado: muestra un aviso y omite el proceso.
  • Existe un certificado nuevo en la nube: intenta generar una copia de seguridad .bak, escribe el nuevo certificado y ejecuta after_script según la configuración. Si la copia de seguridad falla, se registra el error pero se continúa con la actualización; si el servicio se recarga por completo debe determinarse según el resultado del script y el estado del middleware.

Siguientes pasos​