Aller au contenu principal

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 :

CommandeUtilisation
discover-certificateAnalyser automatiquement les certificats présents sur la machine locale (et dans les conteneurs Docker) et les ajouter comme points d’installation
add-serverAjouter manuellement un point d’installation en mode interactif (écriture uniquement dans la configuration locale)
sync-serverSynchroniser les points d’installation locaux vers le cloud et calibrer les numéros d’abonnement de certificats
setupDémarrer la page de configuration Web locale pour gérer les points d’installation dans le navigateur
query-certificateConsulter 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 importer
  • none : ne pas importer
  • 1,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ètreDescription
--yes / -yIgnorer la sélection et importer tous les points d’installation
--selectSpécifiez directement le numéro de séquence à téléverser(all、none ou 1,3-5),mutuellement exclusif avec --yes
--skip-filter / -sIgnorer 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 / -dAnalyse supplémentaire des configurations nginx, Apache, Tomcat dans les conteneurs Docker (Linux/macOS uniquement)
--scan-onlyAnalyse 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.

Information
  • 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.

Attention

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.