Migration
Deplacez une sonde monitor vers un nouvel hote ou pointez-la vers un nouveau serveur web en generant un nouveau certificat auto-signe et en l’enregistrant a nouveau aupres du serveur web.
Vue d’ensemble
Migrer une sonde monitor consiste a retablir la confiance entre la sonde et le serveur web. La commande migrate arrete la sonde, supprime son ancien certificat, genere un nouveau certificat auto-signe + une cle privee, et transmet le nouveau certificat au serveur web — authentifie a l’aide d’un jeton API du serveur web. Une fois que le serveur web recharge son magasin de certificats, la communication mTLS est retablie.
Prenons notre infrastructure de test. Dans cette partie, nous nous concentrons sur ce qui se passe dans le rectangle rouge.
Prerequis
- Le serveur web doit etre demarre, en fonctionnement et joignable depuis l’hote de la sonde (la sonde teste d’abord
https://<serveur_web>/ping). - Vous avez besoin d’un jeton API du serveur web (JWT) valide. Generez-en un depuis le serveur web (
POST /api/auth) ou depuis l’interface du serveur web. - Executez la commande depuis le repertoire d’installation de la sonde (la ou se trouvent
monitor.exe/monitoretmonitor.json), avec des privileges eleves (le service est arrete/demarre).
Etapes de migration
1. Executez la commande de migration
Executez l’option de migration avec le point de terminaison API du serveur web et son jeton. La sonde arrete le service en cours, supprime l’ancien config/ssl/certificates/monitor.pem, genere un nouveau certificat auto-signe et sa cle privee correspondante, puis partage le nouveau certificat avec le serveur web.
# Windows
monitor.exe migrate <ip_serveur_web>:<port_api_serveur_web> <jeton_api_serveur_web>
# Linux
./monitor migrate <ip_serveur_web>:<port_api_serveur_web> <jeton_api_serveur_web>
En cas de succes, vous obtenez :
=> SUCCESS: To enable communication between this component and the webserver, you need to update that component IP/port number and reload the webserver's certificates store.
config/ssl/certificates/monitor.pem depuis le repertoire d’installation de la sonde.
2. Demarrez le composant monitor
La commande migrate laisse le service arrete. Redemarrez-le.
# Windows
monitor.exe start
# Linux
./monitor start
3. Rechargez le magasin de certificats du serveur web
Rechargez le dossier de certificats du serveur web afin que le nouveau certificat soit ajoute au magasin de certificats du serveur web. Tant que ceci n’est pas fait, le serveur web ne fera pas confiance au nouveau certificat de la sonde.
4. Mettez a jour l’IP et le port de la sonde
Sur le serveur web, mettez a jour (optionnellement) l’adresse IP et le numero de port de la sonde afin que le serveur web l’atteigne a son nouvel emplacement, puis enregistrez.
5. Verifiez la communication
Verifiez que la communication entre le serveur web et la sonde migree fonctionne correctement.
Voir aussi
- Migrer un integrateur — meme processus, certificat
integrator.pem. - Migrer le serveur web (changement d’IP) — processus different : le serveur web regenere son propre certificat et chaque composant doit etre repointe vers la nouvelle adresse.