Überblick über die Integrationen
exoCortex verbindet sich mit den Systemen, die Sie bereits nutzen: Ein ERP-System eröffnet Tickets über die API, Monitoring- und Sicherheitsalarme werden zu Tickets, Ihr Identity Provider legt die Benutzer an, Ihre Website bindet das Support-Formular ein.
Welche Integration Sie brauchen
Abschnitt betitelt „Welche Integration Sie brauchen“| Sie möchten… | Verwenden Sie | Anleitung |
|---|---|---|
| Tickets aus einem Ihrer Systeme eröffnen und verfolgen | REST API v1 mit einem API-Schlüssel | API-Schlüssel |
| Ein Ereignis erhalten, wenn sich ein Ticket ändert | Ausgehende Webhooks | Ausgehende Webhooks |
| Monitoring-, DevOps- oder Sicherheitsalarme in Tickets umwandeln | Eingehende Webhooks und Konnektoren | Eingehende Webhooks |
| Tickets mit einem anderen ITSM synchronisieren | Integrationen des Integration Center | Eingehende Webhooks |
| Ein Support-Formular auf Ihrer Website einbinden | Widget | Widget |
| Benutzer aus Ihrem Identity Provider anlegen und deaktivieren | SCIM 2.0 | SCIM-Provisioning |
| Daten aus einem bestehenden System importieren | Import Hub | Integration Hub und Import |
Codebeispiele und die Referenz zu jedem Endpunkt finden Sie im Abschnitt Entwickler.
Adresse der API
Abschnitt betitelt „Adresse der API“Alle Aufrufe gehen an https://exocortex-api.ai-exo-cortex.com. Jede Integration arbeitet mit genau einem Tenant: dem des Schlüssels, Tokens oder Konnektors, den Sie verwenden.
Sicherheit
Abschnitt betitelt „Sicherheit“- Jede Zugangsberechtigung ist an einen Tenant gebunden und sieht keine Daten anderer Tenants.
- API-Schlüssel, Webhook-Secrets und SCIM-Tokens werden nur einmal angezeigt, wenn Sie sie erstellen: Bewahren Sie sie in einem Secret Manager auf.
- Die Ereignisse, die exoCortex Ihnen sendet, sind signiert, und das gilt auch für die Ereignisse, die Sie senden: Die Signatur enthält einen Zeitstempel und schützt auch vor wiederholten Anfragen.
- Die Verwaltungsfunktionen (API-Schlüssel, Webhooks, SCIM-Tokens) erfordern einen Administrator in exoCortex Core: Mit einem API-Schlüssel lassen sich keine anderen Schlüssel verwalten.
Stabilität
Abschnitt betitelt „Stabilität“Die aktuelle Version der Integrations-API ist 1.1.0. Innerhalb von /api/v1 nehmen wir nur kompatible Änderungen vor: Ihr Client muss unbekannte Felder, Ereignisse und Fehlercodes ignorieren. Eine als veraltet markierte Funktion bleibt ab der Ankündigung mindestens sechs Monate aktiv. Die heute veralteten Funktionen funktionieren ab dem 30. Juni 2027 nicht mehr:
| Veraltete Funktion | Stattdessen verwenden |
|---|---|
API-Schlüssel nh_… |
Schlüssel nhk.<keyid>.<secret> |
Signatur X-NH-Signature bei ausgehenden Webhooks |
X-Exo-Signature mit X-Exo-Timestamp |
Signatur X-NH-Connector-Signature bei eingehenden Webhooks |
X-Exo-Signature mit X-Exo-Timestamp |
Felder event, timestamp, source im Webhook-Body |
type, created_at, data |