Przegląd integracji

exoCortex łączy się z systemami, których już Państwo używają: system zarządczy otwiera zgłoszenia przez API, alarmy z monitorowania i systemów bezpieczeństwa stają się zgłoszeniami, dostawca tożsamości tworzy użytkowników, a Państwa witryna udostępnia formularz pomocy.

Jakiej integracji potrzebują Państwo

Cel	Rozwiązanie	Przewodnik
Otwieranie i śledzenie zgłoszeń z własnego systemu	REST API v1 z kluczem API	Klucze API
Otrzymywanie zdarzenia, gdy zgłoszenie się zmienia	Webhooki wychodzące	Webhooki wychodzące
Zamiana alarmów z monitorowania, DevOps lub bezpieczeństwa w zgłoszenia	Webhooki przychodzące i konektory	Webhooki przychodzące
Synchronizacja zgłoszeń z innym systemem ITSM	Integracje w Integration Center	Webhooki przychodzące
Umieszczenie formularza pomocy na własnej witrynie	Widget	Widget
Tworzenie i dezaktywowanie użytkowników z dostawcy tożsamości	SCIM 2.0	Provisioning SCIM
Import danych z istniejącego systemu	Import Hub	Integration Hub i import

Przykłady kodu i dokumentację referencyjną każdego endpointu można znaleźć w sekcji Programiści.

Adres API

Wszystkie wywołania są kierowane na adres https://exocortex-api.ai-exo-cortex.com. Każda integracja działa w obrębie jednego tenanta: tego, do którego należy używany klucz, token lub konektor.

Bezpieczeństwo

• Każde poświadczenie jest powiązane z jednym tenantem i nie ma dostępu do danych innych tenantów.
• Klucze API, sekrety webhooków i tokeny SCIM są wyświetlane tylko raz, w chwili ich utworzenia: należy przechowywać je w menedżerze sekretów.
• Zdarzenia wysyłane przez exoCortex są podpisane i tak samo muszą być podpisane zdarzenia wysyłane przez Państwa: podpis zawiera znacznik czasu i chroni również przed powtórzonymi żądaniami.
• Funkcje zarządzania (klucze API, webhooki, tokeny SCIM) wymagają administratora w exoCortex Core: za pomocą klucza API nie można zarządzać innymi kluczami.

Stabilność

Aktualna wersja API integracyjnego to 1.1.0. W ramach /api/v1 wprowadzamy wyłącznie zmiany zgodne wstecz: Państwa klient musi ignorować nieznane pola, zdarzenia i kody błędów. Wycofywana funkcja pozostaje aktywna przez co najmniej sześć miesięcy od ogłoszenia. Funkcje obecnie wycofywane przestaną działać 30 czerwca 2027:

Wycofywana funkcja	Czego użyć zamiast niej
Klucze API nh_…	Klucze nhk.<keyid>.<secret>
Podpis X-NH-Signature w webhookach wychodzących	X-Exo-Signature z X-Exo-Timestamp
Podpis X-NH-Connector-Signature w webhookach przychodzących	X-Exo-Signature z X-Exo-Timestamp
Pola event, timestamp, source w treści webhooków	type, created_at, data