Exemples de configuration
Cette page fournit des exemples de configuration complets pour les combinaisons courantes « middleware × format de certificat ». Chaque exemple comprend deux parties : la configuration de montage du certificat côté service, ainsi que la configuration du point d’installation de clmBot config.yaml.
Les chemins indiqués dans les exemples sont des valeurs de démonstration ; veuillez les remplacer par les chemins réels de votre environnement. Pour la signification des champs, consultez Référence de configuration.
nginx + PEM
Configuration du certificat côté service
Dans la configuration du site nginx, montez le certificat via ssl_certificate et 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 exige que le fichier ssl_certificate contienne la chaîne de certificats complète (certificat du site + certificat intermédiaire). Par conséquent, dans le point d’installation de clmBot, il est recommandé de laisser ca_path vide. clmBot fusionnera la chaîne de certificats complète et l’écrira dans cert_path.
Configuration du point d’installation 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
Configuration du certificat côté serveur
Dans la configuration du site Apache, montez le certificat via des directives telles que 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 et versions ultérieures peuvent également fusionner la chaîne de certificats directement dans le fichier
SSLCertificateFile. Dans ce cas,SSLCertificateChainFilepeut être omis, et le champca_pathdu point d’installation clmBot doit être laissé vide en conséquence. - Sélectionnez le nom du service selon la distribution :
httpdpour RHEL/CentOS etapache2pour Debian/Ubuntu.
Configuration du point d’installation 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
Configuration du certificat côté serveur
Tomcat 8.5 et versions ultérieures montent le keystore JKS via SSLHostConfig dans 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>
Configuration du point d’installation 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 géré par systemd, after_script peut être simplifié en systemctl restart <tomcat 服务名>.
Tomcat + PEM
Configuration du certificat côté serveur
Tomcat 8.5 et versions ultérieures prennent en charge l'utilisation directe de fichiers PEM, sans conversion 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>
Configuration du point d’installation 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
Service personnalisé + PFX
Adapté aux services qui utilisent le certificat sous forme de paquet de certificats à fichier unique (PKCS#12), les variables de modèle de script peuvent être utilisées dans after_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
Vérification
Une fois la configuration terminée, vous pouvez déclencher manuellement une mise à jour pour vérifier l’ensemble du processus :
./clm-bot-linux-amd64 update-certificate
Après avoir confirmé que le fichier du certificat a été mis à jour, que le service a été rechargé et que le nouveau certificat est effectif, configurez la mise à jour automatique selon la méthode de mise à jour du certificat.