Modalità di integrazione previste

L’integrazione Qisutu configurata nell’interfaccia utilizza l’interfaccia degli eventi dell’add-on Qisutu separato. La connessione viene configurata in Notifiche con il suo indirizzo degli eventi e la chiave. Gli eventi vengono trasmessi come JSON tramite HTTPS; la chiave di accesso viene utilizzata come token Bearer. Il test di connessione richiama l’indirizzo di test della connessione scelta e non crea ticket.

I collettori distribuiti hanno una propria interfaccia HTTPS verso il server centrale. Vengono creati in Impostazioni → Collettori distribuiti, quindi assegnati al dispositivo in Configura → Collettore. Utilizzare la configurazione dei collettori; una password di agente non sostituisce la loro chiave di accesso.

Interfaccia	Scopo	Autenticazione
GET /api/health sul server di monitoraggio	Semplice test di raggiungibilità del servizio web; la risposta contiene service: netzmonitor. Non indica lo stato di ciascun dispositivo monitorato.	Nessun accesso richiesto.
GET /collector/v1/config/{ID}	Recuperare la configurazione dei controlli assegnata al collettore.	Chiave Bearer di questo collettore attivo; HTTPS richiesto.
POST /collector/v1/results/{ID}	Trasmettere i risultati delle misure del collettore.	Chiave Bearer di questo collettore attivo; HTTPS richiesto.
Indirizzo degli eventi Qisutu dell’add-on	Inviare guasti e ripristini dal monitoraggio a Qisutu.	Chiave Bearer della connessione Qisutu.

Le altre route /api/ servono l’interfaccia di monitoraggio autenticata. Utilizzano una sessione; le modifiche richiedono inoltre il token CSRF corrispondente. Non sono autorizzate mediante la chiave di connessione Qisutu. In questa versione, l’interfaccia di monitoraggio non offre un indirizzo webhook generale configurabile per altri sistemi di ticket né una maschera per accettare eventi di monitoraggio esterni arbitrari.