Add configuration guides for Crimson Tactics client and RabbitMQ deployment

2026-10-22 09:49:55 +02:00
parent c891a84be4
commit a70364e947
2 changed files with 210 additions and 0 deletions
@@ -0,0 +1,85 @@
+# Configuration d'un nouveau client Crimson Tactics
+
+## Vue d'ensemble
+
+### Côté Crimson Tactics
+
+L'application Crimson Tactics communique avec une passerelle hébergée dans le cloud. Cette passerelle se connecte à un serveur RabbitMQ afin de consommer les messages envoyés par le SGO, qu'il s'agisse de Nexsis ou de Systel.
+
+### Côté Systel
+
+Un serveur RabbitMQ est déployé dans notre datacenter. Il est accessible à l'adresse `saas-crimson.systel-dc.com`, sur le port `5671`.
+
+L'interface d'administration est accessible à l'adresse suivante : <https://saas-crimson.systel-dc.com:8443/rabbitmq/>. La connexion nécessite le compte administrateur.
+
+Un simulateur Crimson Tactics est temporairement mis à la disposition des clients. Il leur permet de tester l'interface Crimson Tactics en attendant son déploiement sur leur propre plateforme. Le simulateur est accessible à l'adresse suivante : <https://saas-crimson.systel-dc.com/>.
+
+StartServer transmet au broker RabbitMQ, sous forme de messages AMQP, les interventions pour lesquelles une SITAC a été créée.
+
+## Configuration de RabbitMQ
+
+Pour chaque client, créer un virtual host et deux utilisateurs associés : un utilisateur Systel et un utilisateur Crimson.
+
+Connectez-vous à l'interface d'administration RabbitMQ avec le compte administrateur : <https://saas-crimson.systel-dc.com:8443/rabbitmq/>.
+
+### Création du virtual host
+
+1. Dans le menu situé à droite de l'écran, sélectionnez **Virtual Hosts**.
+2. Cliquez sur **Add a new virtual host**.
+3. Saisissez un nom et une description (par exemple, `sdis123` et `Virtual host pour SDIS 123`).
+4. Cliquez sur **Add virtual host**.
+
+### Création de l'utilisateur Systel
+
+1. Dans le menu situé à droite de l'écran, sélectionnez **Users**.
+2. Cliquez sur **Add a user**.
+3. Définissez un nom d'utilisateur et un mot de passe (par exemple, `start_sdis123`).
+4. Cliquez sur **Add user**.
+5. Cliquez sur le nom de l'utilisateur nouvellement créé.
+6. Dans la section **Set permission**, sélectionnez le virtual host créé précédemment dans la liste **Virtual Host**.
+7. Cliquez sur **Set permission**.
+8. Enregistrez les identifiants dans le gestionnaire de mots de passe de Systel.
+
+### Création de l'utilisateur Crimson
+
+1. Cliquez sur **Add a user**.
+2. Définissez un nom d'utilisateur et un mot de passe (par exemple, `crimson_sdis123`).
+3. Cliquez sur **Add user**.
+4. Cliquez sur le nom de l'utilisateur nouvellement créé.
+5. Dans la section **Set permission**, sélectionnez le virtual host créé précédemment dans la liste **Virtual Host**.
+6. Cliquez sur **Set permission**.
+7. Enregistrez les identifiants dans le gestionnaire de mots de passe de Systel.
+
+## Configuration de StartServer
+
+Configurez StartServer pour qu'il puisse accéder au serveur RabbitMQ déployé dans notre datacenter.
+
+### Paramètres de connexion à RabbitMQ
+
+La configuration s'effectue dans la table `PARAMETRES_CTA_COMPLEMENTAIRES` avec les paramètres suivants :
+
+| Clé | Description |
+| --- | --- |
+| `crimson.amqp.host` | Adresse du serveur AMQP (par exemple, `saas-crimson.systel-dc.com`). |
+| `crimson.amqp.port` | Port du serveur AMQP (par défaut : `5671` pour AMQPS). |
+| `crimson.amqp.virtual_host` | Virtual host du serveur AMQP (par exemple, `sdis123`). |
+| `crimson.amqp.username` | Nom d'utilisateur du serveur AMQP (par exemple, `start_sdis123`). |
+| `crimson.amqp.password` | Mot de passe du serveur AMQP, chiffré à l'aide de l'utilitaire disponible dans PoluxEye. |
+| `crimson.amqp.queue_name` | Nom de la file AMQP (par défaut : `systel`). |
+
+### Ajout du plugin CrimsonPlugin
+
+Ajoutez le plugin `CrimsonPlugin` au fichier `plugin.properties` de StartServer avec la ligne suivante :
+
+```properties
+############## (A64) CRIMSON TACTICS ###############
+crimson.plugin=com.systel.polux.plugin.business.crimson.CrimsonPlugin
+```
+
+## Ouverture du flux AMQP
+
+Ouvrez le flux réseau nécessaire à la connexion entre StartServer et RabbitMQ :
+
+| Source | Destination | Protocole | Port | Description |
+| --- | --- | --- | --- | --- |
+| Serveur StartServer | `saas-crimson.systel-dc.com` | TCP | `5671` | Connexion AMQP pour Crimson Tactics |