Moyens d’intégration prévus

L’intégration Qisutu configurée dans l’interface utilise l’interface d’événements de l’extension Qisutu séparée. La connexion est configurée sous Notifications avec son adresse d’événements et sa clé. Les événements sont transmis en JSON sur HTTPS ; la clé d’accès est utilisée comme jeton Bearer. Le test de connexion appelle l’adresse de test de la connexion choisie et ne crée aucun ticket.

Les collecteurs de mesures distribués disposent de leur propre interface HTTPS vers le serveur central. Ils sont créés sous Paramètres → Collecteurs distribués, puis affectés à l’appareil sous Configurer → Collecteur. Utilisez pour cela la configuration des collecteurs ; un mot de passe d’agent ne remplace pas leur clé d’accès.

Interface	Objectif	Authentification
GET /api/health sur le serveur de surveillance	Test simple de joignabilité du service web ; la réponse contient service: netzmonitor. Il ne renseigne pas sur chaque appareil surveillé.	Aucune connexion requise.
GET /collector/v1/config/{ID}	Récupérer la configuration de contrôle affectée au collecteur.	Clé Bearer de ce collecteur actif ; HTTPS requis.
POST /collector/v1/results/{ID}	Transmettre les résultats de mesure du collecteur.	Clé Bearer de ce collecteur actif ; HTTPS requis.
Adresse d’événements Qisutu de l’extension	Envoyer les incidents et les rétablissements de la surveillance à Qisutu.	Clé Bearer de la connexion Qisutu.

Les autres routes /api/ servent l’interface de surveillance authentifiée. Elles utilisent une session ; les modifications nécessitent en plus le jeton CSRF correspondant. Elles ne sont pas autorisées par la clé de connexion Qisutu. Dans cette version, l’interface de surveillance ne propose ni adresse webhook générale configurable pour d’autres systèmes de tickets, ni écran permettant de recevoir des événements de surveillance externes arbitraires.