Aller au contenu principal

Démarrage rapide

Cette page vous guide pour déployer clmBot en 15 minutes et exécuter un flux complet de renouvellement de certificat.

Avant de commencer, veuillez confirmer :

  • Le service sslTrus CaaS est activé et vous pouvez vous connecter au panneau d’administration.
  • Le serveur cible peut accéder en sortie aux services cloud.
  • Vous disposez des privilèges d’administrateur sur le serveur (pour l’installation et l’initialisation de clmBot).

Étape 1 : Générer AccessKey / AccessSecret​

Connectez-vous au panneau d’administration, accédez à sslTrus CaaS Service -> Détails du produit -> Détails du certificat SSL, puis cliquez sur 生成AK/SK pour obtenir AccessKey (AK) et AccessSecret (SK).

Attention

Veuillez conserver AccessKey et AccessSecret en lieu sûr. Ne soumettez pas AccessSecret à un dépôt Git, ne l’écrivez pas dans des scripts publics ni ne l’envoyez à des systèmes tiers non fiables ; en cas de suspicion de fuite, régénérez-le dans le panneau d’administration.

Étape 2 : Télécharger clmBot et le téléverser sur le serveur​

Téléchargez la version correspondante du programme selon le système depuis la page de publication de clmBot :

Télécharger clmBot

Sélectionnez la version appropriée en fonction du système d’exploitation et de l’architecture du serveur (par exemple clm-bot-linux-amd64), puis téléversez-la sur le serveur. Il est recommandé de créer un répertoire d’installation dédié, par exemple /opt/clm-bot.

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

Étape 3 : Connexion et intégration​

Dans le répertoire d'installation, exécutez la commande login pour terminer l'intégration :

./clm-bot-linux-amd64 login

Suivez les instructions pour sélectionner d'abord le numéro de l'adresse du service cloud (ou saisir directement cette adresse), puis renseignez AccessKey et AccessSecret dans cet ordre.

Une fois la connexion établie, clmBot crée le fichier de configuration config.yaml dans le répertoire d'installation pour y enregistrer les informations de connexion.

Étape 4 : Activer le nœud dans le panneau d’administration​

Connectez-vous au panneau d’administration, accédez à la liste des nœuds clmBot, et vous verrez qu’un nouveau nœud clmBot a été ajouté. Cliquez sur l’interrupteur 是否允许接入 à droite du nœud pour activer ce nœud.

Info

Les nœuds nouvellement connectés sont désactivés par défaut ; ce n’est qu’après leur activation dans le panneau d’administration que clmBot peut normalement récupérer les certificats depuis le cloud.

Étape 5 : Découvrir les certificats sur le serveur​

Exécutez la commande de découverte des certificats pour scanner automatiquement les certificats déjà déployés sur le serveur ainsi que leurs chemins de stockage :

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

Une fois la commande exécutée, les informations sur les certificats trouvés s’affichent sous forme de tableau (source, type, émetteur, chemin, domaine, etc.). Saisissez le numéro de série du certificat à téléverser pour confirmer l’ajout à l’administration du backend :

  • all : tout téléverser
  • none : ne pas téléverser
  • 1,3-5 : sélectionner selon le numéro de série, avec prise en charge de la notation par plage

Une fois le téléversement terminé, ces certificats apparaissent comme points d’installation dans l’administration du backend. clmBot génère la configuration correspondante pour chaque point d’installation dans le fichier config.yaml du répertoire courant.

Informations

Dans la configuration générée automatiquement, chaque point d’installation comporte les champs before_script et after_script, dont after_script est le script de rechargement exécuté après la mise à jour du certificat. Vérifiez s’il est utilisable selon l’environnement réel. Pour la signification des champs, consultez la référence de configuration.

Étape 6 : effectuer la première mise à jour du certificat​

Après avoir défini la période de renouvellement automatique du certificat dans le panneau d’administration (voir Mode de mise à jour du certificat), vous pouvez déclencher manuellement une mise à jour pour valider l’ensemble du processus :

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

Après exécution, clmBot vérifie si un certificat plus récent est disponible dans le cloud :

  • Le certificat local est déjà à jour : un message est affiché et l'étape est ignorée.
  • Un nouveau certificat existe dans le cloud : une tentative de génération d'une sauvegarde .bak est effectuée, le nouveau certificat est écrit, puis after_script est exécuté selon la configuration. En cas d'échec de la sauvegarde, une erreur est enregistrée mais la mise à jour se poursuit ; le rechargement du service doit être vérifié via les résultats du script et l'état de l'intergiciel.

Étapes suivantes​