Gestion des points d'installation
Un point d’installation est une destination de déploiement de certificat dans le fichier de configuration de clmBot. Il se compose d’un format de certificat (format), d’un chemin de fichier et d’un script de mise à jour. Un nœud clmBot peut gérer plusieurs points d’installation.
clmBot fournit les commandes suivantes de gestion des points d’installation :
| Commande | Utilisation |
|---|---|
discover-certificate | Analyser automatiquement les certificats présents sur la machine locale (et dans les conteneurs Docker) et les ajouter comme points d’installation |
add-server | Ajouter manuellement un point d’installation en mode interactif (écriture uniquement dans la configuration locale) |
sync-server | Synchroniser les points d’installation locaux vers le cloud et calibrer les numéros d’abonnement de certificats |
setup | Démarrer la page de configuration Web locale pour gérer les points d’installation dans le navigateur |
query-certificate | Consulter en lecture seule les informations des certificats actuellement déployés sur chaque point d’installation |
Découverte automatique des points d’installation de certificats
Exécutez discover-certificate pour analyser automatiquement les certificats déjà déployés sur le serveur :
./clm-bot-linux-amd64 discover-certificate
Périmètre d’analyse :
- Linux : nginx, Apache HTTP Server, Tomcat.
- Windows : IIS.
Une fois la commande exécutée, les informations des certificats trouvés sont répertoriées sous forme de tableau (source, type, autorité de certification, sujet, chemin, point d’accès, numéro de série, etc.). Saisissez le numéro du certificat à importer pour confirmer l’ajout à la console d’administration :
all: tout importernone: ne pas importer1,3-5: sélectionner par numéro, avec prise en charge des plages
Une fois l’importation réussie, ces certificats apparaissent dans la console d’administration en tant que points d’installation, et clmBot génère la configuration correspondante pour chaque point d’installation dans config.yaml.
Paramètres disponibles
| Paramètre | Description |
|---|---|
--yes / -y | Ignorer la sélection et importer tous les points d’installation |
--select | Spécifiez directement le numéro de séquence à téléverser(all、none ou 1,3-5),mutuellement exclusif avec --yes |
--skip-filter / -s | Ignorer le filtrage par domaine du certificat (SAN). Par défaut, seuls les certificats correspondant aux domaines autorisés dans le cloud sont téléversés |
--scan-docker / -d | Analyse supplémentaire des configurations nginx, Apache, Tomcat dans les conteneurs Docker (Linux/macOS uniquement) |
--scan-only | Analyse et affichage uniquement de tous les points d’installation de certificats, sans connexion ni téléversement, adapté à un aperçu avant déploiement |
Scénario avec conteneurs Docker
Lors de l’utilisation de --scan-docker, clmBot analyse les conteneurs nginx, Apache et Tomcat en cours d’exécution sur la machine locale :
- Le chemin du certificat dans le conteneur doit être monté sur la machine hôte et être accessible en écriture, sinon ce point d’installation sera ignoré.
- Le point d’accès du point d’installation sera généré à partir de l’IP et du port publiés par la machine hôte.
- Vous pouvez spécifier les noms des conteneurs à analyser via les variables d’environnement
CLMBOT_NGINX_CONTAINERS,CLMBOT_APACHE_CONTAINERS,CLMBOT_TOMCAT_CONTAINERS(plusieurs noms de conteneurs séparés par des points-virgules).
Ajout manuel d’un point d’installation
Lorsque le certificat cloud n’est pas déployé sur le serveur ou que l’analyse automatique ne parvient pas à l’identifier, vous pouvez ajouter manuellement un point d’installation :
./clm-bot-linux-amd64 add-server 260101AABBCC pem
Le premier paramètre est l’ID d’abonnement au certificat, le deuxième paramètre est le format du certificat (pem, pfx, jks, iis ou exchange). Suivez les invites pour saisir successivement l’ID du point d’installation, le chemin du fichier au format correspondant et d’autres informations.
add-server écrit uniquement le point d’installation dans le fichier local config.yaml, sans le téléverser automatiquement vers le cloud. Pour le synchroniser avec le cloud, exécutez ensuite sync-server.
Synchroniser les points d’installation vers le cloud
sync-server Téléversez les points d’installation de la configuration locale vers le cloud, puis utilisez le numéro d’abonnement renvoyé par le cloud pour compléter ou calibrer la configuration locale :
./clm-bot-linux-amd64 sync-server
Après l’exécution, les points d’installation locaux sont listés. Sélectionnez par numéro l’élément à téléverser (les options all, none, 1,3-5 sont également prises en charge). Vous pouvez aussi utiliser --yes pour tout téléverser ou --select pour spécifier directement.
- Si le numéro d’abonnement local est vide, il est automatiquement renseigné ; en cas de divergence avec le cloud, les conflits sont listés et la confirmation est requise avant l’écrasement.
- Les points d’installation au format Exchange ne sont pas encore pris en charge pour la synchronisation.
Page de configuration Web locale
Si vous n’êtes pas à l’aise avec la ligne de commande, vous pouvez utiliser setup pour lancer la page de configuration locale et ajouter, modifier ou supprimer des points d’installation dans le navigateur :
./clm-bot-linux-amd64 setup
Après exécution, une adresse d’accès avec un jeton aléatoire sera générée (par exemple http://localhost:<端口>/setup?token=...). Ouvrez-la dans le navigateur de la machine serveur pour gérer le point d’installation.
La page de configuration écoute uniquement sur l’adresse de bouclage local de la machine serveur et n’est pas accessible depuis d’autres hôtes. Ne divulguez pas l’adresse d’accès contenant le jeton à des personnes non concernées ; une fois l’opération terminée, appuyez sur Ctrl+C (ou suivez les instructions affichées) pour arrêter la page.
Pour spécifier un port, utilisez le paramètre -a (par exemple setup -a localhost:8900) ; dans un ancien navigateur, ajoutez --legacy pour utiliser la page de configuration en HTML pur.
Consulter les informations des certificats du point d’installation
query-certificate permet de consulter en lecture seule les informations des certificats actuellement déployés sur chaque point d’installation (sujet, émetteur, numéro de série), sans modifier les fichiers de certificat :
./clm-bot-linux-amd64 query-certificate
Par défaut, tous les points d’installation sont interrogés. Vous pouvez utiliser le paramètre -i pour spécifier l’ID du point d’installation, par exemple query-certificate -i nginx_pem.
Étape suivante
Une fois le point d’installation prêt, veuillez configurer la méthode de renouvellement du certificat. Consultez Méthode de renouvellement du certificat.