Ejemplos de configuración
Esta página ofrece ejemplos de configuración completos para las combinaciones más comunes de «middleware × formato de certificado». Cada ejemplo consta de dos partes: la configuración de montaje del certificado en el lado del servicio y la configuración del punto de instalación de clmBot config.yaml.
Las rutas de los ejemplos son valores ilustrativos; sustitúyalas por las rutas de su entorno real. Para conocer el significado de los campos, consulte la Referencia de configuración.
nginx + PEM
Configuración del certificado en el lado del servicio
En la configuración del sitio de nginx, monte el certificado mediante ssl_certificate y ssl_certificate_key:
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/nginx/ssl/example.com.crt;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
location / {
root /usr/share/nginx/html;
}
}
nginx requiere que el archivo ssl_certificate contenga la cadena de certificados completa (certificado del sitio + certificados intermedios). Por lo tanto, se recomienda dejar ca_path vacío en el punto de instalación de clmBot; clmBot fusionará la cadena completa de certificados y la escribirá en cert_path.
Configuración del punto de instalación de clmBot
servers:
- id: nginx_pem
sub_code: <证书订阅号>
format:
pem:
cert_path: /etc/nginx/ssl/example.com.crt
ca_path: ""
key_path: /etc/nginx/ssl/example.com.key
after_script: |
nginx -t && nginx -s reload
Apache + PEM
Configuración del certificado en el lado del servidor
En la configuración del sitio Apache, monte el certificado mediante directivas como SSLCertificateFile:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/example.com.ca.crt
</VirtualHost>
- Apache 2.4.8 y versiones superiores también pueden fusionar la cadena de certificados directamente en el archivo
SSLCertificateFile, en cuyo caso se puede omitirSSLCertificateChainFiley el campoca_pathen el punto de instalación de clmBot se deja vacío en consecuencia. - El nombre del servicio se selecciona según la distribución: para RHEL/CentOS es
httpd, para Debian/Ubuntu esapache2.
Configuración del punto de instalación de clmBot
servers:
- id: apache_pem
sub_code: <证书订阅号>
format:
pem:
cert_path: /etc/httpd/ssl/example.com.crt
ca_path: /etc/httpd/ssl/example.com.ca.crt
key_path: /etc/httpd/ssl/example.com.key
after_script: |
apachectl configtest && systemctl restart httpd.service
Tomcat + JKS
Configuración del certificado en el lado del servidor
En Tomcat 8.5 y versiones posteriores, el keystore JKS se monta mediante SSLHostConfig en conf/server.xml:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="150" SSLEnabled="true">
<SSLHostConfig>
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.com.jks"
certificateKeystorePassword="<keystore密码>"
certificateKeyAlias="tomcat"
certificateKeyPassword="<私钥密码>"
type="RSA" />
</SSLHostConfig>
</Connector>
Configuración del punto de instalación de clmBot
servers:
- id: tomcat_jks
sub_code: <证书订阅号>
format:
jks:
path: /opt/tomcat/conf/example.com.jks
alias: tomcat
key_pass: <私钥密码>
store_pass: <keystore密码>
after_script: |
export JAVA_HOME=/usr/java
/opt/tomcat/bin/shutdown.sh
/opt/tomcat/bin/startup.sh
Si Tomcat está gestionado por systemd, after_script se puede simplificar a systemctl restart <tomcat 服务名>.
Tomcat + PEM
Configuración del certificado en el lado del servidor
Tomcat 8.5 y versiones superiores admiten el uso directo de archivos PEM, sin necesidad de convertirlos a JKS:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="150" SSLEnabled="true">
<SSLHostConfig>
<Certificate certificateKeyFile="/opt/tomcat/ssl/example.com.key"
certificateFile="/opt/tomcat/ssl/example.com.crt"
certificateChainFile="/opt/tomcat/ssl/example.com.ca.crt"
type="RSA" />
</SSLHostConfig>
</Connector>
Configuración del punto de instalación de clmBot
servers:
- id: tomcat_pem
sub_code: <证书订阅号>
format:
pem:
cert_path: /opt/tomcat/ssl/example.com.crt
ca_path: /opt/tomcat/ssl/example.com.ca.crt
key_path: /opt/tomcat/ssl/example.com.key
after_script: |
export JAVA_HOME=/usr/java
/opt/tomcat/bin/shutdown.sh
/opt/tomcat/bin/startup.sh
Servicio personalizado + PFX
Adecuado para servicios que utilizan el certificado en forma de paquete de certificado de un solo archivo (PKCS#12). En after_script se pueden usar variables de plantilla de script:
servers:
- id: app_pfx
sub_code: <证书订阅号>
format:
pfx:
path: /opt/app/ssl/example.com.pfx
key_pass: <PFX密码>
after_script: |
echo "certificate updated at {{ .DATETIME }}"
/usr/bin/systemctl restart example-app.service
Verificación
Una vez completada la configuración, puede activar manualmente una actualización para verificar todo el flujo:
./clm-bot-linux-amd64 update-certificate
Una vez confirmado que el archivo del certificado se ha actualizado, que el servicio se ha recargado y que el nuevo certificado está en vigor, configure la actualización automática según el método de renovación del certificado.