Migrer un integrateur
Deplacez un integrateur vers un nouvel hote ou pointez-le 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
L’integrateur se migre exactement comme une sonde monitor. La commande migrate arrete l’integrateur, 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.
Les seules differences avec la sonde monitor sont le nom de l’executable (integrator) et le fichier de certificat (config/ssl/certificates/integrator.pem). Les etapes sont identiques.
Prerequis
- Le serveur web doit etre demarre, en fonctionnement et joignable depuis l’hote de l’integrateur (l’integrateur 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 l’integrateur (la ou se trouvent
integrator.exe/integratoret son fichier de configuration), 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. L’integrateur arrete le service en cours, supprime l’ancien config/ssl/certificates/integrator.pem, genere un nouveau certificat auto-signe et sa cle privee correspondante, puis partage le nouveau certificat avec le serveur web.
# Windows
integrator.exe migrate <ip_serveur_web>:<port_api_serveur_web> <jeton_api_serveur_web>
# Linux
./integrator 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/integrator.pem depuis le repertoire d’installation de l’integrateur.
2. Demarrez le composant integrateur
La commande migrate laisse le service arrete. Redemarrez-le.
# Windows
integrator.exe start
# Linux
./integrator 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 l’integrateur.
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 l’integrateur 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 l’integrateur migre fonctionne correctement.