Przewidziane sposoby integracji

Integracja Qisutu skonfigurowana w interfejsie korzysta z interfejsu zdarzeń osobnego dodatku Qisutu. Połączenie jest konfigurowane w sekcji Powiadomienia za pomocą adresu zdarzeń i klucza. Zdarzenia są przesyłane jako JSON przez HTTPS; klucz dostępu służy jako token Bearer. Test połączenia wywołuje adres testowy wybranego połączenia i nie tworzy zgłoszenia.

Rozproszone kolektory mają własny interfejs HTTPS do centrali. Są tworzone w sekcji Ustawienia → Rozproszone kolektory, a następnie przypisywane do urządzenia w sekcji Skonfiguruj → Kolektor. Użyj w tym celu konfiguracji kolektorów; hasło agenta nie zastępuje ich klucza dostępu.

Interfejs

Cel

Uwierzytelnianie

GET /api/health na serwerze monitorowania

Prosty test osiągalności usługi WWW; odpowiedź zawiera service: netzmonitor. Nie jest to informacja o każdym monitorowanym urządzeniu.

Logowanie nie jest wymagane.

GET /collector/v1/config/{ID}

Pobranie przypisanej konfiguracji kontroli dla kolektora.

Klucz Bearer tego aktywnego kolektora; wymagane HTTPS.

POST /collector/v1/results/{ID}

Przesłanie wyników pomiarów kolektora.

Klucz Bearer tego aktywnego kolektora; wymagane HTTPS.

Adres zdarzeń Qisutu z dodatku

Wysyłanie awarii i powiadomień o przywróceniu działania z monitorowania do Qisutu.

Klucz Bearer połączenia Qisutu.

Pozostałe trasy /api/ obsługują zalogowany interfejs monitorowania. Używają sesji; zmiany wymagają dodatkowo powiązanego tokenu CSRF. Klucz połączenia Qisutu nie daje do nich dostępu. W tej wersji w interfejsie monitorowania nie ma konfigurowalnego ogólnego adresu webhook dla innych systemów zgłoszeń ani formularza przyjmowania dowolnych zewnętrznych zdarzeń monitorowania.